How / What / Why / Why not — 責務マップ
この skill は4原則の入口。詳細規約は各 SoT skill へ委譲する。
4原則
| 成果物 | 原則 | 説明 | SoT |
|---|---|---|---|
| コード | How | コード自体が実現方法を示す | (本 skill の指針のみ) |
| テストコード | What | 呼び出し側から観測可能な結果、振る舞い、仕様、契約を内部実装に依存せず示す | tdd/SKILL.md, tdd/tests.md |
| コミットログ | Why | なぜこのように実装・変更したかを示す | kf-g-git-commit-japanese-commit-message |
| コードコメント | Why not | なぜ別案を採らなかったか、なぜ単純化・削除できないかを示す | kf-g-code-comment-rules |
読み進め方
- 作業対象(コード / テスト / commit / コメント)に対応する原則行を特定する
- 該当 SoT skill を Read する
- How(コード)は SoT を持たない。実装そのもので方法を示す
作業別の必須手順
コードを書く・直す前
- 本 skill で How の責務を確認する
- 実装そのもので方法を示す(How をコメントや commit に逃がさない)
テストを書く・直す前
- 本 skill で What の責務を確認する
- tdd/SKILL.md を Read する
- 必要なら tdd/tests.md を Read する
commit メッセージを書く前
- 本 skill で Why の責務を確認する
- kf-g-git-commit-japanese-commit-message を Read する
- commit 依頼時は kf-g-git-commit-staged-only-rules も併用する(canonical)
- ユーザーが
/genshijin-commitを明示した場合のみ genshijin-commit を使う
コードコメントを書く・直す前
- 本 skill で Why not の責務を確認する
- kf-g-code-comment-rules を Read する
最終チェック
- 各成果物が対応する原則(How / What / Why / Why not)に沿っている
- 詳細規約を本 skill に複製していない
- 該当 SoT skill を Read 済みである