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