review-debt について
review-debt は、レビュー表の技術的負債に関する指摘を、明確な返済項目に変換する内部スキルです。既存の担当軸を維持し、コードを変更せずに各項目の根拠とトリガーを記録します。
主な機能
- 01負債の指摘を返済項目に変換
- 02記録済みの担当軸を維持
- 03根拠と返済トリガーを必須化
- 04現行単位の負債の誤分類を指摘
- 05固定形式のレビュー表を出力
活用シーン
- 01TODOやFIXMEを負債項目に整理
- 02延期作業のトリガーを記録
- 03現行単位の負債の誤分類を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/review-debtを入力して読み込まれたか確認します。
詳細
技術的負債のレビュー（内部）
review-change／product-audit が会話内で作成します。どのエージェントも、このファイルに従ってルーティングされた手順としてインラインで実行します。指摘事項のみ。編集もリファクタリングもしません。
対象範囲
呼び出し元の統合済み指摘事項テーブル（統合・分類された判断テーブル）です。この工程では差分を再スキャンしません。負債に該当する指摘事項はすでにテーブルにあり、所有者に関する判断もすべて検出軸（review-code、review-verify、…）ですでに行われています。返却するテーブルの冒頭に、対象範囲、つまりテーブルの統合対象となった変更を記載します。
変換（すべての行を評価すること。例外はなく、該当なしの場合も明記すること）
テーブル内の技術的負債に該当する行（TODO／FIXME／HACK、重複、古い、または孤立した抽象化、デッドコード、複雑性の高い箇所、テスト不足、上流での修正を前提とした回避策）を、明示的で返済可能な負債項目に変換します。
✓ 負債に該当する各指摘事項を、先送りしている内容とともに file:line 形式で記述し直す
✓ テーブルにすでに記録されている軸に帰属させる。所有者について再検討しない
✓ すべての負債項目に TRIGGER（返済が必要となる条件）があることを確認する（例：「3つ目の利用者が現れたとき」、「100k 行超」）。TRIGGER のない負債項目自体が指摘事項です
✓ 現在のユニットの負債が、誤って非ブロッキングと分類されていないことを確認する。現在のユニットの作業を postpone／tradeoff／wontfix にすることはできません。テーブルにそのような項目がある場合は、ここで再分類せず、分類担当者に差し戻します
✓ デッドコードの例外を尊重する。ロードマップ／SPEC／TASKS と照合した、段階的に導入中または計画済みのコードはデッドコードではありません。判断に迷う場合は verify と記載し、断定しないこと
出力形式
REVIEW TECH DEBT — scope: <scope>
| # | Finding | Sev | Evidence | Suggested fix |
|---|---------|-----|----------|---------------|
| 1 | <what> | critical|major|minor | <file:line> | <trigger + smallest action> |
Rows: <n> transformed, <n> with trigger, <n> findings, <n> n/a (<which + why>)
Summary: <1-2 sentences>
Decision: PASS | FAIL
この工程では、Suggested fix 列に、最小限の対応とともに、負債の返済が必要となる条件である TRIGGER を記載します。
重大または major の指摘事項が未解決の場合は FAIL。それ以外は PASS です。minor の指摘事項はブロッキングにはなりません。負債に関する注記として呼び出し元のレポートに記載します。
完了条件
- 統合済みテーブルの負債に該当する各行が、証拠（
file:line）とともに変換されているか、理由を添えて明示的に該当なしとされていること。 - すべての負債項目に TRIGGER があり、現在のユニットの負債に誤った分類がないこと。
- 上記の固定形式ブロックのみを返し、それ以外は何も返さないこと。また、コードを変更していないこと。