Original Note

Claude Code Best Practice 目录 - Read

Claude Code 完整使用流程

需求澄清 ──→ 代码探索 ──→ 制定计划 ──→ 实现 ──→ 验证 ──→ 提交
    │           │           │          │         │
    ▼           ▼           ▼          ▼         ▼
访谈模式      /plan       /plan      正常模式   测试/截图
AskQuestion   只读探索    编辑计划    执行代码   确认结果

流程详解

1. 需求澄清

使用 AskUserQuestion 深挖业务边界、安全漏洞、边缘情况。产出 SPEC.md

适用:新项目起步、复杂业务逻辑、不确定的需求

2. 代码探索

进入 /plan 模式,只读扫描相关代码,理解现有架构。

适用:老项目维护、陌生代码库、多文件改动

3. 制定计划

让 Claude 产出执行计划,按 Ctrl+G 在编辑器中可视化编辑。

适用:跨文件重构、架构改动、需要预览方案

4. 实现

退出 /plan,进入正常模式,执行代码编写。

5. 验证

测试用例、截图对比、构建验证。参考 01_verification

核心:Always provide Claude a way to verify its work

6. 提交

commit + PR。


Session 管理(贯穿全程)

  • 事不过三原则:连续纠正 2 次以上立即 /clear 清空重来
  • 纠偏工具箱Esc 紧急刹车 → Undo that 撤销 → /rewind 时光倒流

详见 05_session_management


高级技巧

Subagent 自动化

批量重构、文档生成、大规模代码检索。详见 03_subagent

Plan Mode 与 AskUserQuestion 双剑合璧

访谈定策略 → 计划定代码 → 新 Session 落地。详见 04_plan_mode_ask


技巧索引

文件 内容
01_verification 如何让 Claude 验证自己的工作
02_explore_plan_implement 标准 Explore → Plan → Implement → Commit 工作流
03_subagent Subagent 高级自动化:批量重构、文档生成、代码检索
04_plan_mode_ask Plan Mode 与 AskUserQuestion 双剑合璧
05_session_management 纠偏工具箱与记忆净化
06_tips @引用、图片粘贴、URL白名单等实用技巧

何时跳过计划模式

场景 建议
单行修复(如 typo) 直接执行
小改动(加 log、重命名变量) 直接执行
范围明确且熟悉代码 直接执行
跨多文件重构 /plan
不熟悉的代码库 /plan
需求不明确 先 AskUserQuestion