blog.dopana

戻る

先 align、次 feedback loop、design 通底。第2回 mattpocock/skills ↗ 実践 loop:/grill-with-docs→/tdd→/diagnosing-bugs→/code-review。第1回は概要。

一枚絵#

ありなし/grill-with-docs: 全分岐解決垂直 slice 一つRED: public I/F 経由失敗テストGREEN: 最小修正REFACTOR: module 深化残 slice?/code-review: Standards x SpecBug 報告再現: この bug で赤最小化仮説 + 計測修正 + 回帰テスト

[!NOTE] grill は真剣回答のみ報われる。短答in、曖昧out。設計木の全分岐解決が code 前提。

1. grill-with-docs: 質問+共有言語#

/grill-meは容赦質問。/grill-with-docsは工程味付け: 用語をGLOSSARY.mdに研ぎ、難決定を ADR に inline 記録。

ELI5: 頑固5歳が曖昧ゼロまで「なぜ」と聞き——合意語を書残し次回 smart 開始。

session
/grill-with-docs
# agent: 「done とは? 触る module は?」
# agent: 「publish とは persist、enqueue、notify のどれ?」
# 結果: 用語→GLOSSARY.md、決定→docs/adr/
text

複利: 簡潔言語→変数・関数・ファイル名一貫→探索容易→思考 token 減。

[!TIP] 大小問わず毎回 grill。repo 最人気には理由あり。

2. TDD: slice 毎 赤緑リファクタ#

/tddはどこでも嵌る: 毎回垂直 slice 一つ、public I/F 経由テスト、内部は testing しない。

tdd-loop
# RED: 一 slice の失敗テスト
# GREEN: 通る最小変更
# REFACTOR: 深化——振舞い増、I/F 小のまま
# 繰返し; /implement が合意 seam で駆動
text

良 vs 悪:

  • 良: public 経由振舞い、一 slice、glossary 名
  • 悪: 内部テスト、巨大 slice、被験 unit を mock で無意味化

3. diagnosing-bugs: 規律 loop、gated#

難 bug・perf 回帰は gated loop:

diagnose
1. この bug で赤い feedback loop (常に再現先)
2. 再現最小化
3. 仮説 (毎回一つ)
4. 計測で確定か棄却
5. 修正
6. 回帰テストで再発封じ
text

5 へ飛ばない。各 gate 通过が次を開ける。

4. review と ship: 二軸#

/code-reviewは汚染避け並列 subagent 二軸:

  • Standards——repo 標準 + Fowler 匂い baseline
  • Spec——元 issue/spec に忠実?

/pr整形: 最小 visual 要約、前後証拠、merge 危険(一方向か双方向か、blast radius)。

5. architecture: survey、救済でない#

agent 速度でエントロピ加速。道具二つ:

  • /to-specは触 module を spec 前質問
  • /improve-codebase-architectureは深化余地を HTML visual 報告、選んだ物を grill

数日毎に実行。正直 scope: 本当に古い code は候補出すが泥解きはしない。

実践: bug→緑#

example
/grill-with-docs      # 「checkout retry」合意: retry=re-enqueue、max 3、冪等キー必須
/to-tickets           # slice1 鍵配管; slice2 retry 方針; slice3 UI 状態
/implement            # 合意 seam で slice 毎 TDD
# bug: retry 重複課金
# /diagnosing-bugs: 再現赤→最小化→仮説(鍵未伝播)→計測→修正→回帰
# /code-review→/pr
text

cost 制御#

skill は text と工程——cost は長 grill、architecture 走査、分解、反復読みに宿る。狭く使う: bug 一つ、slice 一つ、plan 一つ、context 移は/handoff圧縮。

結論#

毎変更 grill、slice 毎 test、gated 診断、二軸 review。魔法でなく規律——焼込思考が価値。

参考文献#