메뉴
.claude 配下のスキル・フック・設定をサプライチェーン成果物として監査するスキル。harness のスキル invariant (frontmatter 検証 / 隠し指示検出 / 危険実行パターン) の全件スキャンと、機械検査で拾えない「宣言と実態の乖離」のレビューチェックリストを実行する。スキルの新規追加・更新時、サードパーティスキルの導入前、定期監査に使う。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Issue、ADR、設計メモ、実装計画、PR diff、指定 path に対し、書かれていない前提、producer / consumer の未接続、実運用だけで露出する failure path をコードと設定の証拠付きで探索する review-only スキル。実装前、設計レビュー、PR 前に未知や blocker を確認するときに使う。
プロジェクトを Bun + Hono（バックエンド）+ Vite + React（フロントエンド）+ Biome でスキャフォールドする初期化スキル。テンプレートを clone した直後の初回セットアップ時に、ユーザーが明示的に実行する。
新機能をヒアリング → 仕様化 → Issue 作成 → 5 役割並列実装の順で進める機能開発オーケストレーションスキル。「○○を作って」「○○機能を追加して」など新機能・機能拡張の実装依頼を受けたら、直接実装を始めずに必ず最初に使う。
docs/architecture/harness.md の invariant を機械的に検証するスキル。引数なしで `--staged --fail-on=error` (PR 直前用)、`full` で全件スキャン、`why <RULE_ID>` で invariant の意図を harness.md から引いて表示。コミット直前・Stop hook・PR 作成前ゲート・invariant 違反の調査に使う。
PR の主目的から外れた発見・改善・技術的負債を「フォローアップ」として記録、列挙、解消管理するスキル。スコープクリープを防ぎ、scope 外の課題を別 PR で確実に処理する仕組み。引数なしで起動すると未処理一覧、`add <title>` で追加、`resolve <id> <pr-url>` で解消記録、`list-pr-body` で PR 本文に貼る markdown を出力。作業中に scope 外の改善点・技術的負債・バグを見つけたら必ず使う。
| name | skill-audit |
| description | .claude 配下のスキル・フック・設定をサプライチェーン成果物として監査するスキル。harness のスキル invariant (frontmatter 検証 / 隠し指示検出 / 危険実行パターン) の全件スキャンと、機械検査で拾えない「宣言と実態の乖離」のレビューチェックリストを実行する。スキルの新規追加・更新時、サードパーティスキルの導入前、定期監査に使う。 |
| argument-hint | [pre-install <path-or-url>] |
| allowed-tools | Read, Write, Grep, Glob, Bash(bun scripts/architecture-harness.ts:*), Bash(bun test scripts:*), Bash(git clone:*), Bash(ls:*), Bash(mkdir:*), Bash(cp:*) |
スキル・フックはモデルのコンテキストに注入される実行可能な指示であり、npm パッケージと同じくサプライチェーンの一部として扱う (正本: ADR-0002)。本スキルは「機械検査」と「目視レビュー」の 2 層で監査する。
bun scripts/architecture-harness.ts --fail-on=warning で全件スキャン (スキル invariant を含む)。/follow-up add で記録する。| Invariant | 検出対象 |
|---|---|
INVARIANT_SKILL_FRONTMATTER_VALID | frontmatter 欠落、name とディレクトリ名の不一致、description の過不足 |
INVARIANT_SKILL_NO_HIDDEN_INSTRUCTIONS | ゼロ幅/双方向 Unicode、base64 ブロック、HTML コメント |
INVARIANT_SKILL_NO_EXFIL_EXEC | リモート取得のシェルパイプ実行、base64 デコード実行 |
意図の確認は /architecture-harness why <RULE_ID> で行う。
SkillSpector が LLM で行う意味解析の代替。スキルごとに以下を確認する。
allowed-tools が本体で実際に使うツール・コマンドと一致しているか。過剰宣言 (使わないツールの許可) も過少宣言 (本体が暗黙に要求) も直す。pre-install <path-or-url> — サードパーティスキルの導入前検査外部スキルを .claude/skills/ に入れる前に、必ず隔離された場所で監査する。
git clone <url> /tmp/skill-candidate などで リポジトリ外 に取得する (先に .claude/skills/ へコピーしない)。
取得物の SKILL.md・同梱スクリプトを Read で全文確認する。
検査用ディレクトリに .claude/skills/<name>/SKILL.md 構造で配置し、--skills-only でスキャンする。このモードは INVARIANT_SKILL_* だけを実行し、bunfig.toml 等のリポジトリ前提 (REPO_CHECKS) を要求しない。
mkdir -p /tmp/skill-audit/.claude/skills/<name>
cp -R /tmp/skill-candidate/. /tmp/skill-audit/.claude/skills/<name>/
bun scripts/architecture-harness.ts --skills-only --root=/tmp/skill-audit --fail-on=warning
SKILL.md 単体ではなく候補ディレクトリ全体をコピーする。同梱スクリプト・参照ファイルこそ INVARIANT_SKILL_NO_EXFIL_EXEC の主な検査対象になる。
上記チェックリストを適用し、問題なしと判断してから .claude/skills/ へ移す。
より深い検査が必要な場合は NVIDIA SkillSpector を単発実行する (uvx skillspector scan <dir> --no-llm)。Python/uv が必要なため CI には常設しない (理由は ADR-0002)。
スキル・フック・settings.json を変更した PR では本スキルの Quick Workflow を必ず通す。変更がなくても、テンプレート更新の節目で全件スキャンを流す。