Claude Code 使用技巧

可复现实践

为一个小型编码任务建立 Evidence Packet

用 baseline、有界 request、定向证据、广域 gate 和 reviewed diff 替代“已完成”声明。

准备

• 可信仓库和一个有单一观察结果的小任务。
• 已知 test/build/lint 或 manual QA command。
• Clean baseline 或明确的 pre-existing changes 清单。

执行步骤

1. 捕获 baseline

   实现前记录当前 change 和 failing/missing behavior。

   git status --short
   git diff --check

2. 声明一个 acceptance check

   给出精确 file scope、禁止区域，以及证明成功的 command/browser path。

3. 分层验证

   先运行最小相关检查，再运行 repository gate；保留 command output，不用 prose assertion。

4. Review 最终 evidence

   比较 status、diff、tests，再由独立 reviewer 挑战结果。

   git status --short
   git diff --check
   git diff --stat

预期结果

Reviewer 无需信任实现者总结，即可把 requested outcome 追溯到 bounded diff 和具体 verification output。

验证

• Acceptance check 在 baseline 失败或不存在，改动后通过。
• Final diff 不含无关文件。
• 第二种方法检查高风险行为或尝试反驳结论。

失败处理

清理或回退

• 检查 patch 后只回退 bounded task changes。
• 保留 failure evidence 直到能复现原问题，再按项目 retention rule 处理。

边界与不适用场景

• Context 不是越多越好，应提供最少相关文件、constraint 和 evidence。
• 独立复核降低相关错误，但不替代 security、legal 或 production approval。