| name | run-spec-drift-triage |
| description | spec-drift issue が起票され diff トリアージが必要なとき、C11 が再構成した issue 単位の完全 diff を hunk 化し name/type/required/enum/semantics 各軸の影響を before/after/evidence 付きで判定して triage-report を出したいときに使う。 |
| disable-model-invocation | false |
| user-invocable | true |
| argument-hint | [--issue NUMBER] [--events FILE] |
| arguments | ["issue","events"] |
| kind | run |
| prefix | run |
| effect | local-artifact |
| owner | team-platform |
| since | "2026-07-13T00:00:00.000Z" |
| version | 0.1.0 |
| source | plugins/spec-drift-guardian/skills/run-spec-drift-triage/ |
| source-tier | internal |
| last-audited | "2026-07-13T00:00:00.000Z" |
| audit-trigger | official-update |
| responsibility_refs | ["prompts/R1-elicit.md","prompts/R2-parse.md","prompts/R3-triage.md"] |
| reference_refs | ["references/resource-map.yaml"] |
| script_refs | ["../../scripts/aggregate-issue-diffs.py","../../scripts/parse-spec-diff.py","../../scripts/map-field-impact.py"] |
| schema_refs | ["../../schemas/triage-report.schema.json"] |
| allowed-tools | ["Read","Write","Bash"] |
| responsibilities | [{"id":"R1","name":"elicit","prompt_required":true},{"id":"R2","name":"parse","prompt_required":true},{"id":"R3","name":"triage","prompt_required":true}] |
| combinators | ["with-goal-seek","with-feedback-contract"] |
| goal_seek | {"engine":"inline","fork":"subagent","max_loops":5} |
| feedback_contract | {"max_iterations":5,"criteria":[{"id":"IN1","loop_scope":"inner","verify_by":"script","text":"C11出力がcomplete=trueでcommit pair/digestを持ち、C08/C09出力のname/type/required/enum/semantics・before/after/evidence必須キー欠落が0件。"},{"id":"OUT1","loop_scope":"outer","verify_by":"test","text":"Issue"}]} |
run-spec-drift-triage
検知済み spec-drift issue の影響トリアージを行う run skill。C11 (aggregate-issue-diffs.py) がローカル git から再構成した issue 単位の全未triage完全 diff を、C08 (parse-spec-diff.py) で hunk 化し C09 (map-field-impact.py) で影響候補へ写像したうえで、name/type/required/enum/semantics 各軸の影響を before/after/evidence 付きで判定し、triage-report schema 準拠の JSON を emit する。提案・適用 (C02)・独立判定 (C03) はやらない。
Purpose & Output Contract
目的 (goal): C11 が再構成した issue 単位の全未triage完全 diff を hunk 単位で構造化し、artifact kind/path と name/type/required/enum/semantics 各軸への影響を before/after/evidence 付きで判定したトリアージレポートを生成した状態にする。
背景 (purpose_background): spec-drift issue の影響判定 (step2) が人手依存であり、spec-diff-history.md の 80 行 preview だけでは Issue #17 の 945 行完全差分を判定できない。C11 の commit pair 再構成と C09 の 4 軸 + semantics 写像により、取りこぼしと判断ブレを防ぐ。
入力 (境界・厳守):
--issue NUMBER — 対象 GitHub issue 番号。--events FILE — gh issue metadata / comment timestamps と spec-diff-history.md 見出し (索引としてのみ使用) から組み立てたイベント表。実 diff はローカル git commit pair から復元する (network=false)。- 入力の正体は「C11 がローカル git から再構成した全未triage完全 diff」。検知・issue 起票は既存 workflow (
update-yaml-spec.yml / ref-yaml-spec-fetcher) の責務であり、本 skill は行わない。
出力:
$CLAUDE_PROJECT_DIR/.spec-drift/<issue>/triage-report.json — ../../schemas/triage-report.schema.json 準拠。issue / base_commit / source_commit / diff_sha256 / complete / impacts[] (artifact_kind / artifact_path / axis / before / after / impacted / evidence) を持つ。- 完了レポート (日本語、JSON キー・CLI 引数・軸名は英語)。
完了条件: C11 出力が complete=true かつ commit pair / digest を伴い、C08/C09 の必須キー欠落 0 件 (IN1) で、triage-report が schema 準拠かつ 4 軸 + semantics の判定が fixture matrix に対し threshold 内 (OUT1) を満たす。
やらないこと (boundary):
- 完全性 (
complete=true) を証明できない入力は判定しない (fail-closed)。truncated preview / digest 不一致 / commit 欠落は triage せず理由付きで停止する。
- 更新提案・実適用は C02 (
run-rubric-sync) の責務。
- 生 diff からの独立再導出・照合は C03 (
spec-impact-verifier) の責務。本 skill の出力は C03 が独立に照合する対象であって、自ら再判定はしない。
- commit / PR / issue close は行わない。
決定論段 (Bash) と意味判断 (LLM) の二層分離
再現性が要る変換は 3 つの決定論 script が担い、LLM は意味判断のみ (軸判定の妥当性確認・レポート組み立て) に限定する。写像規則は ../../references/field-impact-map の SSOT を C09 が読むだけで、LLM はこれを hardcode・改変しない。
| 段 | 実体 | 役割 | fail-closed 条件 |
|---|
| C11 集約 | python3 $CLAUDE_PLUGIN_ROOT/scripts/aggregate-issue-diffs.py --issue N --events FILE | issue 単位の未triage全 diff を完全 commit diff として時系列集約 | 欠落 / 曖昧照合 / shallow clone / digest 不一致 (exit≠0) |
| C08 hunk化 | python3 $CLAUDE_PLUGIN_ROOT/scripts/parse-spec-diff.py --stdin | C11 stdout を verbatim で受け untriaged_entries を選別し unified hunk 単位へ構造化 (commit pair / digest 継承) | complete=false / digest 不一致 / commit pair 混在 (exit2)、入力形状不正・JSON parse 失敗 (exit1) |
| C09 写像 | python3 $CLAUDE_PLUGIN_ROOT/scripts/map-field-impact.py --stdin | hunk から artifact kind/path と 4 軸+semantics の before/after/evidence 候補へ写像 | 必須キー欠落 / 写像表不備 (exit≠0) |
LLM が担うのは、C09 の影響候補が実 hunk 証拠と整合するかの軸判定の妥当性確認と、schema 準拠の triage-report への組み立てのみ。base_commit / source_commit / diff_sha256 / complete は C11 が算出した provenance をそのまま転記し、LLM が再計算しない (C03 verdict と一致必須のため)。
End-to-End Flow (責務プロンプト正本 = prompts/*.md)
[R1 elicit] gh issue metadata/comment + spec-diff-history 見出し(索引) → events FILE
→ aggregate-issue-diffs.py --issue N --events FILE
→ entries / untriaged_entries / source_provenance (complete=true, base/source/digest)
─[complete 証明できなければ fail-closed で停止]─▶
[R2 parse] untriaged 完全 diff → parse-spec-diff.py --stdin → hunks JSON (commit pair/digest 継承)
→ map-field-impact.py --stdin → 影響候補 (artifact kind/path, 4軸+semantics, before/after/evidence)
─[必須キー欠落 0 件が IN1]─▶
[R3 triage] LLM: 各軸判定を hunk 証拠と照合し妥当性確認 → triage-report 組み立て
→ $CLAUDE_PROJECT_DIR/.spec-drift/<issue>/triage-report.json
- R1-elicit (
prompts/R1-elicit.md): 対象 issue を確定し、events FILE を組み立て、aggregate-issue-diffs.py で未triage 全 diff 集合を集約する。complete=true と commit pair / digest を確認できないときは判定に進まず停止する。
- R2-parse (
prompts/R2-parse.md): 集約 diff を parse-spec-diff.py --stdin で hunk 化し、map-field-impact.py --stdin で影響フィールド候補へ写像する。exit2 (complete=false / digest 不一致) は fail-closed。
- R3-triage (
prompts/R3-triage.md): C09 候補の各軸 (name/type/required/enum/semantics) を hunk 証拠と照合し、impacted と before/after/evidence を確定して schema 準拠の triage-report.json を emit する。
Key Rules
- 完全性優先 / fail-closed:
complete=true かつ digest 一致を証明できない入力は判定しない。truncated preview は必ず fail-closed。
- provenance 転記:
base_commit / source_commit / diff_sha256 / complete は C11 出力を verbatim 転記し、LLM が再計算・改変しない。
- 写像非 hardcode: diff→フィールド写像は C09 が
references/field-impact-map を読むだけ。LLM は写像規則を prompt に埋め込まない (guardian 自身の drift 源化を防ぐ)。
- 軸網羅: name / type / required / enum / semantics の 5 軸を各 hunk で評価する。
impacted=false の軸も evidence 付きで列挙してよい (schema 許容)。
- 境界厳守: 提案・適用 (C02)・独立判定 (C03)・issue close はしない。出力はトリアージまで。
- 単一 writer:
.spec-drift/<issue>/triage-report.json への書込は本 skill のみ。上書き前に既存内容と issue/digest 整合を確認する。
- 日本語成果物: レポート本文は日本語。JSON キー・CLI 引数・軸名 (name/type/required/enum/semantics) は英語。
Feedback Contract (with-feedback-contract / with-goal-seek)
- IN1 (inner, script): C11 出力が
complete=true で commit pair / digest を持ち、C08/C09 出力の name / type / required / enum / semantics・before / after / evidence 必須キー欠落が 0 件。検証は 3 決定論 script の exit code (C11≠0 / C08 exit2 / C09≠0 で不成立) で機械判定する。
- OUT1 (outer, test): Issue #17 完全 commit pair と source-category fixture matrix に対し 4 軸 + semantics の誤検出 / 見逃しが threshold 内で、truncated preview 入力は fail-closed になる。
- goal-seek (engine=inline, fork=subagent, max_loops=5): IN1 / OUT1 を満たすまで、events 再構成・軸判定の妥当性確認・レポート組み立てを反復改善する。fork=subagent で独立 context で評価し Sycophancy を避ける。max_loops=5 で未収束なら residual findings 付きで停止し fail-closed 状態を報告する。
Gotchas
- preview を diff と誤認しない:
spec-diff-history.md の 80 行 preview はイベント日時の索引にのみ使う。実 diff は必ず C11 が commit pair から復元したものを使う。
- triage 済みを再集約しない: 集約対象は
entries (issue の全 diff 履歴) ではなく untriaged_entries (未処理のみ)。C08 は C11 stdout を verbatim で受け取り untriaged_entries を自ら選別するため、再ラップも最新 1 件固定も不要 (entries を渡すと triage 済みまで再集約する)。
- digest を跨いで混ぜない: triage-report は
base_commit/source_commit/diff_sha256 を各 1 個しか持てない (単一 digest 契約・C03 verdict と一致必須)。積層できるのは 1 commit pair 内の複数ファイル・複数 hunk までで、untriaged が複数 commit pair に跨る入力は C08 が集約せず fail-closed (exit2) する。同一 commit pair が履歴に重複しても C08 が dedup するので二重計上しない。
- 複数 commit pair の issue は分割する: 出力先
.spec-drift/<issue>/triage-report.json は issue 単位で 1 本 (単一 writer)。1 issue に複数 commit pair の未triage変更が溜まった場合、同じパスへ上書きすると先の triage 証跡を失うため、issue を commit pair 単位へ分割してから triage する (C10 も --triage-report 単数 + digest 一致必須のため、1 issue = 1 commit pair が close 可能な形)。
- impacted の根拠必須:
impacted=true も false も evidence (hunk 抜粋・行番号) を空にしない (schema minLength:1)。
- context 予算: SKILL.md / 各 prompt は簡潔に保つ。
references/resource-map.yaml を最初に読み、必要ファイルのみ open する。
Additional Resources
references/resource-map.yaml を最初に読む。主要参照:
../../scripts/aggregate-issue-diffs.py (C11) — issue 単位の完全 diff 集約。--issue NUMBER --events FILE../../scripts/parse-spec-diff.py (C08) — 集約 diff の hunk 化。--stdin../../scripts/map-field-impact.py (C09) — hunk→4 軸+semantics 影響候補写像。--stdin../../references/field-impact-map — C09 が読む diff→フィールド写像表 (read-only / 本 skill は改変しない)../../schemas/triage-report.schema.json — 出力契約スキーマprompts/R1-elicit.md / prompts/R2-parse.md / prompts/R3-triage.md — R1/R2/R3 責務別プロンプト (7 層)- 消費先: C03 (
spec-impact-verifier) が独立照合 / C10 (check-triage-complete.py)・C07 (guard-spec-drift-close.py) close gate が消費
