Grill TDD调试Skills实战
深挖: grill-with-docs、红绿重构TDD、纪律调试、能过的评审。
先对齐, 再反馈环, 设计贯穿。这是 mattpocock/skills ↗ 第 2 篇——实战环:/grill-with-docs→/tdd→/diagnosing-bugs→/code-review。第 1 篇是总览。
一图看环#
[!NOTE] grill 认真答才值。短答进、模糊出。设计树全分支解决才是写码前提。
1. grill-with-docs: 面谈加共享语言#
/grill-me 无情连问任何计划。/grill-with-docs 加工程料: 术语磨进 GLOSSARY.md, 硬决定 inline 记 ADR。
ELI5: agent 扮倔强 5 岁问”为什么”到零歧义——再把约定词写下, 下次聪明开局。
session
/grill-with-docs
# agent: "done 指什么? 动哪些模块?"
# agent: "你说的 publish 是 persist、enqueue 还是 notify?"
# 结果: 术语→GLOSSARY.md, 决定→docs/adr/text复利: 语言简→变量函数文件名一致→好导航→少烧思考 token。
[!TIP] 每次变更都 grill, 不只大变更。全仓库最火是有原因的。
2. TDD: 每切片红绿重构#
/tdd 可插任何项目: 每次一个垂直切片, 经 public 接口测, 永不测内部。
tdd-loop
# RED: 一切片的失败测试
# GREEN: 通过的最小改动
# REFACTOR: 深化——行为增多、接口仍小
# 逐切片重复; /implement 在约定 seam 驱动text好与坏:
- 好: 经 public 的行为、一切片、glossary 命名
- 坏: 测内部、巨切片、把被测单元 mock 到无意义
3. diagnosing-bugs: 纪律环、门控阶段#
硬 bug 与性能回退走门控环:
diagnose
1. 对该 bug 变红的反馈环 (永远先复现)
2. 最小化复现
3. 假设 (每次一个)
4. 插桩证实或证伪
5. 修复
6. 回归测试永不再犯text不许跳到 5。每门过了才开下一门。
4. 评审与发布: 双轴#
/code-review 双轴并行子 agent 防污染:
- Standards——仓库标准加 Fowler 坏味基线
- Spec——忠于源 issue/spec?
/pr 整形正文: 最小可视摘要、前后证据、合并危险(单向还是双向门、blast radius)。
5. 架构: 巡检、非救援#
agent 速度下熵加速。两工具:
/to-specspec 前先问动哪些模块/improve-codebase-architecture把深化机会(Ousterhout 深模块: 行为多、接口小)出成可视 HTML 报告, 再 grill 你选的
每几天跑一次。诚实范围: 真老代码能找出候选, 但不会替你清泥球。
实战: 从 bug 到绿#
example
/grill-with-docs # "checkout retry" 约定: retry=re-enqueue, max 3, 必须幂等键
/to-tickets # 切片1 键管线; 切片2 重试策略; 切片3 UI 状态
/implement # 约定 seam 每切片 TDD
# bug: 重试重复扣费
# /diagnosing-bugs: 复现红→最小化→假设(键未传递)→插桩→修复→回归
# /code-review 再 /prtext成本控制#
skill 是文本加流程——成本在长 grill、架构扫描、分解、反复读。窄用: 一 bug、一切片、一计划、/handoff 压缩转移 context。
结论#
每变 grill、每片测、门控诊、双轴审。纪律非魔法—— baked-in 的思考才是价值。