diff --git a/README.md b/README.md index a7c4df5..cd67720 100644 --- a/README.md +++ b/README.md @@ -1,91 +1,97 @@ + +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/shanraisshan/claude-code-best-practice) · [上游 README](https://github.com/shanraisshan/claude-code-best-practice/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 + # claude-code-best-practice -from vibe coding to agentic engineering - practice makes claude perfect +从 vibe coding 到 agentic engineering —— 熟能生巧，Claude 亦如是 -![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-Jul%2013%2C%202026%209%3A45%20AM%20PKT-white?style=flat&labelColor=555) GitHub Stars
+![使用 Claude Code 更新](https://img.shields.io/badge/updated_with_Claude_Code-Jul%2013%2C%202026%209%3A45%20AM%20PKT-white?style=flat&labelColor=555) GitHub Stars
-[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![Click on these badges below to see the actual sources](!/tags/click-badges.svg)
+[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![点击下方这些徽章可查看实际来源](!/tags/click-badges.svg)
= Agents · = Commands · = Skills

- Claude Code mascot jumping
- GitHub Trending #1 Repository Of The Day + Claude Code 吉祥物跳跃
+ GitHub 当日热门榜首仓库

- Supported by:  Disrupt.com — Ventures Reimagined  ClaudeKit — Production-ready skills and workflows + 支持方：  Disrupt.com — Ventures Reimagined  ClaudeKit — 生产就绪的技能与工作流

- Boris Cherny on Claude Code
- Boris Cherny on X (tweet 1 · tweet 2 · tweet 3) + Boris Cherny 谈 Claude Code
+ Boris Cherny 在 X 上（推文 1 · 推文 2 · 推文 3）

> [!TIP] -> Visit the [**How to Use**](#how-to-use) section to take full advantage of this repo. +> 访问 [**如何使用**](#how-to-use) 章节，以充分利用本仓库。 -## 🧠 CONCEPTS +## 🧠 概念 -| Feature | Location | Description | +| 功能 | 位置 | 说明 | |---------|----------|-------------| | [**Subagents**](https://code.claude.com/docs/en/sub-agents) | `.claude/agents/.md` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-subagents.md) [![Implemented](!/tags/implemented.svg)](implementation/claude-subagents-implementation.md) | | [**Commands**](https://code.claude.com/docs/en/slash-commands) | `.claude/commands/.md` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-commands.md) [![Implemented](!/tags/implemented.svg)](implementation/claude-commands-implementation.md) | -| [**Skills**](https://code.claude.com/docs/en/skills) | `.claude/skills//SKILL.md` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-skills.md) [![Implemented](!/tags/implemented.svg)](implementation/claude-skills-implementation.md) [Official Skills](https://github.com/anthropics/skills/tree/main/skills) · [Skills for Mono-repos](reports/claude-skills-for-larger-mono-repos.md) | +| [**Skills**](https://code.claude.com/docs/en/skills) | `.claude/skills//SKILL.md` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-skills.md) [![Implemented](!/tags/implemented.svg)](implementation/claude-skills-implementation.md) [Official Skills](https://github.com/anthropics/skills/tree/main/skills) · [面向 Mono-repo 的技能](reports/claude-skills-for-larger-mono-repos.md) | | [**Workflows**](https://code.claude.com/docs/en/common-workflows) | [`.claude/commands/weather-orchestrator.md`](.claude/commands/weather-orchestrator.md) | [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) | -| [**Hooks**](https://code.claude.com/docs/en/hooks) | `.claude/hooks/` | [![Best Practice](!/tags/best-practice.svg)](https://github.com/shanraisshan/claude-code-hooks) [![Implemented](!/tags/implemented.svg)](https://github.com/shanraisshan/claude-code-hooks) [Guide](https://code.claude.com/docs/en/hooks-guide) | +| [**Hooks**](https://code.claude.com/docs/en/hooks) | `.claude/hooks/` | [![Best Practice](!/tags/best-practice.svg)](https://github.com/shanraisshan/claude-code-hooks) [![Implemented](!/tags/implemented.svg)](https://github.com/shanraisshan/claude-code-hooks) [指南](https://code.claude.com/docs/en/hooks-guide) | | [**MCP Servers**](https://code.claude.com/docs/en/mcp) | `.claude/settings.json`, `.mcp.json` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-mcp.md) [![Implemented](!/tags/implemented.svg)](.mcp.json) | -| [**Plugins**](https://code.claude.com/docs/en/plugins) | distributable packages | [Marketplaces](https://code.claude.com/docs/en/discover-plugins) · [Create Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) | -| [**Settings**](https://code.claude.com/docs/en/settings) | `.claude/settings.json` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-settings.md) [![Implemented](!/tags/implemented.svg)](.claude/settings.json) [Permissions](https://code.claude.com/docs/en/permissions) · [Model Config](https://code.claude.com/docs/en/model-config) · [Output Styles](https://code.claude.com/docs/en/output-styles) · [Sandboxing](https://code.claude.com/docs/en/sandboxing) · [Keybindings](https://code.claude.com/docs/en/keybindings) · [Auto Mode Config](https://code.claude.com/docs/en/auto-mode-config) | +| [**Plugins**](https://code.claude.com/docs/en/plugins) | 可分发的软件包 | [市场](https://code.claude.com/docs/en/discover-plugins) · [创建市场](https://code.claude.com/docs/en/plugin-marketplaces) | +| [**Settings**](https://code.claude.com/docs/en/settings) | `.claude/settings.json` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-settings.md) [![Implemented](!/tags/implemented.svg)](.claude/settings.json) [权限](https://code.claude.com/docs/en/permissions) · [模型配置](https://code.claude.com/docs/en/model-config) · [输出样式](https://code.claude.com/docs/en/output-styles) · [沙箱](https://code.claude.com/docs/en/sandboxing) · [快捷键](https://code.claude.com/docs/en/keybindings) · [自动模式配置](https://code.claude.com/docs/en/auto-mode-config) | | [**Status Line**](https://code.claude.com/docs/en/statusline) | `.claude/settings.json` | [![Best Practice](!/tags/best-practice.svg)](https://github.com/shanraisshan/claude-code-status-line) [![Implemented](!/tags/implemented.svg)](.claude/settings.json) | -| [**Memory**](https://code.claude.com/docs/en/memory) | `CLAUDE.md`, `.claude/rules/`, `~/.claude/rules/`, `~/.claude/projects//memory/` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-memory.md) [![Implemented](!/tags/implemented.svg)](CLAUDE.md) [Auto Memory](https://code.claude.com/docs/en/memory) · [Auto Memory Deep-dive](reports/claude-agent-memory.md) · [Rules](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) | -| [**Checkpointing**](https://code.claude.com/docs/en/checkpointing) | automatic (file-edit tracking) | | -| [**CLI Startup Flags**](https://code.claude.com/docs/en/cli-reference) | `claude [flags]` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-cli-startup-flags.md) [Interactive Mode](https://code.claude.com/docs/en/interactive-mode) · [Env Vars](https://code.claude.com/docs/en/env-vars) | -| **AI Terms** | | [![Best Practice](!/tags/best-practice.svg)](https://github.com/shanraisshan/claude-code-codex-cursor-gemini/blob/main/reports/ai-terms.md) | -| [**Best Practices**](https://code.claude.com/docs/en/best-practices) | | [Prompt Engineering](https://github.com/anthropics/prompt-eng-interactive-tutorial) · [Extend Claude Code](https://code.claude.com/docs/en/features-overview) | +| [**Memory**](https://code.claude.com/docs/en/memory) | `CLAUDE.md`, `.claude/rules/`, `~/.claude/rules/`, `~/.claude/projects//memory/` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-memory.md) [![Implemented](!/tags/implemented.svg)](CLAUDE.md) [Auto Memory](https://code.claude.com/docs/en/memory) · [自动记忆深度解析](reports/claude-agent-memory.md) · [规则](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) | +| [**Checkpointing**](https://code.claude.com/docs/en/checkpointing) | 自动（文件编辑追踪） | | +| [**CLI Startup Flags**](https://code.claude.com/docs/en/cli-reference) | `claude [flags]` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-cli-startup-flags.md) [交互模式](https://code.claude.com/docs/en/interactive-mode) · [环境变量](https://code.claude.com/docs/en/env-vars) | +| **AI 术语** | | [![Best Practice](!/tags/best-practice.svg)](https://github.com/shanraisshan/claude-code-codex-cursor-gemini/blob/main/reports/ai-terms.md) | +| [**最佳实践**](https://code.claude.com/docs/en/best-practices) | | [提示词工程](https://github.com/anthropics/prompt-eng-interactive-tutorial) · [扩展 Claude Code](https://code.claude.com/docs/en/features-overview) | -### 🔥 Hot +### 🔥 热门 -| Feature | Location | Description | +| 功能 | 位置 | 说明 | |---------|----------|-------------| -| [**Ultrareview**](https://code.claude.com/docs/en/ultrareview) ![beta](!/tags/beta.svg) | `/code-review ultra`, `claude ultrareview [target]` | [Tasks tracking](https://code.claude.com/docs/en/ultrareview#track-a-running-review) | +| [**Ultrareview**](https://code.claude.com/docs/en/ultrareview) ![beta](!/tags/beta.svg) | `/code-review ultra`, `claude ultrareview [target]` | [任务追踪](https://code.claude.com/docs/en/ultrareview#track-a-running-review) | | [**Devcontainers**](https://code.claude.com/docs/en/devcontainer) | `.devcontainer/` | | -| [**Channels**](https://code.claude.com/docs/en/channels) ![beta](!/tags/beta.svg) | `--channels`, plugin-based | [Reference](https://code.claude.com/docs/en/channels-reference) | +| [**Channels**](https://code.claude.com/docs/en/channels) ![beta](!/tags/beta.svg) | `--channels`, 基于插件 | [参考](https://code.claude.com/docs/en/channels-reference) | | [**Ultraplan**](https://code.claude.com/docs/en/ultraplan) ![beta](!/tags/beta.svg) | `/ultraplan` | | | [**No Flicker Mode**](https://code.claude.com/docs/en/fullscreen) ![beta](!/tags/beta.svg) | `/tui fullscreen`, `CLAUDE_CODE_NO_FLICKER=1` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2039421575422980329) | -| [**Auto Mode**](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) ![beta](!/tags/beta.svg) | `--permission-mode auto`, `Shift+Tab` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/claudeai/status/2036503582166393240) [Blog](https://claude.com/blog/auto-mode) | +| [**Auto Mode**](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) ![beta](!/tags/beta.svg) | `--permission-mode auto`, `Shift+Tab` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/claudeai/status/2036503582166393240) [博客](https://claude.com/blog/auto-mode) | | [**Power-ups**](best-practice/claude-power-ups.md) | `/powerup` | [![Best Practice](!/tags/best-practice.svg)](best-practice/claude-power-ups.md) | | [**Fast Mode**](https://code.claude.com/docs/en/fast-mode) ![beta](!/tags/beta.svg) | `/fast`, `"fastMode": true` | | -| [**Advisor**](https://code.claude.com/docs/en/advisor) ![beta](!/tags/beta.svg) | `/advisor`, `advisorModel`, `--advisor` | [Blog](https://claude.com/blog/the-advisor-strategy) | -| [**Computer Use**](https://code.claude.com/docs/en/computer-use) ![beta](!/tags/beta.svg) | `computer-use` MCP server | [Desktop](https://code.claude.com/docs/en/desktop#let-claude-use-your-computer) | -| [**Agent SDK**](https://code.claude.com/docs/en/agent-sdk/overview) | `npm` / `pip` package | [Quickstart](https://code.claude.com/docs/en/agent-sdk/quickstart) · [Examples](https://github.com/anthropics/claude-agent-sdk-demos) | +| [**Advisor**](https://code.claude.com/docs/en/advisor) ![beta](!/tags/beta.svg) | `/advisor`, `advisorModel`, `--advisor` | [博客](https://claude.com/blog/the-advisor-strategy) | +| [**Computer Use**](https://code.claude.com/docs/en/computer-use) ![beta](!/tags/beta.svg) | `computer-use` MCP server | [桌面版](https://code.claude.com/docs/en/desktop#let-claude-use-your-computer) | +| [**Agent SDK**](https://code.claude.com/docs/en/agent-sdk/overview) | `npm` / `pip` package | [快速入门](https://code.claude.com/docs/en/agent-sdk/quickstart) · [示例](https://github.com/anthropics/claude-agent-sdk-demos) | | [**Ralph Wiggum Loop**](https://github.com/anthropics/claude-code/tree/main/plugins/ralph-wiggum) | plugin | [![Best Practice](!/tags/best-practice.svg)](https://github.com/ghuntley/how-to-ralph-wiggum) [![Implemented](!/tags/implemented.svg)](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) | | [**Chrome**](https://code.claude.com/docs/en/chrome) | `--chrome`, extension | [![Best Practice](!/tags/best-practice.svg)](reports/claude-in-chrome-v-chrome-devtools-mcp.md) | | [**Claude Code Web**](https://code.claude.com/docs/en/claude-code-on-the-web) ![beta](!/tags/beta.svg) | `claude.ai/code` | [Routines](https://code.claude.com/docs/en/routines) | | [**Artifacts**](https://code.claude.com/docs/en/artifacts) ![beta](!/tags/beta.svg) | `/share`, `Artifact` tool | | | [**Slack**](https://code.claude.com/docs/en/slack) | `@Claude` in Slack | | -| [**Code Review**](https://code.claude.com/docs/en/code-review) ![beta](!/tags/beta.svg) | GitHub App (managed) | [![Best Practice](!/tags/best-practice.svg)](https://x.com/claudeai/status/2031088171262554195) [Blog](https://claude.com/blog/code-review) [Local /code-review](https://code.claude.com/docs/en/commands) | +| [**Code Review**](https://code.claude.com/docs/en/code-review) ![beta](!/tags/beta.svg) | GitHub App (managed) | [![Best Practice](!/tags/best-practice.svg)](https://x.com/claudeai/status/2031088171262554195) [博客](https://claude.com/blog/code-review) [本地 /code-review](https://code.claude.com/docs/en/commands) | | [**GitHub Actions**](https://code.claude.com/docs/en/github-actions) | `.github/workflows/` | [GitLab CI/CD](https://code.claude.com/docs/en/gitlab-ci-cd) | -| [**Remote Control**](https://code.claude.com/docs/en/remote-control) | `/remote-control`, `/rc` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/noahzweben/status/2032533699116355819) [Headless Mode](https://code.claude.com/docs/en/headless) | +| [**Remote Control**](https://code.claude.com/docs/en/remote-control) | `/remote-control`, `/rc` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/noahzweben/status/2032533699116355819) [无头模式](https://code.claude.com/docs/en/headless) | | [**Deep Links**](https://code.claude.com/docs/en/deep-links) | `claude-cli://open?repo=…&q=…` | | -| [**Dynamic Workflows**](https://code.claude.com/docs/en/workflows) | `/workflows`, `ultracode` keyword, `/effort ultracode`, `.claude/workflows/` | [Deep Research](https://code.claude.com/docs/en/workflows#run-a-bundled-workflow) | -| [**Agent Teams**](https://code.claude.com/docs/en/agent-teams) ![beta](!/tags/beta.svg) | built-in (env var) | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2019472394696683904) [![Implemented](!/tags/implemented.svg)](implementation/claude-agent-teams-implementation.md) | +| [**Dynamic Workflows**](https://code.claude.com/docs/en/workflows) | `/workflows`, `ultracode` keyword, `/effort ultracode`, `.claude/workflows/` | [深度研究](https://code.claude.com/docs/en/workflows#run-a-bundled-workflow) | +| [**Agent Teams**](https://code.claude.com/docs/en/agent-teams) ![beta](!/tags/beta.svg) | 内置（环境变量） | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2019472394696683904) [![Implemented](!/tags/implemented.svg)](implementation/claude-agent-teams-implementation.md) | | [**Agent View**](https://code.claude.com/docs/en/agent-view) ![beta](!/tags/beta.svg) | `claude agents`, `--bg`, `/bg` | | -| [**Scheduled Tasks**](https://code.claude.com/docs/en/scheduled-tasks) | `/loop`, `/schedule`, cron tools | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2030193932404150413) [![Implemented](!/tags/implemented.svg)](implementation/claude-scheduled-tasks-implementation.md) [Desktop scheduled tasks](https://code.claude.com/docs/en/desktop-scheduled-tasks) · [Announcement](https://x.com/noahzweben/status/2036129220959805859) | -| [**Routines**](https://code.claude.com/docs/en/routines) ![beta](!/tags/beta.svg) | `claude.ai/code/routines`, `/schedule` | [Desktop Tasks](https://code.claude.com/docs/en/desktop-scheduled-tasks) | -| [**Tasks**](reports/claude-global-vs-project-settings.md#tasks-system) | `/tasks`, `~/.claude/tasks/` | [![Best Practice](!/tags/best-practice.svg)](reports/claude-global-vs-project-settings.md) [Ultrareview tracking](https://code.claude.com/docs/en/ultrareview#track-a-running-review) | +| [**Scheduled Tasks**](https://code.claude.com/docs/en/scheduled-tasks) | `/loop`, `/schedule`, cron tools | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2030193932404150413) [![Implemented](!/tags/implemented.svg)](implementation/claude-scheduled-tasks-implementation.md) [桌面版定时任务](https://code.claude.com/docs/en/desktop-scheduled-tasks) · [公告](https://x.com/noahzweben/status/2036129220959805859) | +| [**Routines**](https://code.claude.com/docs/en/routines) ![beta](!/tags/beta.svg) | `claude.ai/code/routines`, `/schedule` | [桌面任务](https://code.claude.com/docs/en/desktop-scheduled-tasks) | +| [**Tasks**](reports/claude-global-vs-project-settings.md#tasks-system) | `/tasks`, `~/.claude/tasks/` | [![Best Practice](!/tags/best-practice.svg)](reports/claude-global-vs-project-settings.md) [Ultrareview 追踪](https://code.claude.com/docs/en/ultrareview#track-a-running-review) | | [**Goal**](https://code.claude.com/docs/en/goal) | `/goal `, `/goal clear` | [![Implemented](!/tags/implemented.svg)](implementation/claude-goal-implementation.md) | | [**Voice Dictation**](https://code.claude.com/docs/en/voice-dictation) ![beta](!/tags/beta.svg) | `/voice` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/trq212/status/2028628570692890800) | | [**Bundled Skills**](https://code.claude.com/docs/en/skills#bundled-skills) | `/code-review`, `/batch` | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2027534984534544489) | | [**Git Worktrees**](https://code.claude.com/docs/en/worktrees) | `--worktree`/`-w`, `.worktreeinclude`, `EnterWorktree`/`ExitWorktree`, `isolation: "worktree"`, `WorktreeCreate`/`WorktreeRemove` hooks | [![Best Practice](!/tags/best-practice.svg)](https://x.com/bcherny/status/2025007393290272904) |

- section divider + 章节分隔符

## Orchestration Workflow -See [orchestration-workflow](orchestration-workflow/orchestration-workflow.md) for implementation details of **Command** → **Agent** → **Skill** pattern. +请参阅 [orchestration-workflow](orchestration-workflow/orchestration-workflow.md) 了解 **Command**（命令）→ **Agent**（智能体）→ **Skill**（技能）模式的实现细节。

@@ -104,14 +110,14 @@ claude ```

- section divider + 章节分隔符

-## ⚙️ DEVELOPMENT WORKFLOWS +## ⚙️ 开发工作流 -All major workflows converge on the same architectural pattern: **Research → Plan → Execute → Review → Ship** +所有主要工作流都汇聚于同一架构模式：**调研（Research）→ 规划（Plan）→ 执行（Execute）→ 审查（Review）→ 交付（Ship）** -| Name | ★ | Workflow | | | | +| 名称 | ★ | 工作流 | | | | |------|---|----------|---|---|---| | [Superpowers](https://github.com/obra/superpowers) | 253k | brainstorming → using-git-worktrees → writing-plans → subagent-driven-development → dispatching-parallel-agents → executing-plans → test-driven-development → verification-before-completion → requesting-code-review → finishing-a-development-branch | 0 | 0 | 14 | | [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) | 229k | plan → plan-prd → prp-implement → code-review → build-fix → e2e-testing → prp-pr | 67 | 139 | 278 | @@ -126,289 +132,289 @@ All major workflows converge on the same architectural pattern: **Research → P | [Compound Engineering](https://github.com/EveryInc/compound-engineering-plugin) | 23k | /ce-brainstorm → /ce-plan → /ce-work → /ce-simplify-code → /ce-code-review → /ce-compound | 0 | 1 | 30 | | [HumanLayer](https://github.com/humanlayer/humanlayer) | 11k | /ralph_research → /create_plan → /iterate_plan → /validate_plan → /implement_plan → /describe_pr → /commit | 6 | 27 | 0 | -> *Note: yellow tags are sub-loops — steps that repeat inside a parent step (e.g. per task, per story, or until a verify condition passes).* +> *说明：黄色标签表示子循环——在父步骤内重复的步骤（例如按任务、按用户故事，或直至验证条件通过）。* -### Others +### 其他 - [RPI](development-workflows/rpi/rpi-workflow.md) [![Implemented](!/tags/implemented.svg)](development-workflows/rpi/rpi-workflow.md) - [Ralph Wiggum Loop](https://www.youtube.com/watch?v=eAtvoGlpeRU) [![Implemented](!/tags/implemented.svg)](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) -- [Andrej Karpathy (Founding Member, OpenAI) Workflow](https://x.com/karpathy/status/2015883857489522876) -- [Peter Steinberger (Creator of OpenClaw) Workflow](https://youtu.be/8lF7HmQ_RgY?t=2582) -- Boris Cherny (Creator of Claude Code) Workflow — [13 Tips](tips/claude-boris-13-tips-03-jan-26.md) · [10 Tips](tips/claude-boris-10-tips-01-feb-26.md) · [12 Tips](tips/claude-boris-12-tips-12-feb-26.md) · [2 Tips](tips/claude-boris-2-tips-25-mar-26.md) · [15 Tips](tips/claude-boris-15-tips-30-mar-26.md) · [6 Tips](tips/claude-boris-6-tips-16-apr-26.md) [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) -- Thariq (Anthropic) Workflow — [Skills](tips/claude-thariq-tips-17-mar-26.md) · [Session Management](tips/claude-thariq-tips-16-apr-26.md) [![Thariq](!/tags/thariq.svg)](https://x.com/trq212) +- [Andrej Karpathy（OpenAI 创始成员）工作流](https://x.com/karpathy/status/2015883857489522876) +- [Peter Steinberger（OpenClaw 创造者）工作流](https://youtu.be/8lF7HmQ_RgY?t=2582) +- Boris Cherny（Claude Code 创造者）工作流 — [13 条技巧](tips/claude-boris-13-tips-03-jan-26.md) · [10 条技巧](tips/claude-boris-10-tips-01-feb-26.md) · [12 条技巧](tips/claude-boris-12-tips-12-feb-26.md) · [2 条技巧](tips/claude-boris-2-tips-25-mar-26.md) · [15 条技巧](tips/claude-boris-15-tips-30-mar-26.md) · [6 条技巧](tips/claude-boris-6-tips-16-apr-26.md) [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) +- Thariq（Anthropic）工作流 — [Skills](tips/claude-thariq-tips-17-mar-26.md) · [Session Management](tips/claude-thariq-tips-16-apr-26.md) [![Thariq](!/tags/thariq.svg)](https://x.com/trq212)

- section divider + 章节分隔符

-## 🔀 CROSS-MODEL WORKFLOWS +## 🔀 跨模型工作流（CROSS-MODEL WORKFLOWS） -Use Claude Code together with other models — Codex, Gemini, GPT, Kimi, DeepSeek, local — via three mechanisms: +通过三种机制，将 Claude Code 与其他模型——Codex、Gemini、GPT、Kimi、DeepSeek、本地模型——配合使用： -- **Plugin** — another model's CLI runs inside Claude Code (slash commands like `/codex:review`) -- **MCP** — Claude Code calls another model as a tool through Model Context Protocol -- **Router** — Claude Code's API endpoint is swapped to a different provider +- **Plugin（插件）** — 其他模型的 CLI 在 Claude Code 内运行（斜杠命令如 `/codex:review`） +- **MCP** — Claude Code 通过 Model Context Protocol 将另一模型作为工具调用 +- **Router（路由器）** — 将 Claude Code 的 API 端点切换至其他提供商 -Methodology: [Cross-Model (Claude Code + Codex) Workflow](development-workflows/cross-model-workflow/cross-model-workflow.md) [![Implemented](!/tags/implemented.svg)](development-workflows/cross-model-workflow/cross-model-workflow.md) — manual two-terminal flow with Plan in Claude, QA-Review in Codex. +方法论：[跨模型（Claude Code + Codex）工作流](development-workflows/cross-model-workflow/cross-model-workflow.md) [![Implemented](!/tags/implemented.svg)](development-workflows/cross-model-workflow/cross-model-workflow.md) — 手动双终端流程：在 Claude 中规划（Plan），在 Codex 中进行 QA 审查（QA-Review）。 -| Name | ★ | Type | Bridges to | What it does | +| 名称 | ★ | 类型 | 桥接至 | 功能说明 | |------|---|------|------------|--------------| -| [musistudio/claude-code-router](https://github.com/musistudio/claude-code-router) | 34k | Router | OpenRouter, DeepSeek, Ollama, Gemini, Kimi, Qwen, Groq, +more | Routes Claude Code's API to any compatible provider, with per-task model selection | -| [router-for-me/CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) | 32k | Router | Gemini CLI, Codex, Claude Code, Antigravity | Wraps each CLI as an OpenAI/Gemini/Claude/Codex-compatible API service | -| [openai/codex-plugin-cc](https://github.com/openai/codex-plugin-cc) | 18k | Plugin | Codex / GPT-5 | Official OpenAI plugin: `/codex:review`, `/codex:adversarial-review`, `/codex:rescue` inside Claude Code | -| [BeehiveInnovations/pal-mcp-server](https://github.com/BeehiveInnovations/pal-mcp-server) | 12k | MCP | Gemini, OpenAI, Azure, Grok, Ollama, OpenRouter (50+ models) | Multi-model MCP server (formerly `zen-mcp-server`) — call other models as Claude tools | +| [musistudio/claude-code-router](https://github.com/musistudio/claude-code-router) | 34k | Router | OpenRouter, DeepSeek, Ollama, Gemini, Kimi, Qwen, Groq, +more | 将 Claude Code 的 API 路由至任意兼容提供商，支持按任务选择模型 | +| [router-for-me/CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) | 32k | Router | Gemini CLI, Codex, Claude Code, Antigravity | 将各 CLI 封装为兼容 OpenAI/Gemini/Claude/Codex 的 API 服务 | +| [openai/codex-plugin-cc](https://github.com/openai/codex-plugin-cc) | 18k | Plugin | Codex / GPT-5 | OpenAI 官方插件：在 Claude Code 内使用 `/codex:review`、`/codex:adversarial-review`、`/codex:rescue` | +| [BeehiveInnovations/pal-mcp-server](https://github.com/BeehiveInnovations/pal-mcp-server) | 12k | MCP | Gemini, OpenAI, Azure, Grok, Ollama, OpenRouter (50+ models) | 多模型 MCP 服务器（前身为 `zen-mcp-server`）——将其他模型作为 Claude 工具调用 |

- section divider + 章节分隔符

-## 🧰 SKILL COLLECTIONS +## 🧰 技能集合（SKILL COLLECTIONS） -Repos primarily known as curated libraries of `SKILL.md` files (distinct from full workflow methodologies above). Sorted by stars descending. +主要以 `SKILL.md` 文件精选库著称的仓库（有别于上文完整工作流方法论）。按 star 数降序排列。 -| Name | ★ | | +| 名称 | ★ | | |------|---|---| | [mattpocock/skills](https://github.com/mattpocock/skills) | 167k | 35 | | [anthropics/skills](https://github.com/anthropics/skills) | 161k | 17 | | [Egonex-AI/Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) | 67k | 8 | | [wshobson/agents](https://github.com/wshobson/agents) | 38k | 150 | | [scientific-agent-skills](https://github.com/K-Dense-AI/scientific-agent-skills) | 31k | 148 | -| [awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills) | 28k | 1,497+ (curated list) | -| [impeccable](https://github.com/pbakaus/impeccable) | 27k | 1 (with 7 design domain references) | +| [awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills) | 28k | 1,497+（精选列表） | +| [impeccable](https://github.com/pbakaus/impeccable) | 27k | 1（含 7 个设计领域参考） | | [agent-skills](https://github.com/addyosmani/agent-skills) | 27k | 21 | -| [claude-skills](https://github.com/alirezarezvani/claude-skills) | 15k | 246 (across 9 domains) | +| [claude-skills](https://github.com/alirezarezvani/claude-skills) | 15k | 246（涵盖 9 个领域） | | [shanraisshan/draw-json-architecture-skill](https://github.com/shanraisshan/draw-json-architecture-skill) | 3 | 1 |

- section divider + 章节分隔符

-## 🤖 AGENT COLLECTIONS +## 🤖 智能体集合（AGENT COLLECTIONS） -Repos primarily known as curated libraries of subagent definitions (`.claude/agents/*.md`). Sorted by stars descending. +主要以子智能体定义（`.claude/agents/*.md`）精选库著称的仓库。按 star 数降序排列。 -| Name | ★ | | +| 名称 | ★ | | |------|---|---| | [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents) | 131k | 254 | | [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) | 23k | 156 |

- section divider + 章节分隔符

-## 💡 TIPS AND TRICKS (83) +## 💡 技巧与窍门（83） -🚫👶 = do not babysit +🚫👶 = 不要手把手盯着 [Prompting](#tips-prompting) · [Planning](#tips-planning) · [Context](#tips-context) · [Session](#tips-session) · [CLAUDE.md + .claude/rules](#tips-claudemd) · [Agents](#tips-agents) · [Commands](#tips-commands) · [Skills](#tips-skills) · [Hooks](#tips-hooks) · [Workflows](#tips-workflows) · [Advanced](#tips-workflows-advanced) · [Git / PR](#tips-git-pr) · [Debugging](#tips-debugging) · [Utilities](#tips-utilities) · [Daily](#tips-daily) ![Community](!/tags/community.svg) -■ **Prompting (3)** +■ **提示词（Prompting）（3）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| challenge Claude — "grill me on these changes and don't make a PR until I pass your test." or "prove to me this works" and have Claude diff between main and your branch 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742752566632544) | -| after a mediocre fix — "knowing everything you know now, scrap this and implement the elegant solution" 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742752566632544) | -| Claude fixes most bugs by itself — paste the bug, say "fix", don't micromanage how 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742750473720121) | +| 挑战 Claude——「就这些改动拷问我，等我通过你的测试再提 PR。」或「向我证明这能跑通」，让 Claude 对比 main 与你的分支差异 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742752566632544) | +| 平庸修复之后——「以你现在掌握的全部信息，扔掉这套，实现更优雅的方案」🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742752566632544) | +| Claude 大多能自行修 bug——粘贴 bug，说「fix」，别微观管理做法 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742750473720121) | -■ **Planning/Specs (7)** +■ **规划/规格（Planning/Specs）（7）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| always start with [plan mode](https://code.claude.com/docs/en/common-workflows) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179845336527000) | -| start with a minimal spec or prompt and ask Claude to interview you using [AskUserQuestion](https://code.claude.com/docs/en/cli-reference) tool, then make a new session to execute the spec | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2005315275026260309) | -| always make a phase-wise gated plan, with each phase having multiple tests (unit, automation, integration) | [![Dex](!/tags/community-dex.svg)](videos/claude-dex-mlops-community-24-mar-26.md) [![Video](!/tags/video.svg)](https://youtu.be/YwZR6tc7qYg?t=1032) | -| break PRDs into vertical slices (tracer bullets) that cross all layers (DB + service + UI) — AI defaults to horizontal phasing (DB phase, then API phase, then frontend phase) which delays end-to-end feedback until the last phase. From the Pragmatic Programmer 🚫👶 | [![Matt](!/tags/community-matt.svg)](videos/claude-matt-pocock-24-apr-26.md) [![Video](!/tags/video.svg)](https://youtu.be/-QFHIoCo-Ko) | -| spin up a second Claude to review your plan as a staff engineer, or use [cross-model](development-workflows/cross-model-workflow/cross-model-workflow.md) for review | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742745365057733) | -| write detailed specs and reduce ambiguity before handing work off — the more specific you are, the better the output | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742752566632544) | -| prototype > PRD — build 20-30 versions instead of writing specs, the cost of building is low so take many shots | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=3630) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=3630) | +| 始终从 [plan mode](https://code.claude.com/docs/en/common-workflows) 开始 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179845336527000) | +| 从最小规格或提示词起步，让 Claude 用 [AskUserQuestion](https://code.claude.com/docs/en/cli-reference) 工具向你提问，再开新会话执行规格 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2005315275026260309) | +| 始终制定分阶段门禁式计划，每阶段含多项测试（单元、自动化、集成） | [![Dex](!/tags/community-dex.svg)](videos/claude-dex-mlops-community-24-mar-26.md) [![Video](!/tags/video.svg)](https://youtu.be/YwZR6tc7qYg?t=1032) | +| 将 PRD 拆成贯穿各层的垂直切片（tracer bullets）（DB + 服务 + UI）——AI 默认横向分阶段（先 DB、再 API、再前端），端到端反馈会拖到最后。出自《程序员修炼之道》🚫👶 | [![Matt](!/tags/community-matt.svg)](videos/claude-matt-pocock-24-apr-26.md) [![Video](!/tags/video.svg)](https://youtu.be/-QFHIoCo-Ko) | +| 再起一个 Claude 以 staff engineer 视角审计划，或用 [cross-model](development-workflows/cross-model-workflow/cross-model-workflow.md) 做审查 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742745365057733) | +| 交接前写清规格、减少歧义——越具体，产出越好 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742752566632544) | +| 原型 > PRD——多搭 20-30 版，少写规格；构建成本低，多试几枪 | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=3630) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=3630) | -■ **Context (5)** +■ **上下文（Context）（5）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| context rot kicks in around ~300-400k tokens on the 1M context model — don't let sessions drift past that for intelligence-sensitive work | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | -| dumb zone kicks in around ~40% context — "you hit this point where you have degrading results". Newcomers: "shoot to keep it under 40%, and if you get up to 60%, think about wrapping it up". Experienced: "aggressively keep it below 30%" — push to 60% only on simple tasks. Manual [/compact](https://code.claude.com/docs/en/interactive-mode) or [/clear](https://code.claude.com/docs/en/cli-reference) to reset when switching tasks | [![Dex](!/tags/community-dex.svg)](videos/claude-dex-mlops-community-24-mar-26.md) [![Video](!/tags/video.svg)](https://youtu.be/YwZR6tc7qYg?t=1541) | -| rewind > correct — double-Esc or [/rewind](https://code.claude.com/docs/en/checkpointing) back to before the failed attempt and re-prompt with what you learned, instead of leaving failed attempts + corrections polluting context 🚫👶 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | -| [/compact](https://code.claude.com/docs/en/interactive-mode) with a hint (/compact focus on the auth refactor, drop the test debugging) beats letting autocompact fire — the model is at its least intelligent point when auto-compacting due to context rot | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | -| use subagents for context management — ask yourself "will I need this tool output again, or just the conclusion?" — 20 file reads + 12 greps + 3 dead ends stay in the child's context, only the final report returns 🚫👶 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | +| 在 1M 上下文模型上，上下文衰减（context rot）大约在 ~300-400k tokens 时开始显现 — 对智能敏感的工作不要让会话超过这个范围 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | +| 迟钝区（dumb zone）大约在 ~40% 上下文时出现 — "你会到达一个结果开始变差的节点"。新手："尽量保持在 40% 以下，如果到 60%，考虑收尾"。老手："积极保持在 30% 以下" — 仅在简单任务上才推到 60%。切换任务时手动使用 [/compact](https://code.claude.com/docs/en/interactive-mode) 或 [/clear](https://code.claude.com/docs/en/cli-reference) 来重置 | [![Dex](!/tags/community-dex.svg)](videos/claude-dex-mlops-community-24-mar-26.md) [![Video](!/tags/video.svg)](https://youtu.be/YwZR6tc7qYg?t=1541) | +| 回退优于纠错 — 双击 Esc 或 [/rewind](https://code.claude.com/docs/en/checkpointing) 回到失败尝试之前，用你学到的东西重新提示，而不是让失败尝试 + 纠正污染上下文 🚫👶 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | +| 带提示的 [/compact](https://code.claude.com/docs/en/interactive-mode)（如 /compact focus on the auth refactor, drop the test debugging）优于让 autocompact 自动触发 — 因上下文衰减而自动压缩时，模型处于最不智能的状态 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | +| 用 subagents 做上下文管理 — 问自己"我还会需要这份工具输出，还是只要结论？" — 20 次文件读取 + 12 次 grep + 3 次死胡同留在子代理的上下文中，只返回最终报告 🚫👶 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | -■ **Session Management (6)** +■ **会话管理（Session Management）（6）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| every turn is a branching point — after Claude ends a turn, pick between Continue, /rewind, /clear, /compact, or Subagent based on how much existing context you need to carry forward | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | -| new task = new session — related tasks (e.g. writing docs for what you just built) can reuse context for efficiency, but genuinely new tasks deserve a fresh session | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | -| use "summarize from here" before rewinding to have Claude write a handoff message — like a note to the previous iteration of Claude from its future self | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | -| /compact vs /clear — compact is lossy but momentum-friendly (mid-task, fuzzy details ok); /clear + brief is more work but you control exactly what carries forward (high-stakes next step) | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | -| use recaps for long-running sessions — short summaries of what Claude did and what's next, useful when returning after minutes or hours. Disable with recaps in /config | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | -| [/rename](https://code.claude.com/docs/en/cli-reference) important sessions (e.g. [TODO - refactor task]) and [/resume](https://code.claude.com/docs/en/cli-reference) them later — label each instance when running multiple Claudes simultaneously | [![Cat](!/tags/cat-wu.svg)](https://every.to/podcast/how-to-use-claude-code-like-the-people-who-built-it) | +| 每一轮都是一个分支点 — Claude 结束一轮后，根据你需要携带多少现有上下文，在 Continue、/rewind、/clear、/compact 或 Subagent 之间选择 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | +| 新任务 = 新会话 — 相关任务（例如为你刚构建的内容写文档）可以复用上下文以提高效率，但真正的新任务值得开一个新会话 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | +| 回退前使用 "summarize from here" 让 Claude 写一份交接消息 — 像是来自未来自己的、写给上一版 Claude 的便条 | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | +| /compact 对比 /clear — compact 有损但利于保持势头（任务中途、模糊细节可接受）；/clear + brief 更费力但你能精确控制什么被带过去（高风险的下一步） | [![Thariq](!/tags/thariq.svg)](tips/claude-thariq-tips-16-apr-26.md) | +| 对长期会话使用 recaps — Claude 做了什么以及下一步是什么的简短摘要，在隔几分钟或几小时后回来时很有用。在 /config 中用 recaps 可禁用 | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | +| [/rename](https://code.claude.com/docs/en/cli-reference) 重要会话（例如 [TODO - refactor task]），之后用 [/resume](https://code.claude.com/docs/en/cli-reference) 恢复 — 同时运行多个 Claude 时为每个实例加标签 | [![Cat](!/tags/cat-wu.svg)](https://every.to/podcast/how-to-use-claude-code-like-the-people-who-built-it) | -■ **CLAUDE.md + .claude/rules (8)** +■ **CLAUDE.md + .claude/rules（8）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| [CLAUDE.md](https://code.claude.com/docs/en/memory) should target under [200 lines](https://code.claude.com/docs/en/memory#write-effective-instructions) per file. [60 lines in humanlayer](https://www.humanlayer.dev/blog/writing-a-good-claude-md) ([still not 100% guaranteed](https://www.reddit.com/r/ClaudeCode/comments/1qn9pb9/claudemd_says_must_use_agent_claude_ignores_it_80/)) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179840848597422) [![Dex](!/tags/community-dex.svg)](https://www.humanlayer.dev/blog/writing-a-good-claude-md) | -| .claude/rules/*.md auto-load into every session like CLAUDE.md — add paths: YAML frontmatter to lazy-load them only when Claude touches files matching the glob | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) | -| wrap domain-specific CLAUDE.md rules in [\ tags](https://www.hlyr.dev/blog/stop-claude-from-ignoring-your-claude-md) to stop Claude from ignoring them as files grow longer | [![Dex](!/tags/community-dex.svg)](https://www.hlyr.dev/blog/stop-claude-from-ignoring-your-claude-md) | -| use [multiple CLAUDE.md](best-practice/claude-memory.md) for monorepos — ancestor + descendant loading | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2016339448863355206) | -| use [.claude/rules/](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) to split large instructions | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) | -| any developer should be able to launch Claude, say "run the tests" and it works on the first try — if it doesn't, your CLAUDE.md is missing essential setup/build/test commands | [![Dex](!/tags/community-dex.svg)](https://x.com/dexhorthy/status/2034713765401551053) | -| keep codebases clean and finish migrations — partially migrated frameworks confuse models that might pick the wrong pattern | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=1112) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=1112) | -| use [settings.json](best-practice/claude-settings.md) for harness-enforced behavior (attribution, permissions, model) — don't put "NEVER add Co-Authored-By" in CLAUDE.md when attribution.commit: "" is deterministic | [![davila7](!/tags/community-davila7.svg)](https://x.com/dani_avila7/status/2036182734310195550) | +| [CLAUDE.md](https://code.claude.com/docs/en/memory) 应目标为每个文件 [200 行](https://code.claude.com/docs/en/memory#write-effective-instructions) 以内。[humanlayer 中的 60 行](https://www.humanlayer.dev/blog/writing-a-good-claude-md)（[仍不能保证 100%](https://www.reddit.com/r/ClaudeCode/comments/1qn9pb9/claudemd_says_must_use_agent_claude_ignores_it_80/)) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179840848597422) [![Dex](!/tags/community-dex.svg)](https://www.humanlayer.dev/blog/writing-a-good-claude-md) | +| .claude/rules/*.md 像 CLAUDE.md 一样自动加载到每个会话 — 添加 paths: YAML frontmatter，仅在 Claude 接触到匹配 glob 的文件时才懒加载 | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) | +| 将领域特定的 CLAUDE.md 规则包在 [\ tags](https://www.hlyr.dev/blog/stop-claude-from-ignoring-your-claude-md) 中，防止文件变长后 Claude 忽略它们 | [![Dex](!/tags/community-dex.svg)](https://www.hlyr.dev/blog/stop-claude-from-ignoring-your-claude-md) | +| 对 monorepos 使用 [多个 CLAUDE.md](best-practice/claude-memory.md) — 祖先 + 后代加载 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2016339448863355206) | +| 用 [.claude/rules/](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) 拆分大型指令 | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) | +| 任何开发者都应能启动 Claude，说 "run the tests" 并在第一次就成功 — 如果不行，你的 CLAUDE.md 缺少必要的 setup/build/test 命令 | [![Dex](!/tags/community-dex.svg)](https://x.com/dexhorthy/status/2034713765401551053) | +| 保持代码库整洁并完成迁移 — 部分迁移的框架会让模型困惑，可能选错模式 | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=1112) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=1112) | +| 用 [settings.json](best-practice/claude-settings.md) 处理 harness 强制行为（attribution、permissions、model）— 当 attribution.commit: "" 是确定性的时，不要把 "NEVER add Co-Authored-By" 放在 CLAUDE.md 中 | [![davila7](!/tags/community-davila7.svg)](https://x.com/dani_avila7/status/2036182734310195550) | - **Agents (4)** + **Agents（代理）（4）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| have feature specific [sub-agents](https://code.claude.com/docs/en/sub-agents) (extra context) with [skills](https://code.claude.com/docs/en/skills) (progressive disclosure) instead of general qa, backend engineer | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179850139000872) | -| say "use subagents" to throw more compute at a problem — offload tasks to keep your main context clean and focused 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742755737555434) | -| [agent teams with tmux](https://code.claude.com/docs/en/agent-teams) and [git worktrees](https://x.com/bcherny/status/2025007393290272904) for parallel development | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2025007393290272904) | -| use [test time compute](https://code.claude.com/docs/en/sub-agents) — separate context windows make results better; one agent can cause bugs and another (same model) can find them | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2031151689219321886) | +| 为特定功能配置 [sub-agents](https://code.claude.com/docs/en/sub-agents)（额外上下文）和 [skills](https://code.claude.com/docs/en/skills)（渐进式披露），而不是通用的 qa、backend engineer | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179850139000872) | +| 说 "use subagents" 以投入更多算力解决问题 — 卸载任务以保持主上下文干净、专注 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742755737555434) | +| [配合 tmux 的 agent teams](https://code.claude.com/docs/en/agent-teams) 和 [git worktrees](https://x.com/bcherny/status/2025007393290272904) 用于并行开发 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2025007393290272904) | +| 使用 [test time compute](https://code.claude.com/docs/en/sub-agents) — 独立的上下文窗口让结果更好；一个代理可能引入 bug，另一个（同一模型）能发现它们 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2031151689219321886) | - **Commands (3)** + **Commands（命令）（3）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| use [commands](https://code.claude.com/docs/en/slash-commands) for your workflows instead of [sub-agents](https://code.claude.com/docs/en/sub-agents) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179847949500714) | -| use [slash commands](https://code.claude.com/docs/en/slash-commands) for every "inner loop" workflow you do many times a day — saves repeated prompting, commands live in .claude/commands/ and are checked into git | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179847949500714) | -| if you do something more than once a day, turn it into a [skill](https://code.claude.com/docs/en/skills) or [command](https://code.claude.com/docs/en/slash-commands) — build /techdebt, context-dump, or analytics commands | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742748984742078) | +| 对工作流使用 [commands](https://code.claude.com/docs/en/slash-commands)，而不是 [sub-agents](https://code.claude.com/docs/en/sub-agents) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179847949500714) | +| 对你每天多次执行的每个"内循环（inner loop）"工作流使用 [slash commands](https://code.claude.com/docs/en/slash-commands) — 避免重复提示，命令放在 .claude/commands/ 并纳入 git | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179847949500714) | +| 如果某件事你一天做超过一次，把它变成 [skill](https://code.claude.com/docs/en/skills) 或 [command](https://code.claude.com/docs/en/slash-commands) — 构建 /techdebt、context-dump 或 analytics 命令 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742748984742078) | - **Skills (9)** + **Skills（9）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| use [context: fork](https://code.claude.com/docs/en/skills) to run a skill in an isolated subagent — main context only sees the final result, not intermediate tool calls. The agent field lets you set the subagent type | [![Lydia](!/tags/lydia.svg)](https://x.com/lydiahallie/status/2033603164398883042) | -| use [skills in subfolders](reports/claude-skills-for-larger-mono-repos.md) for monorepos | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/skills) | -| skills are folders, not files — use references/, scripts/, examples/ subdirectories for [progressive disclosure](https://code.claude.com/docs/en/skills) | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | -| build a Gotchas section in every skill — highest-signal content, add Claude's failure points over time | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | -| skill description field is a trigger, not a summary — write it for the model ("when should I fire?") | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | -| don't state the obvious in skills — focus on what pushes Claude out of its default behavior 🚫👶 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | -| don't railroad Claude in skills — give goals and constraints, not prescriptive step-by-step instructions 🚫👶 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | -| include scripts and libraries in skills so Claude composes rather than reconstructs boilerplate | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | -| embed !command in SKILL.md to inject dynamic shell output into the prompt — Claude runs it on invocation and the model only sees the result | [![Lydia](!/tags/lydia.svg)](https://x.com/lydiahallie/status/2034337963820327017) | +| 使用 [context: fork](https://code.claude.com/docs/en/skills) 在隔离的子代理中运行 skill — 主上下文只能看到最终结果，看不到中间工具调用。`agent` 字段可用来设置子代理类型 | [![Lydia](!/tags/lydia.svg)](https://x.com/lydiahallie/status/2033603164398883042) | +| 在 monorepo 中使用[子文件夹中的 skills](reports/claude-skills-for-larger-mono-repos.md) | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/skills) | +| skills 是文件夹而非文件 — 使用 references/、scripts/、examples/ 子目录实现[渐进式披露（progressive disclosure）](https://code.claude.com/docs/en/skills) | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | +| 在每个 skill 中构建 Gotchas（常见陷阱）部分 — 这是信号最强的内容，可随时间补充 Claude 的失败点 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | +| skill 的 description 字段是触发器而非摘要 — 写给模型看（「何时应触发？」） | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | +| 不要在 skills 里陈述显而易见的内容 — 聚焦能推动 Claude 偏离默认行为的内容 🚫👶 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | +| 不要在 skills 中强行约束 Claude 的执行路径 — 给出目标与约束，而非规定性的逐步指令 🚫👶 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | +| 在 skills 中包含 scripts 与 libraries，让 Claude 组合复用而非重新拼凑样板代码 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | +| 在 SKILL.md 中嵌入 !command，将动态 shell 输出注入 prompt — Claude 在调用时执行它，模型只看到结果 | [![Lydia](!/tags/lydia.svg)](https://x.com/lydiahallie/status/2034337963820327017) | -■ **Hooks (5)** +■ **Hooks（5）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| use [on-demand hooks](https://code.claude.com/docs/en/skills) in skills — /careful blocks destructive commands, /freeze blocks edits outside a directory | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | -| [measure skill usage](https://code.claude.com/docs/en/skills) with a PreToolUse hook to find popular or undertriggering skills | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | -| use a [PostToolUse hook](https://code.claude.com/docs/en/hooks) to auto-format code — Claude generates well-formatted code, the hook handles the last 10% to avoid CI failures | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179852047335529) | -| route [permission requests](https://code.claude.com/docs/en/hooks) to Opus via a hook — let it scan for attacks and auto-approve safe ones 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742755737555434) | -| use a [Stop hook](https://code.claude.com/docs/en/hooks) to nudge Claude to keep going or verify its work at the end of a turn | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021701059253874861) | +| 在 skills 中使用[按需 hooks](https://code.claude.com/docs/en/skills) — /careful 会拦截破坏性命令，/freeze 会拦截目录外的编辑 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | +| 用 PreToolUse hook [衡量 skill 使用情况](https://code.claude.com/docs/en/skills)，以发现热门或触发不足的 skills | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | +| 使用 [PostToolUse hook](https://code.claude.com/docs/en/hooks) 自动格式化代码 — Claude 会生成格式良好的代码，hook 负责最后 10%，避免 CI 失败 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179852047335529) | +| 通过 hook 将[权限请求](https://code.claude.com/docs/en/hooks) 路由到 Opus — 让它扫描攻击并自动批准安全的请求 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742755737555434) | +| 使用 [Stop hook](https://code.claude.com/docs/en/hooks)，在一轮结束时推动 Claude 继续或验证其工作 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021701059253874861) | -■ **Workflows (5)** +■ **Workflows（5）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| use [/model](https://code.claude.com/docs/en/model-config) to select model and reasoning, [/context](https://code.claude.com/docs/en/interactive-mode) to see context usage, [/usage](https://code.claude.com/docs/en/costs) to check plan limits, [/extra-usage](https://code.claude.com/docs/en/interactive-mode) to configure overflow billing, [/config](https://code.claude.com/docs/en/settings) to configure settings — use Opus for plan mode and Sonnet for code to get the best of both | [![Cat](!/tags/cat-wu.svg)](https://x.com/_catwu/status/1955694117264261609) | -| always use [thinking mode](https://code.claude.com/docs/en/model-config) true (to see reasoning) and [Output Style](https://code.claude.com/docs/en/output-styles) Explanatory (to see detailed output with ★ Insight boxes) in [/config](https://code.claude.com/docs/en/settings) for better understanding of Claude's decisions | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179838864666847) | -| use ultrathink keyword in prompts for [high effort reasoning](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking#tips-and-best-practices) | [![Claude](!/tags/claude.svg)](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking#tips-and-best-practices) | -| /focus mode hides all intermediate work and shows only the final result — trust the model to run the right commands and just look at the outcome (toggle with /focus) | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | -| tune effort level with Opus 4.7's adaptive thinking — low for speed and fewer tokens, max for most intelligence (slider: low · medium · high · xhigh · max) | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | +| 使用 [/model](https://code.claude.com/docs/en/model-config) 选择模型与推理能力，[/context](https://code.claude.com/docs/en/interactive-mode) 查看上下文用量，[/usage](https://code.claude.com/docs/en/costs) 检查套餐限额，[/extra-usage](https://code.claude.com/docs/en/interactive-mode) 配置超额计费，[/config](https://code.claude.com/docs/en/settings) 配置设置 — 计划模式用 Opus、写代码用 Sonnet，兼顾两者优势 | [![Cat](!/tags/cat-wu.svg)](https://x.com/_catwu/status/1955694117264261609) | +| 在 [/config](https://code.claude.com/docs/en/settings) 中始终开启 [thinking mode](https://code.claude.com/docs/en/model-config) true（以查看推理过程）和 [Output Style](https://code.claude.com/docs/en/output-styles) Explanatory（以查看带 ★ Insight 框的详细输出），从而更好理解 Claude 的决策 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179838864666847) | +| 在 prompt 中使用 ultrathink 关键词以启用[高投入推理](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking#tips-and-best-practices) | [![Claude](!/tags/claude.svg)](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking#tips-and-best-practices) | +| /focus 模式会隐藏所有中间工作，仅显示最终结果 — 信任模型会执行正确命令，你只需看结果（用 /focus 切换） | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | +| 用 Opus 4.7 的自适应 thinking 调节投入程度 — low 更快、token 更少，max 智力最高（滑块：low · medium · high · xhigh · max） | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | -■ **Workflows Advanced (9)** +■ **Workflows Advanced（9）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| use ASCII diagrams a lot to understand your architecture | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742759218794768) | -| use [/loop](https://code.claude.com/docs/en/scheduled-tasks) for local recurring monitoring (up to 7 days) · use [/schedule](https://code.claude.com/docs/en/routines) for cloud-based recurring tasks that run even when your machine is off | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038454341884154269) | -| use [Ralph Wiggum plugin](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) for long-running autonomous tasks | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179858435281082) | -| [/permissions](https://code.claude.com/docs/en/permissions) with wildcard syntax (Bash(npm run *), Edit(/docs/**)) instead of dangerously-skip-permissions | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179854077407667) | -| [/sandbox](https://code.claude.com/docs/en/sandboxing) to reduce permission prompts with file and network isolation — 84% reduction internally | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021700506465579443) [![Cat](!/tags/cat-wu.svg)](https://creatoreconomy.so/p/inside-claude-code-how-an-ai-native-actually-works-cat-wu) | -| invest in [product verification](https://code.claude.com/docs/en/skills) skills (signup-flow-driver, checkout-verifier) — worth spending a week to perfect | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | -| use [auto mode](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) instead of dangerously-skip-permissions — a model-based classifier decides if each command is safe and auto-approves, pauses and asks if risky. Shift+Tab to cycle Ask → Plan → Auto modes 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | -| use /less-permission-prompts skill to scan session history for safe bash/MCP commands that repeatedly prompt, then get a recommended allowlist to paste into [settings](best-practice/claude-settings.md) | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | -| build a /go skill that (1) tests end-to-end via bash/browser/computer use (2) runs /simplify (3) puts up a PR — so when you come back, you know the code works 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | +| 大量使用 ASCII 图来理解你的架构 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742759218794768) | +| 用 [/loop](https://code.claude.com/docs/en/scheduled-tasks) 做本地周期性监控（最长 7 天）· 用 [/schedule](https://code.claude.com/docs/en/routines) 做云端周期性任务，即使机器关机也会运行 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038454341884154269) | +| 使用 [Ralph Wiggum plugin](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) 处理长时间自主任务 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179858435281082) | +| 用 [/permissions](https://code.claude.com/docs/en/permissions) 搭配通配符语法（Bash(npm run *)、Edit(/docs/**)），而不是 dangerously-skip-permissions | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2007179854077407667) | +| 用 [/sandbox](https://code.claude.com/docs/en/sandboxing) 通过文件与网络隔离减少权限提示 — 内部减少 84% | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021700506465579443) [![Cat](!/tags/cat-wu.svg)](https://creatoreconomy.so/p/inside-claude-code-how-an-ai-native-actually-works-cat-wu) | +| 投入 [product verification](https://code.claude.com/docs/en/skills) skills（signup-flow-driver、checkout-verifier）— 值得花一周时间打磨 | [![Thariq](!/tags/thariq.svg)](https://x.com/trq212/status/2033949937936085378) | +| 使用 [auto mode](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) 而非 dangerously-skip-permissions — 基于模型的分类器判断每条命令是否安全并自动批准，有风险则暂停并询问。Shift+Tab 在 Ask → Plan → Auto 模式间切换 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | +| 使用 /less-permission-prompts skill 扫描会话历史，找出反复提示的安全 bash/MCP 命令，然后获取推荐 allowlist 并粘贴到 [settings](best-practice/claude-settings.md) | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | +| 构建 /go skill，(1) 通过 bash/browser/computer use 做端到端测试 (2) 运行 /simplify (3) 提交 PR — 这样你回来时就能确认代码可用 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](tips/claude-boris-6-tips-16-apr-26.md) | -■ **Git / PR (5)** +■ **Git / PR（5）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| keep PRs small and focused — [p50 of 118 lines](tips/claude-boris-2-tips-25-mar-26.md) (141 PRs, 45K lines changed in a day), one feature per PR, easier to review and revert | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038552880018538749) | -| always [squash merge](tips/claude-boris-2-tips-25-mar-26.md) PRs — clean linear history, one commit per feature, easy git revert and git bisect | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038552880018538749) | -| commit often — try to commit at least once per hour, as soon as task is completed, commit | ![Shayan](!/tags/community-shayan.svg) | -| tag [@claude](https://github.com/apps/claude) on a coworker's PR to auto-generate lint rules for recurring review feedback — automate yourself out of code review 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=2715) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=2715) | -| use [/code-review](https://code.claude.com/docs/en/code-review) for multi-agent PR analysis — catches bugs, security vulnerabilities, and regressions before merge | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2031089411820228645) | +| 保持 PR 小而聚焦 — [p50 为 118 行](tips/claude-boris-2-tips-25-mar-26.md)（一天 141 个 PR、变更 45K 行），每个 PR 一个功能，更易审查和回滚 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038552880018538749) | +| 始终对 PR 使用 [squash merge](tips/claude-boris-2-tips-25-mar-26.md) — 保持干净的线性历史，每个功能一个提交，便于 git revert 和 git bisect | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038552880018538749) | +| 频繁提交 — 尽量每小时至少提交一次，任务一完成就提交 | ![Shayan](!/tags/community-shayan.svg) | +| 在同事的 PR 上标注 [@claude](https://github.com/apps/claude)，为反复出现的评审反馈自动生成 lint 规则 — 把自己从代码评审中自动化掉 🚫👶 | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=2715) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=2715) | +| 使用 [/code-review](https://code.claude.com/docs/en/code-review) 进行多代理 PR 分析 — 在合并前捕获 bug、安全漏洞和回归 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2031089411820228645) | -■ **Debugging (6)** +■ **调试（6）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| make it a habit to take screenshots and share with Claude whenever you are stuck with any issue | ![Shayan](!/tags/community-shayan.svg) | -| use mcp ([Claude in Chrome](https://code.claude.com/docs/en/chrome), [Playwright](https://github.com/microsoft/playwright-mcp), [Chrome DevTools](https://developer.chrome.com/blog/chrome-devtools-mcp)) to let claude see chrome console logs on its own | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/chrome) | -| always ask claude to run the terminal (you want to see logs of) as a background task for better debugging | ![Shayan](!/tags/community-shayan.svg) | -| [/doctor](https://code.claude.com/docs/en/cli-reference) to diagnose installation, authentication, and configuration issues | ![Shayan](!/tags/community-shayan.svg) | -| use a [cross-model](development-workflows/cross-model-workflow/cross-model-workflow.md) for QA — e.g. [Codex](https://github.com/shanraisshan/codex-cli-best-practice) for plan and implementation review | ![Shayan](!/tags/community-shayan.svg) | -| agentic search (glob + grep) beats RAG — Claude Code tried and discarded vector databases because code drifts out of sync and permissions are complex | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=3095) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=3095) | +| 养成习惯：遇到任何问题时截图并分享给 Claude | ![Shayan](!/tags/community-shayan.svg) | +| 使用 MCP（[Claude in Chrome](https://code.claude.com/docs/en/chrome), [Playwright](https://github.com/microsoft/playwright-mcp), [Chrome DevTools](https://developer.chrome.com/blog/chrome-devtools-mcp))，让 Claude 自行查看 Chrome 控制台日志 | [![Claude](!/tags/claude.svg)](https://code.claude.com/docs/en/chrome) | +| 始终让 Claude 将你希望查看日志的终端以后台任务方式运行，以便更好地调试 | ![Shayan](!/tags/community-shayan.svg) | +| 使用 [/doctor](https://code.claude.com/docs/en/cli-reference) 诊断安装、认证与配置问题 | ![Shayan](!/tags/community-shayan.svg) | +| 采用 [cross-model](development-workflows/cross-model-workflow/cross-model-workflow.md)（跨模型）工作流做 QA——例如用 [Codex](https://github.com/shanraisshan/codex-cli-best-practice) 做计划与实现评审 | ![Shayan](!/tags/community-shayan.svg) | +| 智能体搜索（glob + grep）优于 RAG——Claude Code 曾尝试向量数据库后弃用，因为代码会脱节且权限复杂 | [![Boris](!/tags/boris-cherny.svg)](https://youtu.be/julbw1JuAz0?t=3095) [![Video](!/tags/video.svg)](https://youtu.be/julbw1JuAz0?t=3095) | -■ **Utilities (5)** +■ **实用工具（5）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| [iTerm](https://iterm2.com/)/[Ghostty](https://ghostty.org/)/[tmux](https://github.com/tmux/tmux) terminals instead of IDE ([VS Code](https://code.visualstudio.com/)/[Cursor](https://www.cursor.com/)) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742753971769626) | -| [/voice](https://code.claude.com/docs/en/voice-dictation) or [Wispr Flow](https://wisprflow.ai) for voice prompting (10x productivity) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038454362226467112) | -| [claude-code-hooks](https://github.com/shanraisshan/claude-code-hooks) for claude feedback | ![Shayan](!/tags/community-shayan.svg) | -| [status line](https://github.com/shanraisshan/claude-code-status-line) for context awareness and fast compacting | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021700784019452195) ![Shayan](!/tags/community-shayan.svg) | -| explore [settings.json](best-practice/claude-settings.md) features like [Plans Directory](best-practice/claude-settings.md#plans-directory), [Spinner Verbs](best-practice/claude-settings.md#display--ux) for a personalized experience | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021701145023197516) | +| 使用 [iTerm](https://iterm2.com/)/[Ghostty](https://ghostty.org/)/[tmux](https://github.com/tmux/tmux) 终端而非 IDE（[VS Code](https://code.visualstudio.com/)/[Cursor](https://www.cursor.com/)) | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2017742753971769626) | +| 使用 [/voice](https://code.claude.com/docs/en/voice-dictation) 或 [Wispr Flow](https://wisprflow.ai) 进行语音提示（10 倍生产力） | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2038454362226467112) | +| 使用 [claude-code-hooks](https://github.com/shanraisshan/claude-code-hooks) 获取 Claude 反馈 | ![Shayan](!/tags/community-shayan.svg) | +| 使用 [status line](https://github.com/shanraisshan/claude-code-status-line) 提升上下文感知并快速压缩 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021700784019452195) ![Shayan](!/tags/community-shayan.svg) | +| 探索 [settings.json](best-practice/claude-settings.md) 中的功能，例如 [Plans Directory](best-practice/claude-settings.md#plans-directory)、[Spinner Verbs](best-practice/claude-settings.md#display--ux)，以获得个性化体验 | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny/status/2021701145023197516) | -■ **Daily (2)** +■ **日常（2）** -| Tip | Source | +| 技巧 | 来源 | |-----|--------| -| [update](https://code.claude.com/docs/en/setup) Claude Code daily | ![Shayan](!/tags/community-shayan.svg) | -| start your day by reading the [changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) | ![Shayan](!/tags/community-shayan.svg) | +| 每日 [update](https://code.claude.com/docs/en/setup) Claude Code | ![Shayan](!/tags/community-shayan.svg) | +| 每天从阅读 [changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) 开始 | ![Shayan](!/tags/community-shayan.svg) | ![Boris Cherny + Team](!/tags/claude.svg) -| Article / Tweet | Source | +| 文章 / 推文 | 来源 | |-----------------|--------| -| [6 Tips for Getting More Out of Opus 4.7 (Boris) \| 16/Apr/26](tips/claude-boris-6-tips-16-apr-26.md) | [Tweet](https://x.com/bcherny) | -| [Session Management & 1M Context (Thariq) \| 16/Apr/26](tips/claude-thariq-tips-16-apr-26.md) | [Tweet](https://x.com/trq212) | -| [15 Hidden & Under-Utilized Features in Claude Code (Boris) \| 30/Mar/26](tips/claude-boris-15-tips-30-mar-26.md) | [Tweet](https://x.com/bcherny/status/2038454336355999749) | -| [Squash Merging & PR Size Distribution (Boris) \| 25/Mar/26](tips/claude-boris-2-tips-25-mar-26.md) | [Tweet](https://x.com/bcherny/status/2038552880018538749) | -| [Lessons from Building Claude Code: How We Use Skills (Thariq) \| 17/Mar/26](tips/claude-thariq-tips-17-mar-26.md) | [Article](https://x.com/trq212/status/2033949937936085378) | -| [Code Review & Test Time Compute (Boris) \| 10/Mar/26](tips/claude-boris-2-tips-10-mar-26.md) | [Tweet](https://x.com/bcherny/status/2031089411820228645) | -| /loop — schedule recurring tasks for up to 3 days (Boris) \| 07 Mar 2026 | [Tweet](https://x.com/bcherny/status/2030193932404150413) | -| AskUserQuestion + ASCII Markdowns (Thariq) \| 28 Feb 2026 | [Tweet](https://x.com/trq212/status/2027543858289250472) | -| Seeing like an Agent - lessons from building Claude Code (Thariq) \| 28 Feb 2026 | [Article](https://x.com/trq212/status/2027463795355095314) | -| Git Worktrees - 5 ways how boris is using \| 21 Feb 2026 | [Tweet](https://x.com/bcherny/status/2025007393290272904) | -| Lessons from Building Claude Code: Prompt Caching Is Everything (Thariq) \| 20 Feb 2026 | [Article](https://x.com/trq212/status/2024574133011673516) | -| [12 ways how people are customizing their claudes (Boris) \| 12/Feb/26](tips/claude-boris-12-tips-12-feb-26.md) | [Tweet](https://x.com/bcherny/status/2021699851499798911) | -| [10 tips for using Claude Code from the team (Boris) \| 01/Feb/26](tips/claude-boris-10-tips-01-feb-26.md) | [Tweet](https://x.com/bcherny/status/2017742741636321619) | -| [How I use Claude Code — 13 tips from my surprisingly vanilla setup (Boris) \| 03/Jan/26](tips/claude-boris-13-tips-03-jan-26.md) | [Tweet](https://x.com/bcherny/status/2007179832300581177) | -| Ask Claude to interview you using AskUserQuestion tool (Thariq) \| 28/Dec/25 | [Tweet](https://x.com/trq212/status/2005315275026260309) | -| Always use plan mode, give Claude a way to verify, use /code-review (Boris) \| 27/Dec/25 | [Tweet](https://x.com/bcherny/status/2004711722926616680) | +| [充分利用 Opus 4.7 的 6 条技巧（Boris）| 16/Apr/26](tips/claude-boris-6-tips-16-apr-26.md) | [Tweet](https://x.com/bcherny) | +| [会话管理与 1M 上下文（Thariq）| 16/Apr/26](tips/claude-thariq-tips-16-apr-26.md) | [Tweet](https://x.com/trq212) | +| [Claude Code 中 15 个被忽视或未充分利用的功能（Boris）| 30/Mar/26](tips/claude-boris-15-tips-30-mar-26.md) | [Tweet](https://x.com/bcherny/status/2038454336355999749) | +| [Squash 合并与 PR 规模分布（Boris）| 25/Mar/26](tips/claude-boris-2-tips-25-mar-26.md) | [Tweet](https://x.com/bcherny/status/2038552880018538749) | +| [构建 Claude Code 的经验：我们如何使用 Skills（Thariq）| 17/Mar/26](tips/claude-thariq-tips-17-mar-26.md) | [Article](https://x.com/trq212/status/2033949937936085378) | +| [代码评审与测试时计算（Boris）| 10/Mar/26](tips/claude-boris-2-tips-10-mar-26.md) | [Tweet](https://x.com/bcherny/status/2031089411820228645) | +| /loop — 安排最长 3 天的周期性任务（Boris）| 07 Mar 2026 | [Tweet](https://x.com/bcherny/status/2030193932404150413) | +| AskUserQuestion + ASCII Markdowns（Thariq）| 28 Feb 2026 | [Tweet](https://x.com/trq212/status/2027543858289250472) | +| Seeing like an Agent - 构建 Claude Code 的经验（Thariq）| 28 Feb 2026 | [Article](https://x.com/trq212/status/2027463795355095314) | +| Git Worktrees - Boris 的 5 种用法 | 21 Feb 2026 | [Tweet](https://x.com/bcherny/status/2025007393290272904) | +| 构建 Claude Code 的经验：Prompt Caching 就是一切（Thariq）| 20 Feb 2026 | [Article](https://x.com/trq212/status/2024574133011673516) | +| [人们定制 Claude 的 12 种方式（Boris）| 12/Feb/26](tips/claude-boris-12-tips-12-feb-26.md) | [Tweet](https://x.com/bcherny/status/2021699851499798911) | +| [团队使用 Claude Code 的 10 条技巧（Boris）| 01/Feb/26](tips/claude-boris-10-tips-01-feb-26.md) | [Tweet](https://x.com/bcherny/status/2017742741636321619) | +| [我如何使用 Claude Code——来自我出人意料地朴素配置的 13 条技巧（Boris）| 03/Jan/26](tips/claude-boris-13-tips-03-jan-26.md) | [Tweet](https://x.com/bcherny/status/2007179832300581177) | +| 让 Claude 使用 AskUserQuestion 工具采访你（Thariq）| 28/Dec/25 | [Tweet](https://x.com/trq212/status/2005315275026260309) | +| 始终使用 plan mode，给 Claude 验证途径，使用 /code-review（Boris）| 27/Dec/25 | [Tweet](https://x.com/bcherny/status/2004711722926616680) | -#### Tips from Claude code CLI binary +#### 来自 Claude Code CLI 二进制的技巧 -[Spinner Verbs & Tips (extracted from CLI binary v2.1.121)](reports/claude-spinner-verbs-and-tips.md) +[Spinner Verbs 与技巧（从 CLI 二进制 v2.1.121 提取）](reports/claude-spinner-verbs-and-tips.md)

- section divider + 章节分隔符

-## 🎬 VIDEOS / PODCASTS +## 🎬 视频 / 播客 -| Video / Podcast | Source | YouTube | +| 视频 / 播客 | 来源 | YouTube | |-----------------|--------|--------| -| From Vibe Coding to Agentic Engineering (Andrej) \| 02 May 2026 \| AI Engineer | [![Karpathy](!/tags/community-karpathy.svg)](https://x.com/karpathy) | [YouTube](https://www.youtube.com/watch?v=96jN2OCOfLs) | -| Full Walkthrough: Workflow for AI Coding (Matt) \| 24 Apr 2026 \| Matt Pocock | [![Matt](!/tags/community-matt.svg)](https://x.com/mattpocockuk) | [YouTube](https://youtu.be/-QFHIoCo-Ko) | -| Everything We Got Wrong About Research-Plan-Implement (Dex) \| 24 Mar 2026 \| MLOps Community | [![Dex](!/tags/community-dex.svg)](https://x.com/daborhyde) | [YouTube](https://youtu.be/YwZR6tc7qYg) | -| Building Claude Code with Boris Cherny (Boris) \| 04 Mar 2026 \| The Pragmatic Engineer | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/julbw1JuAz0) | -| Head of Claude Code: What happens after coding is solved (Boris) \| 19 Feb 2026 \| Lenny's Podcast | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/We7BZVKbCVw) | -| Inside Claude Code With Its Creator Boris Cherny (Boris) \| 17 Feb 2026 \| Y Combinator | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/PQU9o_5rHC4) | -| Boris Cherny (Creator of Claude Code) On What Grew His Career (Boris) \| 15 Dec 2025 \| Ryan Peterman | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/AmdLVWMdjOk) | -| The Secrets of Claude Code From the Engineers Who Built It (Cat) \| 29 Oct 2025 \| Every | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/IDSAMqip6ms) | +| 从 Vibe Coding 到智能体工程（Andrej）| 02 May 2026 | AI Engineer | [![Karpathy](!/tags/community-karpathy.svg)](https://x.com/karpathy) | [YouTube](https://www.youtube.com/watch?v=96jN2OCOfLs) | +| 完整演练：AI 编程工作流（Matt）| 24 Apr 2026 | Matt Pocock | [![Matt](!/tags/community-matt.svg)](https://x.com/mattpocockuk) | [YouTube](https://youtu.be/-QFHIoCo-Ko) | +| 我们对 Research-Plan-Implement 的所有误解（Dex）| 24 Mar 2026 | MLOps Community | [![Dex](!/tags/community-dex.svg)](https://x.com/daborhyde) | [YouTube](https://youtu.be/YwZR6tc7qYg) | +| 与 Boris Cherny 一起构建 Claude Code（Boris）| 04 Mar 2026 | The Pragmatic Engineer | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/julbw1JuAz0) | +| Claude Code 负责人：编码问题解决之后会怎样（Boris）| 19 Feb 2026 | Lenny's Podcast | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/We7BZVKbCVw) | +| 走进 Claude Code：与其创造者 Boris Cherny 对话（Boris）| 17 Feb 2026 | Y Combinator | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/PQU9o_5rHC4) | +| Boris Cherny（Claude Code 创造者）谈职业生涯如何成长（Boris）| 15 Dec 2025 | Ryan Peterman | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/AmdLVWMdjOk) | +| Claude Code 的秘密：来自构建它的工程师们（Cat）| 29 Oct 2025 | Every | [![Boris](!/tags/boris-cherny.svg)](https://x.com/bcherny) | [YouTube](https://youtu.be/IDSAMqip6ms) |

- section divider + 章节分隔符

-## 🔔 SUBSCRIBE +## 🔔 订阅 -| Source | Name | Badge | +| 来源 | 名称 | 徽章 | |--------|------|-------| | ![Reddit](https://img.shields.io/badge/-FF4500?style=flat&logo=reddit&logoColor=white) | [r/ClaudeAI](https://www.reddit.com/r/ClaudeAI/), [r/ClaudeCode](https://www.reddit.com/r/ClaudeCode/), [r/Anthropic](https://www.reddit.com/r/Anthropic/) | ![Boris + Team](!/tags/claude.svg) | | ![X](https://img.shields.io/badge/-000?style=flat&logo=x&logoColor=white) | [Claude](https://x.com/claudeai), [Claude Devs](https://x.com/ClaudeDevs), [Anthropic](https://x.com/AnthropicAI), [Boris](https://x.com/bcherny), [Thariq](https://x.com/trq212), [Cat](https://x.com/_catwu), [Lydia](https://x.com/lydiahallie), [Noah](https://x.com/noahzweben), [Anthony](https://x.com/amorriscode), [Alex](https://x.com/alexalbert__), [Kenneth](https://x.com/neilhtennek) | ![Boris + Team](!/tags/claude.svg) | @@ -420,9 +426,9 @@ Repos primarily known as curated libraries of subagent definitions (`.claude/age section divider

-## ☠️ STARTUPS / BUSINESSES +## ☠️ 创业公司 / 企业 -| Claude | Replaced | +| Claude | 替代方案 | |-|-| |[**Code Review**](https://code.claude.com/docs/en/code-review)|[Greptile](https://greptile.com), [CodeRabbit](https://coderabbit.ai), [Devin Review](https://devin.ai), [OpenDiff](https://opendiff.com), [Cursor BugBot](https://bugbot.dev)| |[**Voice Dictation**](https://code.claude.com/docs/en/voice-dictation)|[Wispr Flow](https://wisprflow.ai), [SuperWhisper](https://superwhisper.com/)| @@ -434,61 +440,61 @@ Repos primarily known as curated libraries of subagent definitions (`.claude/age |[**Plan Mode**](https://code.claude.com/docs/en/common-workflows)|[Agent OS](https://github.com/buildermethods/agent-os)| |[**Design**](https://claude.com/design)|[Figma](https://figma.com), [Framer](https://framer.com), [Sketch](https://sketch.com), [v0](https://v0.dev)| |[**Agent SDK**](https://code.claude.com/docs/en/agent-sdk/overview)|[LangChain](https://langchain.com), [LangGraph](https://www.langchain.com/langgraph), [CrewAI](https://www.crewai.com), [AutoGen](https://github.com/microsoft/autogen), [OpenAI Assistants API](https://platform.openai.com/docs/assistants/overview)| -|[**Skills / Plugins**](https://code.claude.com/docs/en/plugins)|YC AI wrapper startups ([reddit](https://reddit.com/r/ClaudeAI/comments/1r6bh4d/claude_code_skills_are_basically_yc_ai_startup/))| +|[**Skills / Plugins**](https://code.claude.com/docs/en/plugins)|YC AI 包装类创业公司（[reddit](https://reddit.com/r/ClaudeAI/comments/1r6bh4d/claude_code_skills_are_basically_yc_ai_startup/))|

section divider

-![Billion-Dollar Questions](!/tags/billion-dollar-questions.svg) +![十亿美元级问题](!/tags/billion-dollar-questions.svg) -*If you have answers, do let me know at shanraisshan@gmail.com* +*如果你有答案，请发邮件至 shanraisshan@gmail.com* -**Memory & Instructions (4)** +**记忆与指令（4）** -1. What exactly should you put inside your CLAUDE.md — and what should you leave out? -2. If you already have a CLAUDE.md, is a separate constitution.md or rules.md actually needed? -3. How often should you update your CLAUDE.md, and how do you know when it's become stale? -4. Why does Claude still ignore CLAUDE.md instructions — even when they say MUST in all caps? ([reddit](https://reddit.com/r/ClaudeCode/comments/1qn9pb9/claudemd_says_must_use_agent_claude_ignores_it_80/)) +1. CLAUDE.md 里究竟该写什么——又该省略什么？ +2. 如果你已经有了 CLAUDE.md，是否还需要单独的 constitution.md 或 rules.md？ +3. 你应该多久更新一次 CLAUDE.md？又如何判断它已经过时？ +4. 为什么 Claude 仍会忽略 CLAUDE.md 中的指令——即便里面用大写写着 MUST？（[reddit](https://reddit.com/r/ClaudeCode/comments/1qn9pb9/claudemd_says_must_use_agent_claude_ignores_it_80/)) -**Agents, Skills & Workflows (6)** +**智能体（Agents）、技能（Skills）与工作流（6）** -1. When should you use a command vs an agent vs a skill — and when is vanilla Claude Code just better? -2. How often should you update your agents, commands, and workflows as models improve? -3. Should you have a generalist subagent or a feature-specific/role-specific agent? Does giving your subagent a detailed persona improve quality, and what does a "perfect persona prompt" for research/vision look like? -4. Should you rely on Claude Code's built-in plan mode — or build your own planning command/agent that enforces your team's workflow? -5. If you have a personal skill (e.g., /implement with your coding style), how do you incorporate community skills (e.g., /simplify) without conflicts — and who wins when they disagree? -6. Are we there yet? Can we convert an existing codebase into specs, delete the code, and have AI regenerate the exact same code from those specs alone? +1. 什么时候该用 command、agent 还是 skill——什么时候直接用原版 Claude Code 反而更好？ +2. 随着模型能力提升，你应该多久更新一次 agents、commands 和 workflows？ +3. 你应该配置通才型 subagent，还是按功能/角色划分的 agent？给 subagent 设定详细人设能否提升质量？研究/视觉类任务的「完美人设提示词」长什么样？ +4. 应该依赖 Claude Code 内置的 plan mode，还是自己构建能强制执行团队工作流的规划 command/agent？ +5. 如果你有个人 skill（例如符合你编码风格的 /implement），如何引入社区 skill（例如 /simplify）而不冲突——当二者意见相左时谁优先？ +6. 我们到位了吗？能否把现有代码库转成规格说明、删掉代码，然后仅凭这些规格让 AI 重新生成完全相同的代码？ -**Specs & Documentation (3)** +**规格说明与文档（3）** -1. Should every feature in your repo have a spec as a markdown file? -2. How often do you need to update specs so they don't become obsolete when a new feature is implemented? -3. When implementing a new feature, how do you handle the ripple effect on specs for other features? +1. 仓库中的每个功能是否都应有对应的 markdown 规格文件？ +2. 新功能实现后，你需要多久更新规格，以免它们过时？ +3. 实现新功能时，如何处理对其他功能规格产生的连锁影响？ -### 🤔 [Does code matter?](https://github.com/shanraisshan/agentic-engineering) +### 🤔 [代码还重要吗？](https://github.com/shanraisshan/agentic-engineering)

section divider

-## REPORTS +## 报告

Agent SDK vs CLI - Browser Automation MCP - Global vs Project Settings - Skills in Monorepos + 浏览器自动化 MCP + 全局与项目设置 + 单体仓库中的 Skills
- Agent Memory - Advanced Tool Use - Usage & Rate Limits + 智能体记忆 + 高级工具使用 + 使用量与速率限制 Agents vs Commands vs Skills
- LLM Degradation - Why Harness is Important - Spinner Verbs & Tips + LLM 性能退化 + 为什么 Harness 很重要 + 加载动画动词与技巧

@@ -497,43 +503,43 @@ Repos primarily known as curated libraries of subagent definitions (`.claude/age -## How to Use +## 如何使用 -Get the maximum out of this repo by following these steps: +按以下步骤操作，充分发挥本仓库的价值： -1. **Read this repo as a course, not as a workflow or skill.** It's reference material first; you'll run things later. -2. **Don't use Claude as a chatbot.** Learn the primitives — agents, commands, skills, hooks — and assemble them into your own workflow. -3. **Run [`/weather-orchestrator`](orchestration-workflow/orchestration-workflow.md)** to see a complete command → agent → skill flow. Use it as a template for any dev workflow, from planning to shipping. -4. **Listen for the custom hook sounds while you work.** Their implementation lives in the dedicated [Claude Code Hooks repo](https://github.com/shanraisshan/claude-code-hooks); other patterns like [Agent Teams](implementation/claude-agent-teams-implementation.md) ship inside this repo's `implementation/` directory. -5. **Learn the advanced topics and their implementations** from the [🔥 Hot](#-hot) sub-table — for example, the [Ralph Wiggum self-evolving loop](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) is a full working repo you can clone to see one of these patterns end-to-end. -6. **Point Claude at the [tips and tricks](#-tips-and-tricks-83) section in your own project** and ask it to suggest edits — especially how to restructure your `CLAUDE.md`. Every tip is sourced from the Claude team or the community. -7. **Subscribe to the Reddit and YouTube channels in the [Subscribe section](#-subscribe)** to keep up with the community. +1. **把本仓库当作课程来读，而不是工作流或 skill。** 它首先是参考资料；具体动手可以之后再做。 +2. **不要把 Claude 当聊天机器人用。** 先掌握原语——agents、commands、skills、hooks——再自行组装成你的工作流。 +3. **运行 [`/weather-orchestrator`](orchestration-workflow/orchestration-workflow.md)**，查看完整的 command → agent → skill 流程。可将其作为任意开发工作流的模板，从规划到交付。 +4. **工作时留意自定义 hook 提示音。** 实现位于专门的 [Claude Code Hooks repo](https://github.com/shanraisshan/claude-code-hooks);；其他模式如 [Agent Teams](implementation/claude-agent-teams-implementation.md) 则随本仓库的 `implementation/` 目录一并提供。 +5. **从 [🔥 Hot](#-hot) 子表中学习高级主题及其实现**——例如，[Ralph Wiggum self-evolving loop](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) 是一个可克隆的完整工作仓库，可端到端查看其中一种模式。 +6. **让你自己的项目指向 [技巧与窍门](#-tips-and-tricks-83) 章节**，并请 Claude 提出修改建议——尤其是如何重构你的 `CLAUDE.md`。每条技巧均来自 Claude 团队或社区。 +7. **订阅 [订阅](#-subscribe) 章节中的 Reddit 和 YouTube 频道**，紧跟社区动态。 -**🎬 Videos** +**🎬 视频** -Watch on YouTube -Watch on YouTube +在 YouTube 上观看 +在 YouTube 上观看 -**📊 Presentations** +**📊 演示文稿** Claude Code & Gemini CLI — GDG Kolachi

- section divider + 章节分隔符

GitHub Trending
- ✨Trending on Github in March 2026✨ + ✨2026 年 3 月登上 GitHub Trending✨

-## Star History +## Star 历史 [![Star History Chart](https://api.star-history.com/svg?repos=shanraisshan/claude-code-best-practice&type=Date&v=2)](https://star-history.com/#shanraisshan/claude-code-best-practice&Date) -GitHub Stars stars and counting +GitHub Stars stars，还在增长 -## Other Repos +## 其他仓库 @@ -560,22 +566,22 @@ Get the maximum out of this repo by following these steps:
-## Developed by +## 开发者 ![Developed by](!/tags/developed-by.svg) > | # | Workflow | Description | > |---|----------|-------------| -> | 1 | /workflows:development-workflows | Update the DEVELOPMENT WORKFLOWS table and cross-workflow analysis report by researching all 10 workflow repos in parallel | -> | 2 | /workflows:skill-collections | Update the SKILL COLLECTIONS table by researching all 5 skill-collection repos in parallel | -> | 3 | /workflows:agent-collections | Update the AGENT COLLECTIONS table by researching all agent-collection repos in parallel | -> | 4 | /workflows:best-practice:workflow-concepts | Update the README CONCEPTS section with the latest Claude Code features and concepts | -> | 5 | /workflows:best-practice:workflow-claude-settings | Track Claude Code settings report changes and find what needs updating | -> | 6 | /workflows:best-practice:workflow-claude-subagents | Track Claude Code subagents report changes and find what needs updating | -> | 7 | /workflows:best-practice:workflow-claude-commands | Track Claude Code commands report changes and find what needs updating | -> | 8 | /workflows:best-practice:workflow-claude-skills | Track Claude Code skills report changes and find what needs updating | +> | 1 | /workflows:development-workflows | 并行调研全部 10 个 workflow 仓库，更新 DEVELOPMENT WORKFLOWS 表及跨 workflow 分析报告 | +> | 2 | /workflows:skill-collections | 并行调研全部 5 个 skill-collection 仓库，更新 SKILL COLLECTIONS 表 | +> | 3 | /workflows:agent-collections | 并行调研全部 agent-collection 仓库，更新 AGENT COLLECTIONS 表 | +> | 4 | /workflows:best-practice:workflow-concepts | 根据 Claude Code 最新特性与概念，更新 README CONCEPTS 章节 | +> | 5 | /workflows:best-practice:workflow-claude-settings | 跟踪 Claude Code settings 报告变更，找出需要更新的内容 | +> | 6 | /workflows:best-practice:workflow-claude-subagents | 跟踪 Claude Code subagents 报告变更，找出需要更新的内容 | +> | 7 | /workflows:best-practice:workflow-claude-commands | 跟踪 Claude Code commands 报告变更，找出需要更新的内容 | +> | 8 | /workflows:best-practice:workflow-claude-skills | 跟踪 Claude Code skills 报告变更，找出需要更新的内容 | -## Extras +## 附加内容 [![Claude for OSS](!/tags/claude-for-oss.svg)](https://claude.com/contact-sales/claude-for-oss) [![Claude Community Ambassador](!/tags/claude-community-ambassador.svg)](https://claude.com/community/ambassadors) @@ -584,13 +590,13 @@ Get the maximum out of this repo by following these steps: [![Join Claude Pakistan community on WhatsApp](!/tags/whatsapp-claude-pakistan.svg)](https://chat.whatsapp.com/BDUV2stIS0c7X5uY7RY6nS)

- section divider + 章节分隔符

-## Sponsor My Work +## 赞助我的工作 -If you like my work, buy me a doodh patti 🍵 on +如果你喜欢我的作品，可以在以下平台请我喝杯 doodh patti（奶茶）🍵： Polar Polar -**Want your brand in the header?** Header placements are available — email [shanraisshan@gmail.com](mailto:shanraisshan@gmail.com). +**想让你的品牌出现在页眉？** 页眉广告位开放预订 — 请发送邮件至 [shanraisshan@gmail.com](mailto:shanraisshan@gmail.com)。