プリランディングセルフレビュー は何をしますか?
重要な変更をコミットする前に、このチェックリストを実行してください。CIが問題をキャッチする前、あるいはユーザーが気づく前に問題を発見しましょう。
使用タイミング
以下のいずれかに該当する場合、このスキルを実行してください:
- 100行以上のコードを変更した
- 5ファイル以上を変更した
- コアインフラストラクチャ(executor、storage、メインディスパッチループ)に触れた
- 新しい抽象化やパブリックAPIを導入した
- エッジケースや設計上の選択について確信がない
簡単なゲート:
git diff --stat HEAD | tail -5 # どのくらい変更したか?
git diff --name-only HEAD | wc -l # いくつのファイルを変更したか?
スキップする場合
- 些細な変更(50行以下、3ファイル以下)
- 純粋なドキュメントやレッスンの更新
- テストのみの変更(テストはそれ自体がレビュー)
- 範囲が明らかで限定された単純な1行のバグ修正
- ロジック変更を伴わない機械的なリファクタリング
チェックリスト
1. エッジケース
- [ ] null/空の入力は処理されているか?
- [ ] 境界条件(off-by-one、空リスト、ゼロ)がテストされているか?
- [ ] 同時アクセスや競合状態は考慮されているか?
- [ ] テキスト処理時にUnicode/エンコーディングの問題は考慮されているか?
2. エラーパス
- [ ] すべての例外は適切なレベル(広すぎない)でキャッチされているか?
- [ ] エラーメッセージは有益か(何が失敗したか、なぜか、どうすればよいか)?
- [ ] 障害モードは優雅に失敗し、静かに失敗しないか?
- [ ] 裸の `except:` やエラーを飲み込んでいないか?
3. テストカバレッジ
- [ ] 重要なパスにテストがあるか?
- [ ] 上記で特定したエッジケースにテストがあるか?
- [ ] テストは実際に実行され、パスするか?
- [ ] `pass` や `...` で放置されたテストスタブがないか?
4. ドキュメント
- [ ] ドキュメント文字列/コメントは現在の動作と一致しているか?
- [ ] パブリックインターフェースが変更された場合、READMEは更新されているか?
- [ ] コミットメッセージは何が変わったかとその理由を捉えているか?
- [ ] 関連するアーキテクチャドキュメントは依然として正確か?
5. コード品質
- [ ] 名前付けは明確で周囲のコードと一貫性があるか?
- [ ] 明らかなコードの悪臭(神関数、マジックナンバー、ハードコードされたパス)がないか?
- [ ] ファイル/パッケージ内の既存のパターンに従っているか?
- [ ] 静的解析/型チェックはパスするか?
ワンライナースモークテスト
# コミット前に実行(スタックに合わせて適応してください):
make format && make typecheck && pytest -x -q && echo "✅ ランディングクリーン"
いずれかのステップが失敗した場合、コミットする前に修正してください。レッドを出荷しないでください。
アンチパターン
| アンチパターン | 修正方法 |
|---|---|
| 「CIがキャッチする」 | CIは最後の手段であり、自分自身の判断の代わりにはなりません。最初にキャッチしましょう。 |
| 「あとでテストを追加する」 | 「あとで」は来ません。今すぐテストを書くか、永久にギャップを受け入れてください。 |
| 「手動テストで動いた」 | 手動テストは再現可能ではありません。自動テストを書いて、将来のセッションでも検証できるようにしましょう。 |
| 「エラーメッセージはTODO」 | TODOエラーメッセージはTODOエラーメッセージとして出荷されます。今すぐ本当のメッセージを書きましょう。 |
| 「コードを見ればこのケースを処理していることがわかる」 | テストされていなければ、将来のリファクタリングで見えないうちに壊れます。 |
これが重要な理由
自律エージェントは、修正を避けるのに十分な「良い」出力を生成するように訓練されています。構造化されたレビューゲートがなければ、自律エージェントによるコードコミットは、通常は回帰やエッジケースをキャッチする人間参加型チェックをバイパスします。このスキルはそのゲートとして機能します。5つの焦点を当てたレンズを順番に実行することで、明らかなものがすり抜けるのを防ぎます。
その効果は積み重なります。レビューパスが実際の問題をキャッチするたびに、CIの往復時間が節約され、ユーザーバグが回避され、不要なリバートPRが削減されます。
関連
- Self-Pushスキル — この構造的レビューを補完する品質/怠惰チェック
- マルチレンズレビュースキル — 影響の大きい変更に対するより深い並行レビュー