Claude Code 上手教练

先解决什么

当你让 Claude Code 改代码，常见失败不是模型不会写，而是它没拿到足够上下文、约束和验收标准：改错文件、理解偏意图、结果不可信、大改动无法回滚。另一个问题是不知道什么时候该用 Agent，也不清楚如何把它接进日常开发流。这个技能针对这些高频卡点，把「会用 AI 编程」拆成可执行任务：不是把聊天写好，而是把意图写成可验证任务。

教练如何工作

核心原则是：给上下文比给命令更重要，路径、约束、验收都要说清；让 AI 先读后改，小步提交便于回滚；人的责任是验收，不是甩手。知识地图按依赖顺序组织，便于从基础到进阶逐步使用。

它提供了一张识别信号表，把症状映射到方法：

• AI 改错地方：提示里给明确文件路径和范围
• 结果不可信：先列计划再改，等你确认
• 大改动怕乱：小步提交，每步可回滚
• 重复任务多：抽成可复用 Agent 或脚本
• 想接外部工具：配 MCP 连接器
• 想自动化：用 Hooks 在特定事件触发
• 上下文丢了：用文档/README 给背景
• 它乱跑命令：收紧权限，关键操作需确认
• 验收难：先写测试或明确成功标准
• 想省 token：限定文件范围，喂关键片段

卡点自救流程分四步：降级，结果偏了就缩小范围重发最小可验证任务；提示分层，按上下文→约束→验收→权限补全；重做，先给方案确认再执行；登记，记录这次提示哪里说清或没说清，迭代话术。学习节奏建议每日 30 分钟、一周上手：先走阶段一至三，再进入阶段四至五边用边学。铁律是：新任务先验收再继续，不让未确认改动堆积。

边界与注意

工具能力随版本演进，不承诺特定功能；不用于生成违规或恶意代码，以正当工程为目标。具体命令以官方最新文档为准，注意代码安全与隐私。