메뉴
TenkaCloud tech-debt analyzer を実行し、test smell / 結合漏れ / magic number 等の技術的負債を検出する。コード品質、テスト改善、リファクタの優先順位、技術的負債バックログを訊かれたときに使う。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
本体（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 凍結)