docs: make Chinese README the default
This commit is contained in:
wehub-resource-sync
@@ -1,91 +1,97 @@
|
||||
<!-- WEHUB_ZH_README -->
|
||||
> [!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 亦如是
|
||||
|
||||
 <a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars"></a><br>
|
||||
 <a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars"></a><br>
|
||||
|
||||
[](best-practice/) [](implementation/) [](orchestration-workflow/orchestration-workflow.md) [](https://code.claude.com/docs) [](#-tips-and-tricks) [](#-subscribe) <br>
|
||||
[](best-practice/) [](implementation/) [](orchestration-workflow/orchestration-workflow.md) [](https://code.claude.com/docs) [](#-tips-and-tricks) [](#-subscribe) <br>
|
||||
<img src="!/tags/a.svg" height="14"> = Agents · <img src="!/tags/c.svg" height="14"> = Commands · <img src="!/tags/s.svg" height="14"> = Skills
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="Claude Code mascot jumping" width="120" height="100"><br>
|
||||
<a href="https://github.com/trending"><img src="!/root/github-trending-day.svg" alt="GitHub Trending #1 Repository Of The Day"></a>
|
||||
<img src="!/claude-jumping.svg" alt="Claude Code 吉祥物跳跃" width="120" height="100"><br>
|
||||
<a href="https://github.com/trending"><img src="!/root/github-trending-day.svg" alt="GitHub 当日热门榜首仓库"></a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="!/root/supported-label.svg" alt="Supported by:" height="34"> <a href="https://disrupt.com/?utm_source=github&utm_campaign=shayan_claude_code_best_practice"><img src="!/root/supported-disrupt.svg" alt="Disrupt.com — Ventures Reimagined" height="34"></a> <a href="https://claudekit.cc/?utm_source=github&utm_medium=sponsorship&utm_campaign=shayan_claude_code_best_practice"><img src="!/root/supported-claudekit.svg" alt="ClaudeKit — Production-ready skills and workflows" height="34"></a>
|
||||
<img src="!/root/supported-label.svg" alt="支持方：" height="34"> <a href="https://disrupt.com/?utm_source=github&utm_campaign=shayan_claude_code_best_practice"><img src="!/root/supported-disrupt.svg" alt="Disrupt.com — Ventures Reimagined" height="34"></a> <a href="https://claudekit.cc/?utm_source=github&utm_medium=sponsorship&utm_campaign=shayan_claude_code_best_practice"><img src="!/root/supported-claudekit.svg" alt="ClaudeKit — 生产就绪的技能与工作流" height="34"></a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img src="!/root/boris-slider.gif" alt="Boris Cherny on Claude Code" width="600"><br>
|
||||
Boris Cherny on X (<a href="https://x.com/bcherny/status/2007179832300581177">tweet 1</a> · <a href="https://x.com/bcherny/status/2017742741636321619">tweet 2</a> · <a href="https://x.com/bcherny/status/2021699851499798911">tweet 3</a>)
|
||||
<img src="!/root/boris-slider.gif" alt="Boris Cherny 谈 Claude Code" width="600"><br>
|
||||
Boris Cherny 在 X 上（<a href="https://x.com/bcherny/status/2007179832300581177">推文 1</a> · <a href="https://x.com/bcherny/status/2017742741636321619">推文 2</a> · <a href="https://x.com/bcherny/status/2021699851499798911">推文 3</a>）
|
||||
</p>
|
||||
|
||||
> [!TIP]
|
||||
> Visit the [**How to Use**](#how-to-use) section to take full advantage of this repo.
|
||||
> 访问 [**如何使用**](#how-to-use) 章节，以充分利用本仓库。
|
||||
|
||||
## 🧠 CONCEPTS
|
||||
## 🧠 概念
|
||||
|
||||
| Feature | Location | Description |
|
||||
| 功能 | 位置 | 说明 |
|
||||
|---------|----------|-------------|
|
||||
| <img src="!/tags/a.svg" height="14"> [**Subagents**](https://code.claude.com/docs/en/sub-agents) | `.claude/agents/<name>.md` | [](best-practice/claude-subagents.md) [](implementation/claude-subagents-implementation.md) |
|
||||
| <img src="!/tags/c.svg" height="14"> [**Commands**](https://code.claude.com/docs/en/slash-commands) | `.claude/commands/<name>.md` | [](best-practice/claude-commands.md) [](implementation/claude-commands-implementation.md) |
|
||||
| <img src="!/tags/s.svg" height="14"> [**Skills**](https://code.claude.com/docs/en/skills) | `.claude/skills/<name>/SKILL.md` | [](best-practice/claude-skills.md) [](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) |
|
||||
| <img src="!/tags/s.svg" height="14"> [**Skills**](https://code.claude.com/docs/en/skills) | `.claude/skills/<name>/SKILL.md` | [](best-practice/claude-skills.md) [](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/orchestration-workflow.md) |
|
||||
| [**Hooks**](https://code.claude.com/docs/en/hooks) | `.claude/hooks/` | [](https://github.com/shanraisshan/claude-code-hooks) [](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/` | [](https://github.com/shanraisshan/claude-code-hooks) [](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/claude-mcp.md) [](.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/claude-settings.md) [](.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/claude-settings.md) [](.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` | [](https://github.com/shanraisshan/claude-code-status-line) [](.claude/settings.json) |
|
||||
| [**Memory**](https://code.claude.com/docs/en/memory) | `CLAUDE.md`, `.claude/rules/`, `~/.claude/rules/`, `~/.claude/projects/<project>/memory/` | [](best-practice/claude-memory.md) [](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/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** | | [](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/<project>/memory/` | [](best-practice/claude-memory.md) [](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/claude-cli-startup-flags.md) [交互模式](https://code.claude.com/docs/en/interactive-mode) · [环境变量](https://code.claude.com/docs/en/env-vars) |
|
||||
| **AI 术语** | | [](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)  | `/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)  | `/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)  | `--channels`, plugin-based | [Reference](https://code.claude.com/docs/en/channels-reference) |
|
||||
| [**Channels**](https://code.claude.com/docs/en/channels)  | `--channels`, 基于插件 | [参考](https://code.claude.com/docs/en/channels-reference) |
|
||||
| [**Ultraplan**](https://code.claude.com/docs/en/ultraplan)  | `/ultraplan` | |
|
||||
| [**No Flicker Mode**](https://code.claude.com/docs/en/fullscreen)  | `/tui fullscreen`, `CLAUDE_CODE_NO_FLICKER=1` | [](https://x.com/bcherny/status/2039421575422980329) |
|
||||
| [**Auto Mode**](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode)  | `--permission-mode auto`, `Shift+Tab` | [](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)  | `--permission-mode auto`, `Shift+Tab` | [](https://x.com/claudeai/status/2036503582166393240) [博客](https://claude.com/blog/auto-mode) |
|
||||
| [**Power-ups**](best-practice/claude-power-ups.md) | `/powerup` | [](best-practice/claude-power-ups.md) |
|
||||
| [**Fast Mode**](https://code.claude.com/docs/en/fast-mode)  | `/fast`, `"fastMode": true` | |
|
||||
| [**Advisor**](https://code.claude.com/docs/en/advisor)  | `/advisor`, `advisorModel`, `--advisor` | [Blog](https://claude.com/blog/the-advisor-strategy) |
|
||||
| [**Computer Use**](https://code.claude.com/docs/en/computer-use)  | `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)  | `/advisor`, `advisorModel`, `--advisor` | [博客](https://claude.com/blog/the-advisor-strategy) |
|
||||
| [**Computer Use**](https://code.claude.com/docs/en/computer-use)  | `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 | [](https://github.com/ghuntley/how-to-ralph-wiggum) [](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) |
|
||||
| [**Chrome**](https://code.claude.com/docs/en/chrome) | `--chrome`, extension | [](reports/claude-in-chrome-v-chrome-devtools-mcp.md) |
|
||||
| [**Claude Code Web**](https://code.claude.com/docs/en/claude-code-on-the-web)  | `claude.ai/code` | [Routines](https://code.claude.com/docs/en/routines) |
|
||||
| [**Artifacts**](https://code.claude.com/docs/en/artifacts)  | `/share`, `Artifact` tool | |
|
||||
| [**Slack**](https://code.claude.com/docs/en/slack) | `@Claude` in Slack | |
|
||||
| [**Code Review**](https://code.claude.com/docs/en/code-review)  | GitHub App (managed) | [](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)  | GitHub App (managed) | [](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` | [](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` | [](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)  | built-in (env var) | [](https://x.com/bcherny/status/2019472394696683904) [](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)  | 内置（环境变量） | [](https://x.com/bcherny/status/2019472394696683904) [](implementation/claude-agent-teams-implementation.md) |
|
||||
| [**Agent View**](https://code.claude.com/docs/en/agent-view)  | `claude agents`, `--bg`, `/bg` | |
|
||||
| [**Scheduled Tasks**](https://code.claude.com/docs/en/scheduled-tasks) | `/loop`, `/schedule`, cron tools | [](https://x.com/bcherny/status/2030193932404150413) [](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)  | `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/` | [](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 | [](https://x.com/bcherny/status/2030193932404150413) [](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)  | `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/` | [](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 <condition>`, `/goal clear` | [](implementation/claude-goal-implementation.md) |
|
||||
| [**Voice Dictation**](https://code.claude.com/docs/en/voice-dictation)  | `/voice` | [](https://x.com/trq212/status/2028628570692890800) |
|
||||
| [**Bundled Skills**](https://code.claude.com/docs/en/skills#bundled-skills) | `/code-review`, `/batch` | [](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 | [](https://x.com/bcherny/status/2025007393290272904) |
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
<a id="orchestration-workflow"></a>
|
||||
|
||||
## <a href="orchestration-workflow/orchestration-workflow.md"><img src="!/tags/orchestration-workflow-hd.svg" alt="Orchestration Workflow"></a>
|
||||
|
||||
See [orchestration-workflow](orchestration-workflow/orchestration-workflow.md) for implementation details of <img src="!/tags/c.svg" height="14"> **Command** → <img src="!/tags/a.svg" height="14"> **Agent** → <img src="!/tags/s.svg" height="14"> **Skill** pattern.
|
||||
请参阅 [orchestration-workflow](orchestration-workflow/orchestration-workflow.md) 了解 <img src="!/tags/c.svg" height="14"> **Command**（命令）→ <img src="!/tags/a.svg" height="14"> **Agent**（智能体）→ <img src="!/tags/s.svg" height="14"> **Skill**（技能）模式的实现细节。
|
||||
|
||||
|
||||
<p align="center">
|
||||
@@ -104,14 +110,14 @@ claude
|
||||
```
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## ⚙️ DEVELOPMENT WORKFLOWS
|
||||
## ⚙️ 开发工作流
|
||||
|
||||
All major workflows converge on the same architectural pattern: **Research → Plan → Execute → Review → Ship**
|
||||
所有主要工作流都汇聚于同一架构模式：**调研（Research）→ 规划（Plan）→ 执行（Execute）→ 审查（Review）→ 交付（Ship）**
|
||||
|
||||
| Name | ★ | Workflow | <img src="!/tags/a.svg" height="14"> | <img src="!/tags/c.svg" height="14"> | <img src="!/tags/s.svg" height="14"> |
|
||||
| 名称 | ★ | 工作流 | <img src="!/tags/a.svg" height="14"> | <img src="!/tags/c.svg" height="14"> | <img src="!/tags/s.svg" height="14"> |
|
||||
|------|---|----------|---|---|---|
|
||||
| [Superpowers](https://github.com/obra/superpowers) | 253k | <img src="https://img.shields.io/badge/brainstorming-ddf4ff" alt="brainstorming" align="middle"> → <img src="https://img.shields.io/badge/using--git--worktrees-ddf4ff" alt="using-git-worktrees" align="middle"> → <img src="https://img.shields.io/badge/writing--plans-ddf4ff" alt="writing-plans" align="middle"> → <img src="https://img.shields.io/badge/subagent--driven--development-ddf4ff" alt="subagent-driven-development" align="middle"> → <img src="https://img.shields.io/badge/dispatching--parallel--agents-fff3b0" alt="dispatching-parallel-agents" align="middle"> → <img src="https://img.shields.io/badge/executing--plans-fff3b0" alt="executing-plans" align="middle"> → <img src="https://img.shields.io/badge/test--driven--development-fff3b0" alt="test-driven-development" align="middle"> → <img src="https://img.shields.io/badge/verification--before--completion-fff3b0" alt="verification-before-completion" align="middle"> → <img src="https://img.shields.io/badge/requesting--code--review-ddf4ff" alt="requesting-code-review" align="middle"> → <img src="https://img.shields.io/badge/finishing--a--development--branch-ddf4ff" alt="finishing-a-development-branch" align="middle"> | 0 | 0 | 14 |
|
||||
| [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) | 229k | <img src="https://img.shields.io/badge/plan-ddf4ff" alt="plan" align="middle"> → <img src="https://img.shields.io/badge/plan--prd-ddf4ff" alt="plan-prd" align="middle"> → <img src="https://img.shields.io/badge/prp--implement-fff3b0" alt="prp-implement" align="middle"> → <img src="https://img.shields.io/badge/code--review-fff3b0" alt="code-review" align="middle"> → <img src="https://img.shields.io/badge/build--fix-fff3b0" alt="build-fix" align="middle"> → <img src="https://img.shields.io/badge/e2e--testing-ddf4ff" alt="e2e-testing" align="middle"> → <img src="https://img.shields.io/badge/prp--pr-ddf4ff" alt="prp-pr" align="middle"> | 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 | <img src="https://img.shields.io/badge/%2Fce--brainstorm-ddf4ff" alt="/ce-brainstorm" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--plan-ddf4ff" alt="/ce-plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--work-ddf4ff" alt="/ce-work" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--simplify--code-fff3b0" alt="/ce-simplify-code" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--code--review-ddf4ff" alt="/ce-code-review" align="middle"> → <img src="https://img.shields.io/badge/%2Fce--compound-ddf4ff" alt="/ce-compound" align="middle"> | 0 | 1 | 30 |
|
||||
| [HumanLayer](https://github.com/humanlayer/humanlayer) | 11k | <img src="https://img.shields.io/badge/%2Fralph__research-fff3b0" alt="/ralph_research" align="middle"> → <img src="https://img.shields.io/badge/%2Fcreate__plan-ddf4ff" alt="/create_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fiterate__plan-fff3b0" alt="/iterate_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fvalidate__plan-ddf4ff" alt="/validate_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fimplement__plan-ddf4ff" alt="/implement_plan" align="middle"> → <img src="https://img.shields.io/badge/%2Fdescribe__pr-ddf4ff" alt="/describe_pr" align="middle"> → <img src="https://img.shields.io/badge/%2Fcommit-ddf4ff" alt="/commit" align="middle"> | 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) [](development-workflows/rpi/rpi-workflow.md)
|
||||
- [Ralph Wiggum Loop](https://www.youtube.com/watch?v=eAtvoGlpeRU) [](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) [](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) [](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) [](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) [](https://x.com/trq212)
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## 🔀 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) [](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) [](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 工具调用 |
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## 🧰 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 | ★ | <img src="!/tags/s.svg" height="14"> |
|
||||
| 名称 | ★ | <img src="!/tags/s.svg" height="14"> |
|
||||
|------|---|---|
|
||||
| [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 |
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## 🤖 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 | ★ | <img src="!/tags/a.svg" height="14"> |
|
||||
| 名称 | ★ | <img src="!/tags/a.svg" height="14"> |
|
||||
|------|---|---|
|
||||
| [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 |
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## 💡 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)
|
||||
|
||||
|
||||
|
||||
<a id="tips-prompting"></a>■ **Prompting (3)**
|
||||
<a id="tips-prompting"></a>■ **提示词（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 🚫👶 | [](https://x.com/bcherny/status/2017742752566632544) |
|
||||
| after a mediocre fix — "knowing everything you know now, scrap this and implement the elegant solution" 🚫👶 | [](https://x.com/bcherny/status/2017742752566632544) |
|
||||
| Claude fixes most bugs by itself — paste the bug, say "fix", don't micromanage how 🚫👶 | [](https://x.com/bcherny/status/2017742750473720121) |
|
||||
| 挑战 Claude——「就这些改动拷问我，等我通过你的测试再提 PR。」或「向我证明这能跑通」，让 Claude 对比 main 与你的分支差异 🚫👶 | [](https://x.com/bcherny/status/2017742752566632544) |
|
||||
| 平庸修复之后——「以你现在掌握的全部信息，扔掉这套，实现更优雅的方案」🚫👶 | [](https://x.com/bcherny/status/2017742752566632544) |
|
||||
| Claude 大多能自行修 bug——粘贴 bug，说「fix」，别微观管理做法 🚫👶 | [](https://x.com/bcherny/status/2017742750473720121) |
|
||||
|
||||
<a id="tips-planning"></a>■ **Planning/Specs (7)**
|
||||
<a id="tips-planning"></a>■ **规划/规格（Planning/Specs）（7）**
|
||||
|
||||
| Tip | Source |
|
||||
| 技巧 | 来源 |
|
||||
|-----|--------|
|
||||
| always start with [plan mode](https://code.claude.com/docs/en/common-workflows) | [](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 | [](https://x.com/trq212/status/2005315275026260309) |
|
||||
| always make a phase-wise gated plan, with each phase having multiple tests (unit, automation, integration) | [](videos/claude-dex-mlops-community-24-mar-26.md) [](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 🚫👶 | [](videos/claude-matt-pocock-24-apr-26.md) [](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 | [](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 | [](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 | [](https://youtu.be/julbw1JuAz0?t=3630) [](https://youtu.be/julbw1JuAz0?t=3630) |
|
||||
| 始终从 [plan mode](https://code.claude.com/docs/en/common-workflows) 开始 | [](https://x.com/bcherny/status/2007179845336527000) |
|
||||
| 从最小规格或提示词起步，让 Claude 用 [AskUserQuestion](https://code.claude.com/docs/en/cli-reference) 工具向你提问，再开新会话执行规格 | [](https://x.com/trq212/status/2005315275026260309) |
|
||||
| 始终制定分阶段门禁式计划，每阶段含多项测试（单元、自动化、集成） | [](videos/claude-dex-mlops-community-24-mar-26.md) [](https://youtu.be/YwZR6tc7qYg?t=1032) |
|
||||
| 将 PRD 拆成贯穿各层的垂直切片（tracer bullets）（DB + 服务 + UI）——AI 默认横向分阶段（先 DB、再 API、再前端），端到端反馈会拖到最后。出自《程序员修炼之道》🚫👶 | [](videos/claude-matt-pocock-24-apr-26.md) [](https://youtu.be/-QFHIoCo-Ko) |
|
||||
| 再起一个 Claude 以 staff engineer 视角审计划，或用 [cross-model](development-workflows/cross-model-workflow/cross-model-workflow.md) 做审查 | [](https://x.com/bcherny/status/2017742745365057733) |
|
||||
| 交接前写清规格、减少歧义——越具体，产出越好 | [](https://x.com/bcherny/status/2017742752566632544) |
|
||||
| 原型 > PRD——多搭 20-30 版，少写规格；构建成本低，多试几枪 | [](https://youtu.be/julbw1JuAz0?t=3630) [](https://youtu.be/julbw1JuAz0?t=3630) |
|
||||
|
||||
<a id="tips-context"></a>■ **Context (5)**
|
||||
<a id="tips-context"></a>■ **上下文（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 | [](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 | [](videos/claude-dex-mlops-community-24-mar-26.md) [](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 🚫👶 | [](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 | [](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 🚫👶 | [](tips/claude-thariq-tips-16-apr-26.md) |
|
||||
| 在 1M 上下文模型上，上下文衰减（context rot）大约在 ~300-400k tokens 时开始显现 — 对智能敏感的工作不要让会话超过这个范围 | [](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) 来重置 | [](videos/claude-dex-mlops-community-24-mar-26.md) [](https://youtu.be/YwZR6tc7qYg?t=1541) |
|
||||
| 回退优于纠错 — 双击 Esc 或 [/rewind](https://code.claude.com/docs/en/checkpointing) 回到失败尝试之前，用你学到的东西重新提示，而不是让失败尝试 + 纠正污染上下文 🚫👶 | [](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 自动触发 — 因上下文衰减而自动压缩时，模型处于最不智能的状态 | [](tips/claude-thariq-tips-16-apr-26.md) |
|
||||
| 用 subagents 做上下文管理 — 问自己"我还会需要这份工具输出，还是只要结论？" — 20 次文件读取 + 12 次 grep + 3 次死胡同留在子代理的上下文中，只返回最终报告 🚫👶 | [](tips/claude-thariq-tips-16-apr-26.md) |
|
||||
|
||||
<a id="tips-session"></a>■ **Session Management (6)**
|
||||
<a id="tips-session"></a>■ **会话管理（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 | [](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 | [](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 | [](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) | [](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 | [](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 | [](https://every.to/podcast/how-to-use-claude-code-like-the-people-who-built-it) |
|
||||
| 每一轮都是一个分支点 — Claude 结束一轮后，根据你需要携带多少现有上下文，在 Continue、/rewind、/clear、/compact 或 Subagent 之间选择 | [](tips/claude-thariq-tips-16-apr-26.md) |
|
||||
| 新任务 = 新会话 — 相关任务（例如为你刚构建的内容写文档）可以复用上下文以提高效率，但真正的新任务值得开一个新会话 | [](tips/claude-thariq-tips-16-apr-26.md) |
|
||||
| 回退前使用 "summarize from here" 让 Claude 写一份交接消息 — 像是来自未来自己的、写给上一版 Claude 的便条 | [](tips/claude-thariq-tips-16-apr-26.md) |
|
||||
| /compact 对比 /clear — compact 有损但利于保持势头（任务中途、模糊细节可接受）；/clear + brief 更费力但你能精确控制什么被带过去（高风险的下一步） | [](tips/claude-thariq-tips-16-apr-26.md) |
|
||||
| 对长期会话使用 recaps — Claude 做了什么以及下一步是什么的简短摘要，在隔几分钟或几小时后回来时很有用。在 /config 中用 recaps 可禁用 | [](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 时为每个实例加标签 | [](https://every.to/podcast/how-to-use-claude-code-like-the-people-who-built-it) |
|
||||
|
||||
<a id="tips-claudemd"></a>■ **CLAUDE.md + .claude/rules (8)**
|
||||
<a id="tips-claudemd"></a>■ **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/)) | [](https://x.com/bcherny/status/2007179840848597422) [](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 | [](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) |
|
||||
| wrap domain-specific CLAUDE.md rules in [\<important if="..."\> tags](https://www.hlyr.dev/blog/stop-claude-from-ignoring-your-claude-md) to stop Claude from ignoring them as files grow longer | [](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 | [](https://x.com/bcherny/status/2016339448863355206) |
|
||||
| use [.claude/rules/](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) to split large instructions | [](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 | [](https://x.com/dexhorthy/status/2034713765401551053) |
|
||||
| keep codebases clean and finish migrations — partially migrated frameworks confuse models that might pick the wrong pattern | [](https://youtu.be/julbw1JuAz0?t=1112) [](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 | [](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/)) | [](https://x.com/bcherny/status/2007179840848597422) [](https://www.humanlayer.dev/blog/writing-a-good-claude-md) |
|
||||
| .claude/rules/*.md 像 CLAUDE.md 一样自动加载到每个会话 — 添加 paths: YAML frontmatter，仅在 Claude 接触到匹配 glob 的文件时才懒加载 | [](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) |
|
||||
| 将领域特定的 CLAUDE.md 规则包在 [\<important if="..."\> tags](https://www.hlyr.dev/blog/stop-claude-from-ignoring-your-claude-md) 中，防止文件变长后 Claude 忽略它们 | [](https://www.hlyr.dev/blog/stop-claude-from-ignoring-your-claude-md) |
|
||||
| 对 monorepos 使用 [多个 CLAUDE.md](best-practice/claude-memory.md) — 祖先 + 后代加载 | [](https://x.com/bcherny/status/2016339448863355206) |
|
||||
| 用 [.claude/rules/](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) 拆分大型指令 | [](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules) |
|
||||
| 任何开发者都应能启动 Claude，说 "run the tests" 并在第一次就成功 — 如果不行，你的 CLAUDE.md 缺少必要的 setup/build/test 命令 | [](https://x.com/dexhorthy/status/2034713765401551053) |
|
||||
| 保持代码库整洁并完成迁移 — 部分迁移的框架会让模型困惑，可能选错模式 | [](https://youtu.be/julbw1JuAz0?t=1112) [](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 中 | [](https://x.com/dani_avila7/status/2036182734310195550) |
|
||||
|
||||
<a id="tips-agents"></a><img src="!/tags/a.svg" height="14"> **Agents (4)**
|
||||
<a id="tips-agents"></a><img src="!/tags/a.svg" height="14"> **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 | [](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 🚫👶 | [](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 | [](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 | [](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 | [](https://x.com/bcherny/status/2007179850139000872) |
|
||||
| 说 "use subagents" 以投入更多算力解决问题 — 卸载任务以保持主上下文干净、专注 🚫👶 | [](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) 用于并行开发 | [](https://x.com/bcherny/status/2025007393290272904) |
|
||||
| 使用 [test time compute](https://code.claude.com/docs/en/sub-agents) — 独立的上下文窗口让结果更好；一个代理可能引入 bug，另一个（同一模型）能发现它们 | [](https://x.com/bcherny/status/2031151689219321886) |
|
||||
|
||||
<a id="tips-commands"></a><img src="!/tags/c.svg" height="14"> **Commands (3)**
|
||||
<a id="tips-commands"></a><img src="!/tags/c.svg" height="14"> **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) | [](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 | [](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 | [](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) | [](https://x.com/bcherny/status/2007179847949500714) |
|
||||
| 对你每天多次执行的每个"内循环（inner loop）"工作流使用 [slash commands](https://code.claude.com/docs/en/slash-commands) — 避免重复提示，命令放在 .claude/commands/ 并纳入 git | [](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 命令 | [](https://x.com/bcherny/status/2017742748984742078) |
|
||||
|
||||
<a id="tips-skills"></a><img src="!/tags/s.svg" height="14"> **Skills (9)**
|
||||
<a id="tips-skills"></a><img src="!/tags/s.svg" height="14"> **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 | [](https://x.com/lydiahallie/status/2033603164398883042) |
|
||||
| use [skills in subfolders](reports/claude-skills-for-larger-mono-repos.md) for monorepos | [](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) | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| build a Gotchas section in every skill — highest-signal content, add Claude's failure points over time | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| skill description field is a trigger, not a summary — write it for the model ("when should I fire?") | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| don't state the obvious in skills — focus on what pushes Claude out of its default behavior 🚫👶 | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| don't railroad Claude in skills — give goals and constraints, not prescriptive step-by-step instructions 🚫👶 | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| include scripts and libraries in skills so Claude composes rather than reconstructs boilerplate | [](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 | [](https://x.com/lydiahallie/status/2034337963820327017) |
|
||||
| 使用 [context: fork](https://code.claude.com/docs/en/skills) 在隔离的子代理中运行 skill — 主上下文只能看到最终结果，看不到中间工具调用。`agent` 字段可用来设置子代理类型 | [](https://x.com/lydiahallie/status/2033603164398883042) |
|
||||
| 在 monorepo 中使用[子文件夹中的 skills](reports/claude-skills-for-larger-mono-repos.md) | [](https://code.claude.com/docs/en/skills) |
|
||||
| skills 是文件夹而非文件 — 使用 references/、scripts/、examples/ 子目录实现[渐进式披露（progressive disclosure）](https://code.claude.com/docs/en/skills) | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| 在每个 skill 中构建 Gotchas（常见陷阱）部分 — 这是信号最强的内容，可随时间补充 Claude 的失败点 | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| skill 的 description 字段是触发器而非摘要 — 写给模型看（「何时应触发？」） | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| 不要在 skills 里陈述显而易见的内容 — 聚焦能推动 Claude 偏离默认行为的内容 🚫👶 | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| 不要在 skills 中强行约束 Claude 的执行路径 — 给出目标与约束，而非规定性的逐步指令 🚫👶 | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| 在 skills 中包含 scripts 与 libraries，让 Claude 组合复用而非重新拼凑样板代码 | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| 在 SKILL.md 中嵌入 !command，将动态 shell 输出注入 prompt — Claude 在调用时执行它，模型只看到结果 | [](https://x.com/lydiahallie/status/2034337963820327017) |
|
||||
|
||||
<a id="tips-hooks"></a>■ **Hooks (5)**
|
||||
<a id="tips-hooks"></a>■ **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 | [](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 | [](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 | [](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 🚫👶 | [](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 | [](https://x.com/bcherny/status/2021701059253874861) |
|
||||
| 在 skills 中使用[按需 hooks](https://code.claude.com/docs/en/skills) — /careful 会拦截破坏性命令，/freeze 会拦截目录外的编辑 | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| 用 PreToolUse hook [衡量 skill 使用情况](https://code.claude.com/docs/en/skills)，以发现热门或触发不足的 skills | [](https://x.com/trq212/status/2033949937936085378) |
|
||||
| 使用 [PostToolUse hook](https://code.claude.com/docs/en/hooks) 自动格式化代码 — Claude 会生成格式良好的代码，hook 负责最后 10%，避免 CI 失败 | [](https://x.com/bcherny/status/2007179852047335529) |
|
||||
| 通过 hook 将[权限请求](https://code.claude.com/docs/en/hooks) 路由到 Opus — 让它扫描攻击并自动批准安全的请求 🚫👶 | [](https://x.com/bcherny/status/2017742755737555434) |
|
||||
| 使用 [Stop hook](https://code.claude.com/docs/en/hooks)，在一轮结束时推动 Claude 继续或验证其工作 | [](https://x.com/bcherny/status/2021701059253874861) |
|
||||
|
||||
<a id="tips-workflows"></a>■ **Workflows (5)**
|
||||
<a id="tips-workflows"></a>■ **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 | [](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 | [](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) | [](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) | [](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) | [](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，兼顾两者优势 | [](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 的决策 | [](https://x.com/bcherny/status/2007179838864666847) |
|
||||
| 在 prompt 中使用 ultrathink 关键词以启用[高投入推理](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking#tips-and-best-practices) | [](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking#tips-and-best-practices) |
|
||||
| /focus 模式会隐藏所有中间工作，仅显示最终结果 — 信任模型会执行正确命令，你只需看结果（用 /focus 切换） | [](tips/claude-boris-6-tips-16-apr-26.md) |
|
||||
| 用 Opus 4.7 的自适应 thinking 调节投入程度 — low 更快、token 更少，max 智力最高（滑块：low · medium · high · xhigh · max） | [](tips/claude-boris-6-tips-16-apr-26.md) |
|
||||
|
||||
<a id="tips-workflows-advanced"></a>■ **Workflows Advanced (9)**
|
||||
<a id="tips-workflows-advanced"></a>■ **Workflows Advanced（9）**
|
||||
|
||||
| Tip | Source |
|
||||
| 技巧 | 来源 |
|
||||
|-----|--------|
|
||||
| use ASCII diagrams a lot to understand your architecture | [](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 | [](https://x.com/bcherny/status/2038454341884154269) |
|
||||
| use [Ralph Wiggum plugin](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) for long-running autonomous tasks | [](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 | [](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 | [](https://x.com/bcherny/status/2021700506465579443) [](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 | [](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 🚫👶 | [](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) | [](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 🚫👶 | [](tips/claude-boris-6-tips-16-apr-26.md) |
|
||||
| 大量使用 ASCII 图来理解你的架构 | [](https://x.com/bcherny/status/2017742759218794768) |
|
||||
| 用 [/loop](https://code.claude.com/docs/en/scheduled-tasks) 做本地周期性监控（最长 7 天）· 用 [/schedule](https://code.claude.com/docs/en/routines) 做云端周期性任务，即使机器关机也会运行 | [](https://x.com/bcherny/status/2038454341884154269) |
|
||||
| 使用 [Ralph Wiggum plugin](https://github.com/shanraisshan/ralph-wiggum-self-evolving-loop) 处理长时间自主任务 | [](https://x.com/bcherny/status/2007179858435281082) |
|
||||
| 用 [/permissions](https://code.claude.com/docs/en/permissions) 搭配通配符语法（Bash(npm run *)、Edit(/docs/**)），而不是 dangerously-skip-permissions | [](https://x.com/bcherny/status/2007179854077407667) |
|
||||
| 用 [/sandbox](https://code.claude.com/docs/en/sandboxing) 通过文件与网络隔离减少权限提示 — 内部减少 84% | [](https://x.com/bcherny/status/2021700506465579443) [](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）— 值得花一周时间打磨 | [](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 模式间切换 🚫👶 | [](tips/claude-boris-6-tips-16-apr-26.md) |
|
||||
| 使用 /less-permission-prompts skill 扫描会话历史，找出反复提示的安全 bash/MCP 命令，然后获取推荐 allowlist 并粘贴到 [settings](best-practice/claude-settings.md) | [](tips/claude-boris-6-tips-16-apr-26.md) |
|
||||
| 构建 /go skill，(1) 通过 bash/browser/computer use 做端到端测试 (2) 运行 /simplify (3) 提交 PR — 这样你回来时就能确认代码可用 🚫👶 | [](tips/claude-boris-6-tips-16-apr-26.md) |
|
||||
|
||||
<a id="tips-git-pr"></a>■ **Git / PR (5)**
|
||||
<a id="tips-git-pr"></a>■ **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 | [](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 | [](https://x.com/bcherny/status/2038552880018538749) |
|
||||
| commit often — try to commit at least once per hour, as soon as task is completed, commit |  |
|
||||
| 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 🚫👶 | [](https://youtu.be/julbw1JuAz0?t=2715) [](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 | [](https://x.com/bcherny/status/2031089411820228645) |
|
||||
| 保持 PR 小而聚焦 — [p50 为 118 行](tips/claude-boris-2-tips-25-mar-26.md)（一天 141 个 PR、变更 45K 行），每个 PR 一个功能，更易审查和回滚 | [](https://x.com/bcherny/status/2038552880018538749) |
|
||||
| 始终对 PR 使用 [squash merge](tips/claude-boris-2-tips-25-mar-26.md) — 保持干净的线性历史，每个功能一个提交，便于 git revert 和 git bisect | [](https://x.com/bcherny/status/2038552880018538749) |
|
||||
| 频繁提交 — 尽量每小时至少提交一次，任务一完成就提交 |  |
|
||||
| 在同事的 PR 上标注 [@claude](https://github.com/apps/claude)，为反复出现的评审反馈自动生成 lint 规则 — 把自己从代码评审中自动化掉 🚫👶 | [](https://youtu.be/julbw1JuAz0?t=2715) [](https://youtu.be/julbw1JuAz0?t=2715) |
|
||||
| 使用 [/code-review](https://code.claude.com/docs/en/code-review) 进行多代理 PR 分析 — 在合并前捕获 bug、安全漏洞和回归 | [](https://x.com/bcherny/status/2031089411820228645) |
|
||||
|
||||
<a id="tips-debugging"></a>■ **Debugging (6)**
|
||||
<a id="tips-debugging"></a>■ **调试（6）**
|
||||
|
||||
| Tip | Source |
|
||||
| 技巧 | 来源 |
|
||||
|-----|--------|
|
||||
| make it a habit to take screenshots and share with Claude whenever you are stuck with any issue |  |
|
||||
| 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 | [](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 |  |
|
||||
| [/doctor](https://code.claude.com/docs/en/cli-reference) to diagnose installation, authentication, and configuration issues |  |
|
||||
| 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 |  |
|
||||
| agentic search (glob + grep) beats RAG — Claude Code tried and discarded vector databases because code drifts out of sync and permissions are complex | [](https://youtu.be/julbw1JuAz0?t=3095) [](https://youtu.be/julbw1JuAz0?t=3095) |
|
||||
| 养成习惯：遇到任何问题时截图并分享给 Claude |  |
|
||||
| 使用 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 控制台日志 | [](https://code.claude.com/docs/en/chrome) |
|
||||
| 始终让 Claude 将你希望查看日志的终端以后台任务方式运行，以便更好地调试 |  |
|
||||
| 使用 [/doctor](https://code.claude.com/docs/en/cli-reference) 诊断安装、认证与配置问题 |  |
|
||||
| 采用 [cross-model](development-workflows/cross-model-workflow/cross-model-workflow.md)（跨模型）工作流做 QA——例如用 [Codex](https://github.com/shanraisshan/codex-cli-best-practice) 做计划与实现评审 |  |
|
||||
| 智能体搜索（glob + grep）优于 RAG——Claude Code 曾尝试向量数据库后弃用，因为代码会脱节且权限复杂 | [](https://youtu.be/julbw1JuAz0?t=3095) [](https://youtu.be/julbw1JuAz0?t=3095) |
|
||||
|
||||
<a id="tips-utilities"></a>■ **Utilities (5)**
|
||||
<a id="tips-utilities"></a>■ **实用工具（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/)) | [](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) | [](https://x.com/bcherny/status/2038454362226467112) |
|
||||
| [claude-code-hooks](https://github.com/shanraisshan/claude-code-hooks) for claude feedback |  |
|
||||
| [status line](https://github.com/shanraisshan/claude-code-status-line) for context awareness and fast compacting | [](https://x.com/bcherny/status/2021700784019452195)  |
|
||||
| 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 | [](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/)) | [](https://x.com/bcherny/status/2017742753971769626) |
|
||||
| 使用 [/voice](https://code.claude.com/docs/en/voice-dictation) 或 [Wispr Flow](https://wisprflow.ai) 进行语音提示（10 倍生产力） | [](https://x.com/bcherny/status/2038454362226467112) |
|
||||
| 使用 [claude-code-hooks](https://github.com/shanraisshan/claude-code-hooks) 获取 Claude 反馈 |  |
|
||||
| 使用 [status line](https://github.com/shanraisshan/claude-code-status-line) 提升上下文感知并快速压缩 | [](https://x.com/bcherny/status/2021700784019452195)  |
|
||||
| 探索 [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)，以获得个性化体验 | [](https://x.com/bcherny/status/2021701145023197516) |
|
||||
|
||||
<a id="tips-daily"></a>■ **Daily (2)**
|
||||
<a id="tips-daily"></a>■ **日常（2）**
|
||||
|
||||
| Tip | Source |
|
||||
| 技巧 | 来源 |
|
||||
|-----|--------|
|
||||
| [update](https://code.claude.com/docs/en/setup) Claude Code daily |  |
|
||||
| start your day by reading the [changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) |  |
|
||||
| 每日 [update](https://code.claude.com/docs/en/setup) Claude Code |  |
|
||||
| 每天从阅读 [changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) 开始 |  |
|
||||
|
||||
|
||||
|
||||
| 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)
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## 🎬 VIDEOS / PODCASTS
|
||||
## 🎬 视频 / 播客
|
||||
|
||||
| Video / Podcast | Source | YouTube |
|
||||
| 视频 / 播客 | 来源 | YouTube |
|
||||
|-----------------|--------|--------|
|
||||
| From Vibe Coding to Agentic Engineering (Andrej) \| 02 May 2026 \| AI Engineer | [](https://x.com/karpathy) | [YouTube](https://www.youtube.com/watch?v=96jN2OCOfLs) |
|
||||
| Full Walkthrough: Workflow for AI Coding (Matt) \| 24 Apr 2026 \| Matt Pocock | [](https://x.com/mattpocockuk) | [YouTube](https://youtu.be/-QFHIoCo-Ko) |
|
||||
| Everything We Got Wrong About Research-Plan-Implement (Dex) \| 24 Mar 2026 \| MLOps Community | [](https://x.com/daborhyde) | [YouTube](https://youtu.be/YwZR6tc7qYg) |
|
||||
| Building Claude Code with Boris Cherny (Boris) \| 04 Mar 2026 \| The Pragmatic Engineer | [](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 | [](https://x.com/bcherny) | [YouTube](https://youtu.be/We7BZVKbCVw) |
|
||||
| Inside Claude Code With Its Creator Boris Cherny (Boris) \| 17 Feb 2026 \| Y Combinator | [](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 | [](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 | [](https://x.com/bcherny) | [YouTube](https://youtu.be/IDSAMqip6ms) |
|
||||
| 从 Vibe Coding 到智能体工程（Andrej）| 02 May 2026 | AI Engineer | [](https://x.com/karpathy) | [YouTube](https://www.youtube.com/watch?v=96jN2OCOfLs) |
|
||||
| 完整演练：AI 编程工作流（Matt）| 24 Apr 2026 | Matt Pocock | [](https://x.com/mattpocockuk) | [YouTube](https://youtu.be/-QFHIoCo-Ko) |
|
||||
| 我们对 Research-Plan-Implement 的所有误解（Dex）| 24 Mar 2026 | MLOps Community | [](https://x.com/daborhyde) | [YouTube](https://youtu.be/YwZR6tc7qYg) |
|
||||
| 与 Boris Cherny 一起构建 Claude Code（Boris）| 04 Mar 2026 | The Pragmatic Engineer | [](https://x.com/bcherny) | [YouTube](https://youtu.be/julbw1JuAz0) |
|
||||
| Claude Code 负责人：编码问题解决之后会怎样（Boris）| 19 Feb 2026 | Lenny's Podcast | [](https://x.com/bcherny) | [YouTube](https://youtu.be/We7BZVKbCVw) |
|
||||
| 走进 Claude Code：与其创造者 Boris Cherny 对话（Boris）| 17 Feb 2026 | Y Combinator | [](https://x.com/bcherny) | [YouTube](https://youtu.be/PQU9o_5rHC4) |
|
||||
| Boris Cherny（Claude Code 创造者）谈职业生涯如何成长（Boris）| 15 Dec 2025 | Ryan Peterman | [](https://x.com/bcherny) | [YouTube](https://youtu.be/AmdLVWMdjOk) |
|
||||
| Claude Code 的秘密：来自构建它的工程师们（Cat）| 29 Oct 2025 | Every | [](https://x.com/bcherny) | [YouTube](https://youtu.be/IDSAMqip6ms) |
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## 🔔 SUBSCRIBE
|
||||
## 🔔 订阅
|
||||
|
||||
| Source | Name | Badge |
|
||||
| 来源 | 名称 | 徽章 |
|
||||
|--------|------|-------|
|
||||
|  | [r/ClaudeAI](https://www.reddit.com/r/ClaudeAI/), [r/ClaudeCode](https://www.reddit.com/r/ClaudeCode/), [r/Anthropic](https://www.reddit.com/r/Anthropic/) |  |
|
||||
|  | [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) |  |
|
||||
@@ -420,9 +426,9 @@ Repos primarily known as curated libraries of subagent definitions (`.claude/age
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## ☠️ 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/))|
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
</p>
|
||||
|
||||
<a id="billion-dollar-questions"></a>
|
||||
|
||||
|
||||
|
||||
*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)
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## REPORTS
|
||||
## 报告
|
||||
|
||||
<p align="center">
|
||||
<a href="reports/claude-agent-sdk-vs-cli-system-prompts.md"><img src="https://img.shields.io/badge/Agent_SDK_vs_CLI-555?style=for-the-badge" alt="Agent SDK vs CLI"></a>
|
||||
<a href="reports/claude-in-chrome-v-chrome-devtools-mcp.md"><img src="https://img.shields.io/badge/Browser_Automation_MCP-555?style=for-the-badge" alt="Browser Automation MCP"></a>
|
||||
<a href="reports/claude-global-vs-project-settings.md"><img src="https://img.shields.io/badge/Global_vs_Project_Settings-555?style=for-the-badge" alt="Global vs Project Settings"></a>
|
||||
<a href="reports/claude-skills-for-larger-mono-repos.md"><img src="https://img.shields.io/badge/Skills_in_Monorepos-555?style=for-the-badge" alt="Skills in Monorepos"></a>
|
||||
<a href="reports/claude-in-chrome-v-chrome-devtools-mcp.md"><img src="https://img.shields.io/badge/Browser_Automation_MCP-555?style=for-the-badge" alt="浏览器自动化 MCP"></a>
|
||||
<a href="reports/claude-global-vs-project-settings.md"><img src="https://img.shields.io/badge/Global_vs_Project_Settings-555?style=for-the-badge" alt="全局与项目设置"></a>
|
||||
<a href="reports/claude-skills-for-larger-mono-repos.md"><img src="https://img.shields.io/badge/Skills_in_Monorepos-555?style=for-the-badge" alt="单体仓库中的 Skills"></a>
|
||||
<br>
|
||||
<a href="reports/claude-agent-memory.md"><img src="https://img.shields.io/badge/Agent_Memory-555?style=for-the-badge" alt="Agent Memory"></a>
|
||||
<a href="reports/claude-advanced-tool-use.md"><img src="https://img.shields.io/badge/Advanced_Tool_Use-555?style=for-the-badge" alt="Advanced Tool Use"></a>
|
||||
<a href="reports/claude-usage-and-rate-limits.md"><img src="https://img.shields.io/badge/Usage_&_Rate_Limits-555?style=for-the-badge" alt="Usage & Rate Limits"></a>
|
||||
<a href="reports/claude-agent-memory.md"><img src="https://img.shields.io/badge/Agent_Memory-555?style=for-the-badge" alt="智能体记忆"></a>
|
||||
<a href="reports/claude-advanced-tool-use.md"><img src="https://img.shields.io/badge/Advanced_Tool_Use-555?style=for-the-badge" alt="高级工具使用"></a>
|
||||
<a href="reports/claude-usage-and-rate-limits.md"><img src="https://img.shields.io/badge/Usage_&_Rate_Limits-555?style=for-the-badge" alt="使用量与速率限制"></a>
|
||||
<a href="reports/claude-agent-command-skill.md"><img src="https://img.shields.io/badge/Agents_vs_Commands_vs_Skills-555?style=for-the-badge" alt="Agents vs Commands vs Skills"></a>
|
||||
<br>
|
||||
<a href="reports/llm-day-to-day-degradation.md"><img src="https://img.shields.io/badge/LLM_Degradation-555?style=for-the-badge" alt="LLM Degradation"></a>
|
||||
<a href="reports/why-harness-is-important.md"><img src="https://img.shields.io/badge/Why_Harness_is_Important-555?style=for-the-badge" alt="Why Harness is Important"></a>
|
||||
<a href="reports/claude-spinner-verbs-and-tips.md"><img src="https://img.shields.io/badge/Spinner_Verbs_&_Tips-555?style=for-the-badge" alt="Spinner Verbs & Tips"></a>
|
||||
<a href="reports/llm-day-to-day-degradation.md"><img src="https://img.shields.io/badge/LLM_Degradation-555?style=for-the-badge" alt="LLM 性能退化"></a>
|
||||
<a href="reports/why-harness-is-important.md"><img src="https://img.shields.io/badge/Why_Harness_is_Important-555?style=for-the-badge" alt="为什么 Harness 很重要"></a>
|
||||
<a href="reports/claude-spinner-verbs-and-tips.md"><img src="https://img.shields.io/badge/Spinner_Verbs_&_Tips-555?style=for-the-badge" alt="加载动画动词与技巧"></a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
@@ -497,43 +503,43 @@ Repos primarily known as curated libraries of subagent definitions (`.claude/age
|
||||
|
||||
<a id="how-to-use"></a>
|
||||
|
||||
## <img src="!/tags/how-to-use-hd.svg" alt="How to Use">
|
||||
## <img src="!/tags/how-to-use-hd.svg" alt="如何使用">
|
||||
|
||||
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**
|
||||
**🎬 视频**
|
||||
|
||||
<a href="https://www.youtube.com/watch?v=AkAhkalkRY4"><img src="!/thumbnail/video-1.png" alt="Watch on YouTube" width="240"></a>
|
||||
<a href="https://youtu.be/lPjhM6BBK0Q"><img src="!/thumbnail/video-2.png" alt="Watch on YouTube" width="240"></a>
|
||||
<a href="https://www.youtube.com/watch?v=AkAhkalkRY4"><img src="!/thumbnail/video-1.png" alt="在 YouTube 上观看" width="240"></a>
|
||||
<a href="https://youtu.be/lPjhM6BBK0Q"><img src="!/thumbnail/video-2.png" alt="在 YouTube 上观看" width="240"></a>
|
||||
|
||||
**📊 Presentations**
|
||||
**📊 演示文稿**
|
||||
|
||||
<a href="https://github.com/shanraisshan/claude-code-best-practice/tree/main/presentation/2026-04-25-gdg-kolachi-cli-claude-code-gemini"><img src="!/thumbnail/presentation-1.png" alt="Claude Code & Gemini CLI — GDG Kolachi" width="240"></a>
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/trending?since=monthly"><img src="!/root/github-trending.png" alt="GitHub Trending" width="1200"></a><br>
|
||||
✨Trending on Github in March 2026✨
|
||||
✨2026 年 3 月登上 GitHub Trending✨
|
||||
</p>
|
||||
|
||||
## Star History
|
||||
## Star 历史
|
||||
|
||||
[](https://star-history.com/#shanraisshan/claude-code-best-practice&Date)
|
||||
|
||||
<a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars" align="center"></a> stars and counting
|
||||
<a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars" align="center"></a> stars，还在增长
|
||||
|
||||
## Other Repos
|
||||
## 其他仓库
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
@@ -560,22 +566,22 @@ Get the maximum out of this repo by following these steps:
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
## Developed by
|
||||
## 开发者
|
||||
|
||||
|
||||
|
||||
> | # | 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
|
||||
## 附加内容
|
||||
|
||||
[](https://claude.com/contact-sales/claude-for-oss)
|
||||
[](https://claude.com/community/ambassadors)
|
||||
@@ -584,13 +590,13 @@ Get the maximum out of this repo by following these steps:
|
||||
[](https://chat.whatsapp.com/BDUV2stIS0c7X5uY7RY6nS)
|
||||
|
||||
<p align="center">
|
||||
<img src="!/claude-jumping.svg" alt="section divider" width="60" height="50">
|
||||
<img src="!/claude-jumping.svg" alt="章节分隔符" width="60" height="50">
|
||||
</p>
|
||||
|
||||
## <img src="!/tags/sponsor-heart.svg" width="22" height="22" align="center"> Sponsor My Work
|
||||
## <img src="!/tags/sponsor-heart.svg" width="22" height="22" align="center"> 赞助我的工作
|
||||
|
||||
If you like my work, buy me a doodh patti 🍵 on
|
||||
如果你喜欢我的作品，可以在以下平台请我喝杯 doodh patti（奶茶）🍵：
|
||||
|
||||
<a href="https://buy.polar.sh/polar_cl_R6wjUESl8RiJD0iVaTyStBUV6WNuYvDmLJ0si1XXj4C"><img src="!/tags/polar.svg" alt="Polar" width="40" height="40" align="center"></a> <a href="https://buy.polar.sh/polar_cl_R6wjUESl8RiJD0iVaTyStBUV6WNuYvDmLJ0si1XXj4C"><strong>Polar</strong></a>
|
||||
|
||||
**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)。
|
||||
|
||||
Reference in New Issue
Block a user