blog.dopana

返回

先对齐, 再反馈环, 设计贯穿。这是 mattpocock/skills ↗ 第 2 篇——实战环:/grill-with-docs→/tdd→/diagnosing-bugs→/code-review。第 1 篇是总览。

一图看环#

有无/grill-with-docs: 全分支解决一个垂直切片RED: 经 public 接口的失败测试GREEN: 最小修复REFACTOR: 深化模块还有切片?/code-review: Standards x SpecBug 报告复现: 对该 bug 变红最小化假设 + 插桩修复 + 回归测试

[!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-spec spec 前先问动哪些模块
  • /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 再 /pr
text

成本控制#

skill 是文本加流程——成本在长 grill、架构扫描、分解、反复读。窄用: 一 bug、一切片、一计划、/handoff 压缩转移 context。

结论#

每变 grill、每片测、门控诊、双轴审。纪律非魔法—— baked-in 的思考才是价值。

参考资料#