Claude Code 官方最佳实践

要解决什么问题

在 Claude Code 里做非 trivial 改动时，常见痛点不是「写不出代码」，而是上下文窗口被快速填满后推理质量下滑，以及缺少可重复的验证闭环，最后变成你在人肉 review 每一轮「看起来对了」。本技能把 Anthropic 官方文档里的约束讲清楚：上下文是最稀缺的资源，其余实践都围绕它展开。

技能如何组织这些实践

技能按工程流程拆成几条可执行的线：

• 可验证交付：在提示里先写 pass/fail 标准（测试、构建退出码、linter、diff、截图对比），并要求 Claude 展示证据而不是口头宣称完成；严格度可从单轮提示到 Stop hook、独立 verification subagent。
• 先探再写：非小改时走 Explore → Plan → Implement → Commit；小改（ typo、单行日志、变量重命名）或一句话能说清的 diff 可跳过规划。
• 提示要具体：用 @ 文件引用、症状描述、仓库内既有模式、git 历史或文档链接收窄范围，而不是泛问「帮我优化一下」。
• 环境配置：CLAUDE.md（/init 起步、只保留「删掉会导致犯错」的行）、权限与沙箱、CLI/MCP、Hooks、Skills、Subagents、Plugins 各管一块——Hooks 是确定性的，Skills 是可复用领域知识。
• 会话治理：/clear、/compact、/rewind、子代理做调研或对抗式 review；同一问题纠正超过两次就清空会话并用更好的提示重来。

适用边界

这是工作流与提示习惯的备忘，不是某个语言的框架 API 手册。官方也强调：规则是起点而非铁律——深度攻坚时可以让上下文累积，探索任务可以少规划；关键是观察「上下文是否噪声过多、提示是否过宽、是否该拆给 subagent」。