tech-debt について
コード、アーキテクチャ、テスト、依存関係、ドキュメント、インフラの技術的負債を特定・分類し、優先順位を付けるスキルです。工数の見積もり、事業上の根拠、段階的な解消計画を含む一覧を作成します。
主な機能
- 016種類の技術的負債を分類
- 02影響・リスク・工数を評価
- 03負債項目に優先順位を設定
- 04機能開発と並行する段階的な解消計画
活用シーン
- 01コードベースに蓄積した負債の調査
- 02先に対処する負債の選定
- 03機能開発に合わせた負債解消の計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/tech-debtを入力して読み込まれたか確認します。
詳細
技術的負債の管理
技術的負債を体系的に特定、分類し、優先順位を付けます。
分類
| 種類 | 例 | リスク |
|---|---|---|
| コードの負債 | ロジックの重複、抽象化の不備、マジックナンバー | バグ、開発の遅延 |
| アーキテクチャの負債 | 分割すべきモノリス、不適切なデータストア | スケーリングの限界 |
| テストの負債 | カバレッジの低さ、不安定なテスト、統合テストの不足 | リグレッションの混入 |
| 依存関係の負債 | 古いライブラリ、メンテナンスされていない依存関係 | セキュリティ上の脆弱性 |
| ドキュメントの負債 | ランブックの不足、古い README、属人的な知識 | オンボーディングの負担 |
| インフラストラクチャの負債 | 手動デプロイ、監視の欠如、IaC の不在 | インシデント、復旧の遅延 |
優先順位付けのフレームワーク
各項目を次の基準で評価します。
- 影響度：チームの作業をどの程度遅らせますか？（1～5）
- リスク：修正しない場合、何が起こりますか？（1～5）
- 工数：修正はどの程度難しいですか？（1～5、逆数扱い — 工数が少ないほど優先度が高くなります）
優先度 = （影響度 + リスク）×（6 - 工数）
出力
優先順位を付けたリストを作成し、各項目の見積もり工数とビジネス上の根拠を示します。また、機能開発と並行して実施できる段階的な修正計画を提示します。
コメント
Markdown 対応