菜单
技術的負債の特定、分類、優先順位付けフレームワーク。 体系的な負債解消のための legacy-modernizer エージェントとの統合。 以下の場合に使用: - コードベースの技術的負債の特定 - どの負債を先に対処すべきかの優先順位付け - 負債の経時的な追跡 - リファクタリングスプリントの計画 - ステークホルダーへの負債解消の正当化 Trigger phrases: tech debt, technical debt, code smell, refactor priority, RICE score, debt tracking, legacy code
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
設定ファイルとソースコードからプロジェクトの技術スタックを自動検出。 Use when: 新規コードベースでの作業開始、言語/フレームワーク/ツールの特定。 Trigger phrases: detect stack, what framework, identify technology, project setup
REST、GraphQL、gRPC の API 設計パターン。 Use when: API の新規設計、OpenAPI 仕様作成、バージョニング/ページネーション設計。 Trigger phrases: API design, REST endpoint, GraphQL schema, OpenAPI, gRPC, pagination
エバリュエーター・オプティマイザーのフィードバックループによる反復改善。 Use when: 出力品質の反復改善、明確な評価基準がある複雑な出力の最適化。 Trigger phrases: iterate, refine, improve quality, feedback loop, evaluate and optimize
ルール遵守と創造的な問題解決のバランスを取るためのフレームワーク。 Anthropic のエージェント設計に関する研究に基づく。 使用場面: - 複数の有効なアプローチがある複雑な判断に直面した場合 - 状況に対して指示が過度に規範的に感じられる場合 - ガイドラインを特定のコンテキストに適応させる必要がある場合 - 精度要件と革新的なソリューションのバランスを取る場合 Trigger phrases: think creatively, use judgment, adapt approach, better solution, flexibility
曖昧なリクエストを明確にするための構造化された要件インタビューフレームワーク。使用場面: - ユーザー要件が不明確または不完全な場合 - 新機能を開始し要件を収集する必要がある場合 - ユーザーのニーズ、制約、優先順位を理解する必要がある場合 - ビジネスリクエストを技術仕様に変換する場合 - ユーザーが詳細なしに「～したい」「～を追加して」と言う場合 Trigger phrases: gather requirements, clarify request, what do you need, interview user, requirements gathering, unclear request
すべてのユーザー向けコンテンツに日本語出力を強制する。 使用場面: - エージェント出力を日本語にする必要がある場合 - レスポンス全体の言語の一貫性を検証する場合 - 仕様書やドキュメントを日本語で生成する場合 Trigger phrases: Japanese, 日本語, language mode, output language
| name | tech-debt-management |
| description | 技術的負債の特定、分類、優先順位付けフレームワーク。 体系的な負債解消のための legacy-modernizer エージェントとの統合。 以下の場合に使用: - コードベースの技術的負債の特定 - どの負債を先に対処すべきかの優先順位付け - 負債の経時的な追跡 - リファクタリングスプリントの計画 - ステークホルダーへの負債解消の正当化 Trigger phrases: tech debt, technical debt, code smell, refactor priority, RICE score, debt tracking, legacy code |
| allowed-tools | Read, Write, Glob, Grep, TodoWrite |
| model | sonnet |
| user-invocable | true |
技術的負債の特定、分類、優先順位付け、追跡のためのフレームワーク。
Anthropic の Building Effective Agents より:
"Agents should gain ground truth from the environment at each step."
負債への適用: 仮定ではなく実際のコードパターンから負債を特定する。測定可能な影響に基づいて優先順位を付ける。
| 種類 | 説明 | 検出方法 |
|---|---|---|
| 設計負債 | 不適切な抽象化、密結合 | 依存関係分析、code-explorer |
| コード負債 | 重複、複雑さ、不適切な命名 | リンター警告、複雑度メトリクス |
| テスト負債 | 低カバレッジ、フレーキーテスト | カバレッジレポート、テスト履歴 |
| ドキュメント負債 | ドキュメントの欠如/陳腐化 | /doc-audit の発見 |
| 依存関係負債 | 古いパッケージ、脆弱性 | npm audit、security-auditor |
| インフラ負債 | 手動プロセス、自動化の欠如 | devops-sre 分析 |
| レベル | 影響 | 例 |
|---|---|---|
| Critical | 開発をブロックまたは障害を引き起こす | 循環依存、セキュリティ脆弱性 |
| High | 開発を大幅に遅延させる | 重要パスのテストなし、重大な重複 |
| Medium | 摩擦を生み、バグリスクを増加 | 不整合なパターン、部分的なカバレッジ |
| Low | 見た目上の問題や軽微な不便 | 命名の不整合、ドキュメント不足 |
Reach x Impact x Confidence / Effort
| 要素 | スケール | 説明 |
|---|---|---|
| Reach | 1-10 | 影響を受ける開発者/機能の数 |
| Impact | 0.25, 0.5, 1, 2, 3 | ケースごとの改善度 |
| Confidence | 0-100% | 見積もりの確信度 |
| Effort | 人・週 | 修正にかかる作業量 |
例:
負債: 共有バリデーションロジックの抽出
Reach: 8（8 モジュールに影響）
Impact: 2（大幅な改善）
Confidence: 80%
Effort: 1 週
RICE = (8 × 2 × 0.8) / 1 = 12.8
時間に敏感な負債の場合:
CoD = (Weekly Impact × Weeks Until Critical) / Effort
以下の場合に使用:
迅速な視覚的優先順位付け:
高インパクト
│
┌───────────────┼───────────────┐
│ │ │
│ クイックウィン │ 大型プロジェクト
│ （最初にやる）│ （慎重に計画）
│ │ │
低 ├───────────────┼───────────────┤ 高
工数 │ 工数
│ │ │
│ すき間作業 │ 割に合わない作業
│ （時間がある │ （回避または委任）
│ 時にやる） │ │
│ │ │
└───────────────┼───────────────┘
│
低インパクト
{
"version": "1.0",
"lastUpdated": "2025-01-20",
"summary": {
"total": 15,
"critical": 2,
"high": 5,
"medium": 6,
"low": 2
},
"debts": [
{
"id": "TD-001",
"title": "Extract validation utilities",
"type": "code",
"severity": "high",
"location": "src/services/*.ts",
"description": "Validation logic duplicated across 8 services",
"impact": "Bug fixes require changes in multiple places",
"rice": {
"reach": 8,
"impact": 2,
"confidence": 80,
"effort": 1,
"score": 12.8
},
"status": "identified",
"createdAt": "2025-01-15",
"assignee": null,
"relatedIssues": ["#123", "#145"]
}
]
}
| ステータス | 説明 |
|---|---|
identified | 負債を発見、未優先順位付け |
prioritized | RICE スコア付き、バックログに追加 |
scheduled | スプリント/マイルストーンに割り当て |
in_progress | 現在対処中 |
resolved | 修正済みかつ検証済み |
accepted | 意図的に先送り |
code-explorer を分析重視で起動:
技術的負債の指標についてコードベースを分析:
1. **複雑性ホットスポット**: 高い循環的複雑度のファイル
2. **重複**: ファイル間で類似するコードブロック
3. **依存関係の問題**: 循環インポート、古いパッケージ
4. **テストギャップ**: テストのない重要パス
5. **コードの悪臭**: 長いメソッド、大きなクラス、深いネスト
ファイル場所と重大度評価付きで発見結果を返す。
各自動検出結果について:
確認された負債項目を追跡ファイルに追加:
.claude/tech-debt.json（プロジェクトレベル）特定された負債の対処に:
legacy-modernizer に委任:
この技術的負債に対処:
Debt ID: TD-001
Title: Extract validation utilities
Location: src/services/*.ts
Description: [レジストリより]
アプローチ:
1. 共有バリデーションモジュールを作成
2. 各サービスを段階的に移行
3. 動作変更がないことを検証（特性化テスト）
4. コードベース全体でインポートを更新
制約:
- 既存のテストカバレッジを保持
- 破壊的な API 変更なし
- 各サービスの移行後にコミット
依存関係の負債に:
security-auditor に委任:
セキュリティ負債について依存関係を監査:
フォーカス:
- 既知の脆弱性（npm audit 等）
- サポート終了のパッケージ
- セキュリティアドバイザリのあるパッケージ
重大度とアップグレードパス付きの優先順位付きリストを返す。
「コードを見つけた時よりも良い状態にして去る。」
キャパシティの一定割合を割り当てる:
大規模なレガシーシステムの場合:
## 技術的負債レポート - [日付]
### ヘルススコア: [X]/100
### サマリー
- **合計項目**: [N]
- **Critical**: [N]（即時対応が必要）
- **推定合計工数**: [X] 人・週
### RICE スコア上位 5 件
| 順位 | タイトル | タイプ | RICE | 工数 |
|------|---------|-------|------|------|
| 1 | [タイトル] | [タイプ] | [スコア] | [工数] |
### 最近の進捗
- 解決済み: この[期間]で [N] 件
- 新規: [N] 件特定
### 推奨事項
1. [最優先のアクション]
2. [次の優先アクション]
.claude/tech-debt.json に保存