jpskill.com
🛠️ 開発・MCP コミュニティ

tech-debt

Identify, categorize, and prioritize technical debt. Trigger with "tech debt", "technical debt audit", "what should we refactor", "code health", or when the user asks about code quality, refactoring priorities, or maintenance backlog.

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o tech-debt.zip https://jpskill.com/download/22607.zip && unzip -o tech-debt.zip && rm tech-debt.zip
🪟 Windows (PowerShell)
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/22607.zip -OutFile "$d\tech-debt.zip"; Expand-Archive "$d\tech-debt.zip" -DestinationPath $d -Force; ri "$d\tech-debt.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して tech-debt.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → tech-debt フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

技術的負債の管理

技術的負債を体系的に特定し、分類し、優先順位を付けます。

カテゴリ

タイプ リスク
コード負債 重複したロジック、不十分な抽象化、マジックナンバー バグ、開発速度の低下
アーキテクチャ負債 分割すべきモノリス、誤ったデータストア スケーリングの限界
テスト負債 低いカバレッジ、不安定なテスト、不足している結合テスト リグレッションの発生
依存関係負債 古いライブラリ、メンテナンスされていない依存関係 セキュリティ脆弱性
ドキュメント負債 不足している運用手順書、古い READMEs、属人化した知識 オンボーディングの困難さ
インフラ負債 手動デプロイ、監視なし、IaC なし インシデント、復旧の遅延

優先順位付けフレームワーク

各項目を以下の観点でスコアリングします。

  • 影響: チームの速度をどの程度低下させますか? (1-5)
  • リスク: 修正しない場合、何が起こりますか? (1-5)
  • 労力: 修正はどの程度困難ですか? (1-5、逆転 — 労力が低いほど優先度が高い)

優先度 = (影響 + リスク) x (6 - 労力)

出力

推定労力、各項目のビジネス上の正当性、および機能開発と並行して実行できる段階的な改善計画を含む、優先順位付けされたリストを作成します。

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Tech Debt Management

Systematically identify, categorize, and prioritize technical debt.

Categories

Type Examples Risk
Code debt Duplicated logic, poor abstractions, magic numbers Bugs, slow development
Architecture debt Monolith that should be split, wrong data store Scaling limits
Test debt Low coverage, flaky tests, missing integration tests Regressions ship
Dependency debt Outdated libraries, unmaintained dependencies Security vulns
Documentation debt Missing runbooks, outdated READMEs, tribal knowledge Onboarding pain
Infrastructure debt Manual deploys, no monitoring, no IaC Incidents, slow recovery

Prioritization Framework

Score each item on:

  • Impact: How much does it slow the team down? (1-5)
  • Risk: What happens if we don't fix it? (1-5)
  • Effort: How hard is the fix? (1-5, inverted — lower effort = higher priority)

Priority = (Impact + Risk) x (6 - Effort)

Output

Produce a prioritized list with estimated effort, business justification for each item, and a phased remediation plan that can be done alongside feature work.