Claude Code 编码指南

你在解决什么问题

Claude Code 这类编码代理能改代码、跑命令，但行为高度依赖项目根目录的 CLAUDE.md 和你在对话里怎么下指令。常见痛点是：上下文塞满整个仓库、代理「卡住」或反复误解路径、以及小改动没验证就堆成大 diff。本技能把配置模板、提示关键词和排错步骤整理成一份可对照执行的参考，而不是泛泛的产品说明。

技能如何组织内容

项目级配置：从新项目起步时，在仓库根目录维护 CLAUDE.md，用技能里的通用模板约束代理的角色、边界和协作方式。

加深推理的提示词：在任务描述里显式使用如「逐步思考」「分析根本原因」「执行前先计划」「验证你的假设」等表述，引导代理先规划再动手，减少盲目改文件。

调试三板斧：

• 清除上下文：新开会话或要求代理忘记混乱的旧指令
• 明确指令：路径、文件名、期望结果写死，避免模糊指代
• 日志与详细输出：要求检查日志或以 verbose 方式运行命令，便于定位失败点

日常节奏：先用 grep / find 缩小相关文件，再要小步改动、验证后再继续；若代理出错，当场纠正并建议把教训写回 CLAUDE.md（或代理记忆能力若可用）。

适用边界

内容侧重 Claude Code 工作流与 CLAUDE.md 实践，并注明参考了 zebbern 的同类指南；不替代官方文档，也不保证覆盖你团队特有的 CI、安全或合规流程。代理是否支持「记忆」取决于具体产品版本，需以实际环境为准。