Menu
TenkaCloud tech-debt analyzer を実行し、test smell / 結合漏れ / magic number 等の技術的負債を検出する。コード品質、テスト改善、リファクタの優先順位、技術的負債バックログを訊かれたときに使う。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
本体（Makefile / CI / scripts）から切り離した品質ゲート検査を走らせる。HTTP マジックナンバー・100% カバレッジ・IAM Description ASCII・merge 整合・submodule pin を検査する。コミット前チェック、PR 前の品質確認のときに使う。
TenkaCloud architecture harness を実行し、.claude/harness の決定論的 enforcement rule 違反を検出する。コミット前のアーキテクチャ整合チェック、リファクタ後の確認、rule ID の意図や修正方法を調べるときに使う。判断原則の評価ではなく、機械判定可能なリポジトリ状態を検査する。
TenkaCloud の複雑な機能追加、障害修正、アーキテクチャ変更を、問題の形式化、独立した approach family の探索、証拠と exact gap の管理、TenkaCloud 固有の敵対的監査、TDD 実装、完了監査の順で進める適応型オーケストレーションスキル。Control Plane、Application Plane、problem runtime、認証、cross-account trust、データ整合性、CFn 物理変更、running cost、複数 mode にまたがる変更で使う。固定人数・固定役割ではなく、課題のリスクに応じて探索観点を動的に選ぶ。
Coach a TenkaCloud local-play drill problem — after solving (or while stuck on) a `make local` problem, explain what happened, the root cause, how it generalizes to competing in TenkaCloud Battle/Challenge, and code-free remediation, then answer follow-ups. Learner-facing; runs in the learner's own Claude Code (no platform, no API cost). Invoked as `/tenka-drill <problemId>`.
実装計画・ADR・Issue・PR diff・特定ディレクトリを対象に、計画に書かれていない前提／未接続の境界／将来の運用条件など「計画を無効化しうる未知 (unknown unknowns)」をコード・設定・テスト・ドキュメントの証拠で洗い出し、意思決定可能な形で報告する review-only スキル。実装開始前・PR 前・ADR/設計レビュー時に使う。設計は変更しない。
Write technical specifications in Open Web Docs format (MDN style). Use this skill when creating API documentation, function specs, or technical references.
| name | tech-debt |
| description | TenkaCloud tech-debt analyzer を実行し、test smell / 結合漏れ / magic number 等の技術的負債を検出する。コード品質、テスト改善、リファクタの優先順位、技術的負債バックログを訊かれたときに使う。 |
| allowed-tools | Bash(make tech-debt:*), Bash(bun run .claude/harness/bin/tech-debt.ts:*) |
リポジトリ全体を静的解析し、ルールごとにグルーピングした finding 一覧を出力する。ルール実装は .claude/harness/src/tech-debt/ 配下に 1 ルール = 1 ファイルで配置。
全 tracked file を scan (デフォルト):
make tech-debt
Staged ファイルのみ + severity gate (PR 前 / pre-commit 用):
bun run .claude/harness/bin/tech-debt.ts --staged --fail-on=error
--fail-on が無指定の場合は warning 以上で exit 2 になる (= advisory ベース)。error 指定で error 級だけを blocker 扱いにできる。
現状を baseline として凍結し、 新規違反のみ block する:
bun run .claude/harness/bin/tech-debt.ts --baseline
これで .claude/harness/baselines/tech-debt-<rule>.json が更新される。 既存違反は許容、 新規追加のみ次回 run で finding として上がる。
各 finding には severity (error / warning / info) と修正方針 (recommendation) が付く。
it() / test() 1 ブロック内の expect() が 6 個以上。 失敗時にどの assertion で死んだか読み取りにくいので、 振る舞い単位で test case を分割する。infrastructure/lib/ 等 production code で 1 ファイルが 16 個以上の module を import している。 26 個で重警告、 41 個で error (= 必ず分割)。c.json(body, 500) / res.status === 401) / timeout (60000 ms 等) / port (3000 / 8080 等) を直書きしている。 StatusCodes.* (= http-status-codes) や名前付き定数に抽出する。ruleId が複数出ている場合は、 まずそのパターンを 1 箇所だけ模範実装で直して、 残りを追従--baseline で凍結し、 新規追加だけ block する設計/harness (= make harness) — アーキテクチャ不変条件チェック (= 兄弟 tool).claude/harness/src/tech-debt/ — ルール実装 (1 file = 1 rule).claude/harness/baselines/tech-debt-*.json — per-rule baseline (= legacy debt 凍結)