failure-logging
アプローチ失敗時・同じ問題で繰り返しつまずいた時に使用。失敗の履歴を構築し同じ失敗を繰り返さない。コマンドの実行エラーは failure-log フックが自動記録するため、本スキルは判断を要する記録・分析・参照を担当する。「また失敗した」「同じエラーを繰り返す」「前も詰まった」で発動。
systematic-debugging
バグやテスト失敗に遭遇した際に使用。修正前の4フェーズ根本原因分析を強制。「エラーが出る」「動かない」「落ちる」「なぜ失敗するか」で発動。
fix
Bug fixing, failing tests, runtime errors, unexpected behavior, regression repair. First reproduce and identify root cause. Do not use for new features. Front-load this description for Codex implicit matching; explicit invocation via $fix always works.
arch
クラス・モジュールのアーキテクチャ設計時に使用。レイヤー構造の決定、コンポーネントの配置、モジュール/レイヤー間の責務分割、合成と継承の判断、依存関係の整理をカバー。新規コンポーネント追加や既存設計のリファクタリング時に発動。「レイヤー構造」「合成と継承」もトリガー。常に守る不変条件は hierarchical-architecture ルール、疑似コードからのインターフェース起こしは interface-first-design スキルを参照。
bug-hunt
Gitのstagedまたはunstaged差分には必ず1件以上の実害バグがある前提で、差分・周辺コード・契約・テスト・実行結果を多角的に調査し、再現可能なバグを最低1件以上特定する。"バグの間違い探し"、"差分からバグを見つけて"、"staged/unstagedを疑って"、"必ず1件バグがある"、"変更コードを壊しに行って"で発動。単なるスタイル指摘や一般的コードレビューには使わない。
codex-handoff
Create a compact continuation handoff for Codex sessions, compaction, or task transfer. Front-load this description for Codex implicit matching; explicit invocation via $codex-handoff always works.
commit-msg
Generate Conventional Commits message proposals from staged diff. Never run git commit. Front-load this description for Codex implicit matching; explicit invocation via $commit-msg always works.
consult
実装中に判断が必要になった時、技術選定・設計相談が必要な時に使用。相談テンプレートで構造化された問題提示を強制。「どっちがいい」「どう設計するか」「迷ってる」「技術選定」「比較して」もトリガー。
deep-review
High-risk or multi-file code review using security, performance, and maintainability perspectives. Use for 'deep review', large diffs, auth/secrets/DB/API, or release gates. Front-load this description for Codex implicit matching; explicit invocation via $deep-review always works.
design-team
規模の大きいタスクの設計段階で、Architect (構築役) と Devil's advocate (反対役) を独立 subagent として並行起動し、指示から抜けた視点/選択肢/死角を炙り出してから設計を確定する。互いの出力を見せずアンカリングを防ぎ、本体が突合して統合設計を作り 2nd round で再レビューさせる。「設計チーム」「死角を洗い出して設計」「devil's advocate」で起動。方針自体の go/no-go は premise-questioning、単一視点の設計手順は arch を使う。
empirical-prompt-tuning
agent 向けテキスト指示（skill / slash command / task プロンプト / AGENTS.md 節 / コード生成プロンプト）を、バイアスを排した実行者に動かしてもらい、両面（実行者の自己申告 + 指示側メトリクス）で評価して反復改善する手法。改善が頭打ちになるまで回す。プロンプトや skill を新規作成・大幅改訂した直後、またはエージェントの挙動が期待通りにならない原因を指示側の曖昧さに求めたいときに使う。
explain
Explain code structure, data flow, dependencies, and change points. Do not edit files. Front-load this description for Codex implicit matching; explicit invocation via $explain always works.
feat
Feature implementation, new behavior, or product change. Use for 'implement', 'add', 'create', 'feat', UI/API changes. Do not use for pure bug fixes or explanation-only tasks. Front-load this description for Codex implicit matching; explicit invocation via $feat always works.
feature-pruning
個別機能 / UI 要素 / API エンドポイント / データ列の要否を機能名レベルで検証する skill。「このページネーション要らない」「この保存ボタン要らない」「この確認ダイアログ要らない」「この検索ボックスはブラウザ Cmd+F で済む」級の具体指摘を出す。3 手法 (YAGNI Probe / Convention Audit / Existing Substitute) を独立 subagent に投げて 3 ラウンド以上検証し、機能ごとに採点して過剰機能 / 代替可能機能リストを出す。premise-questioning が方針自体の妥当性を扱うのに対し、本 skill は **方針が採用された後の機能粒度の棚卸し専用**。empirical-prompt-tuning のバイアス排除手法を踏襲。
implementation-router
Classify implementation tasks by risk and route to feat, fix, refactor, test, review, or consult. Front-load this description for Codex implicit matching; explicit invocation via $implementation-router always works.
interface-first-design
機能追加・クラス設計・interface設計・依存関係整理・クラス/メソッドの責務分割時に使用。疑似コードから interface→クラス→TDD→実装の順で設計する。TDDスキルの前段。「インターフェースから設計」「疑似コードで設計」もトリガー。
measure
【計測実務】パフォーマンス最適化やプロファイリング時に使用。計測手法、プロファイラ/APM でのボトルネック特定、負荷テスト、レポート出力をカバー。
optimize
【最適化の判断】実行時パフォーマンス最適化の思考プロトコル。推測による最適化を拒否し計測を最優先する。「速くしたい」「遅い」「重い」「ボトルネック」「最適化」「パフォーマンス改善」「スケールしない」「p99が悪い」「メモリが膨らむ」「GCが頻発」「CPU張り付く」「タイムアウト」「レイテンシ削減」「スループット向上」「もっと速く」「なぜ遅い」などの語、または相手が具体的な最適化提案 (キャッシュ追加 / 並列化 / インデックス追加 / アルゴリズム変更 / 言語切替 / サーバー増強 等) を出してきた際の妥当性検証時に発動。計測を最優先し、上流に遡り、暗黙の前提を疑い、層を横断して案を生成し、軽い案を優先し、帰結を予測する。
orchestrate
仕様が固まった複数 task の実装を、計画 → subagent 実装 → 2 段階レビュー (仕様適合 → 品質) で一気通貫に回す。task に分解できる機能追加・改修をまとめて自走実装したいときに使う。「実装計画」「計画立てて」「plan して」「まとめて実装」「全部作って」「順番に実装」「タスク分解」「subagent で回す」「2 段階レビュー」で起動。単発の小修正 (→ feat/fix) や設計未確定 (→ consult) では使わない。
plan
Planning-only mode for 2-3 options and a recommendation. Do not edit files. Front-load this description for Codex implicit matching; explicit invocation via $plan always works.
plugin-install
Install the local dotfile-work Codex plugins into the personal marketplace source. Front-load this description for Codex implicit matching; explicit invocation via $plugin-install always works.
plugin-sync
Synchronize codex assets into the local plugin bundle and verify plugin packaging. Front-load this description for Codex implicit matching; explicit invocation via $plugin-sync always works.
premise-questioning
設計判断・新規実装・バグ修正に着手する直前に、その方針そのものを「そもそも論」で問い直す skill。「本当に解くべき問題か」「その実装は本当に要るか」「隠れた前提が崩れたら何が起きるか」を、毎回違う手法 (第一原理 / Inversion / 5 Whys) を独立 subagent に投げて 3 ラウンド以上検証し、3 軸スコアで採用可否を判定する。**戦略レベルの方針妥当性専用**。個別機能 / UI 要素 / API の要否検証は feature-pruning skill を使う。empirical-prompt-tuning のバイアス排除手法を踏襲。
probe
【手計装での位置特定】性能ボトルネックの位置を、仮説を立てて計測用ログを実コードへ挿入し、実際に動かしてログから問題部位を洗い出してから最適化する手技スキル。プロファイラが使えない/粒度が粗い/特定パスだけ計りたい場面で使う。「どこが遅いか分からない」「計測ログを仕込みたい」「仮説を立てて当たりを付けたい」「自前で計装したい」「ボトルネックの位置を特定したい」などの語で発動。複数仮説/複数パスへの計装は subagent 並列で分散する。
refactor
Behavior-preserving refactoring, structure cleanup, naming, extraction, duplication removal. Do not use when behavior, public API, or data model changes. Front-load this description for Codex implicit matching; explicit invocation via $refactor always works.
refactoring
振る舞いを変えずにコード構造を改善する際に使用。「リファクタ」「整理して」「きれいにして」「重複を消す」「関数を分割」で発動。
review
Code review for a diff, file, PR, or implementation result. Use for 'review', 'check', 'inspect'. Escalate to deep-review for high-risk diffs. Front-load this description for Codex implicit matching; explicit invocation via $review always works.
rules-compliance-review
Use after code changes, before final answers, or whenever rules/*.md compliance is uncertain. Runs deterministic rules-enforce first, then performs a semantic audit of codex/rules/*.md against the current diff. Do not use as a replacement for hooks; use it as the human/model-level second pass.
rules-required
Select and apply only the markdown rules relevant to the current task. Use when task or project instructions require rules, applicable rules are unclear, or a rules guard requests reactivation. Front-load this description for Codex implicit matching; explicit invocation via $rules-required always works.
security-review
Security-only review for auth, authorization, secrets, input validation, injection, XSS, SSRF, path traversal, unsafe deserialization, CORS/CSRF. Front-load this description for Codex implicit matching; explicit invocation via $security-review always works.
semantic-generation
|
tdd
機能実装やバグ修正でテストを書く・変更する作業に使用。RED-GREEN-REFACTORサイクルを適用する。「TDD」「テストから書く」「テスト駆動」「テスト先に」で発動。
test-coverage-guard
既存テストの信頼性を検証し、偽陽性を検出・排除するガードレール。テストがGREENになった後に発動する。「このテスト信頼できる?」「偽陽性」「カバレッジ稼ぎ検出」で発動。
test
Add or improve tests for existing behavior or new specification. Use for unit/integration test additions. Do not use for CI-only changes. Front-load this description for Codex implicit matching; explicit invocation via $test always works.