Menú
Capability 7 kind を新規作成・更新するとき、CapabilityManifest と plugin-composition.yaml を整備するときに使う。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
YAML仕様が変わったか確認するとき、公式仕様との差分を確認するときに使う。
北原さん式ナレッジソースの差分を検知したいとき、6カテゴリへ分類・格納してナレッジを同期したいときに使う。
rubric変更を提案するとき、rubric改正を施行するときに使う。
トリアージで影響ありと判定された spec-drift issue の rubric/schema/template を同期したいとき、propose(read-only)で最小 Edit 差分と pre-image hash を提案し apply で監査 PASS と明示承認後に allowlist 対象だけを適用したいときに使う。
spec-drift issue が起票され diff トリアージが必要なとき、C11 が再構成した issue 単位の完全 diff を hunk 化し name/type/required/enum/semantics 各軸の影響を before/after/evidence 付きで判定して triage-report を出したいときに使う。
週報・月報・期報の目標設定をしたいとき、振り返り対話を北原さん式の統一ハイブリッド構造で作成したいときに使う。
| name | run-build-skill |
| description | Capability 7 kind を新規作成・更新するとき、CapabilityManifest と plugin-composition.yaml を整備するときに使う。 |
| triggers | ["skill作成","skill更新","agent作成","hook配線","slashcommand作成","plugin-composition編集","prompt生成","workflow定義"] |
| disable-model-invocation | false |
| user-invocable | true |
| argument-hint | [skill-name] [kind?] [--mode create|update] [--with-subagent] [--with-prompts] [--with-evaluator] [--with-hooks] [--with-knowledge index-search|router-registry] [--verification-profile incremental|exhaustive|build-only] [--model opus|sonnet] |
| arguments | ["skill_name","kind","mode","with_subagent","with_prompts","with_evaluator","with_hooks","with_knowledge","verification_profile","model"] |
| allowed-tools | ["Read","Write","Edit","Grep","Glob","Bash(python3 *)","Skill(assign-skill-design-evaluator *)"] |
| pair | assign-skill-design-evaluator |
| kind | run |
| prefix | run |
| effect | local-artifact |
| owner | team-platform |
| since | "2026-05-17T00:00:00.000Z" |
| version | 0.3.0 |
| manifest | workflow-manifest.json |
| responsibility_refs | ["prompts/R1-scaffold.md","prompts/R2-responsibility-emit.md","prompts/R3-template-select.md","prompts/R4-trace-write.md"] |
| template_refs | ["templates/agent-skeleton.md","templates/hook-skeleton.md","templates/command-skeleton.md","templates/plugin-composition-skeleton.yaml","templates/prompt-skeleton.md","templates/workflow-skeleton.md","templates/task-graph-engine/scripts/ready-set-from-checklist.py","templates/task-graph-engine/scripts/self-reflect-append.py","templates/task-graph-engine/scripts/extract-capability-dependency-graph.py","templates/task-graph-engine/scripts/record-capability-graph-knowledge.py"] |
| schema_refs | ["references/capability-manifest.schema.json","schemas/verification-contract.schema.json","schemas/verification-evidence.schema.json"] |
| prompt_format | markdown |
| script_refs | ["scripts/render-combinators.py","scripts/render-frontmatter.py","scripts/validate-naming.py","scripts/build-subagent.py","scripts/validate-build-trace.py","scripts/lint-goal-seek.py","scripts/lint-capability-graph-knowledge.py","scripts/lint-ssot-duplication.py","scripts/derive-route-build-obligations.py","scripts/derive-verification-contract.py","scripts/plan-verification-obligations.py","scripts/record-verification-evidence.py"] |
| reference_refs | ["ref-skill-glossary","ref-task-context-map","ref-output-routing","ref-knowledge-loop","references/reproducibility-trace-schema.md","references/goal-seek-paradigm.md","references/verification-obligation-protocol.md"] |
| feedback_contract | {"max_iterations":3,"criteria":[{"id":"IN1","loop_scope":"inner","text":"生成 Capability が命名/構造/frontmatter/goal-seek/completeness/ssot lint と validate-build-trace を全て exit0 で通過する","verify_by":"lint","derived_from":["CL-1","CL-2","CL-3","CL-4","CL-7","CL-9","CL-10","CL-11"]},{"id":"IN2","loop_scope":"inner","text":"skill-build-trace.json が source_docs/doc_coverage/layer_decisions/reproducibility_gates を空欄なく記録している","verify_by":"script","derived_from":["CL-6"]},{"id":"IN3","loop_scope":"inner","text":"plugin 一括 build (handoff routes 消費) では route 完了ごとの実行レポートが validate-route-build-reports.py --route/--complete を exit0 で通過する (単発 build は N/A)","verify_by":"script","derived_from":["CL-12"]},{"id":"OUT1","loop_scope":"outer","text":"machine proof後に残るsemantic obligationがcurrent fingerprintに束縛されたPASS証拠を持ち、confidence閾値以上かつhigh severity 0件","verify_by":"verification-obligation","derived_from":["CL-5"]},{"id":"OUT2","loop_scope":"outer","text":"生成物がユーザ brief のgoalを最適反映し、incrementalは未解決claimだけ、exhaustiveは30思考法catalogのadversarial auditも含めて証拠DAGが閉じる","verify_by":"verification-obligation","derived_from":["CL-8"]}]} |
| source | doc/ClaudeCodeスキルの設計書/ |
| source-tier | internal |
| last-audited | "2026-05-22T00:00:00.000Z" |
| audit-trigger | quarterly |
Phase 2 移行後は
plugins/harness-creator/skills/が正本、.claude/skills/は symlink/deploy target。ただし Step 4 等の lint コマンドは repo-root cwd 前提で実行する (bundles.json full bundle 同梱のplugins/skill-governance-lint/への repo-root 相対パスに依存)。skill 自身の資産は$SKILL_DIR経由の self-relative 参照。
ユーザー要求から Claude Code Skill を 1 本構築するワークフロー。
skill_name (kebab-case), kind (run|ref|assign|wrap|delegate), mode (create|update), 各種 --with-* フラグ, model (opus|sonnet)。フラグ仕様は schemas/build-flags.schema.json。$OUT_BASE/<name>/SKILL.md (170 行を目安・本文 300 行以下が上限 (P0-2)、frontmatter 完備、本文は日本語) / templates/ / references/ / scripts/ / prompts/ / eval-log/skill-build-trace.json / verification contract・plan・evidence receipts (既存content-review verdictも互換投影として保持)。validate-build-trace.py exit 0。build-only は未実施proofを明示し完了を偽装しない。description は発動条件のみ、trigger 2-3 個 (08章)。frontmatter.name、name に plugin 名を含めない (06/34章)。.sh / .js 新規禁止、scripts 内 yaml import 禁止 (22/28章)。--mode update は Edit 差分のみ。全書き換え禁止 (CD-002)。{{PROJECT_ROOT}} 等の変数で表現し source_trace に残す。$CLAUDE_PLUGIN_ROOT または __file__ 起点の self-relative 探索で行い、生成物の出力先は $CLAUDE_PROJECT_DIR / cwd / $CLAUDE_SKILL_OUT_BASE で解決する。plugins/harness-creator/... や .claude/skills/... は dev / fallback 表現に限定し、配布スキルの必須前提にしない。references/agent-template.md 9 セクション固定構造。assign-skill-design-evaluator へ最小sliceを渡す (09章 Goodhart)。pattern_refs / variant_axes / reuse_targets / deterministic_checks / placement_candidates / hook_events) を trace と本文へ反映 (29-35章)。manual-preflight の lint 集合の正本は $PLUGIN_ROOT/references/lint-matrix.json (context=build-preflight。Step 4 の bash ブロックはその射影で、乖離は lint-matrix-sync.py が CI で fail。28章: A/B 強制 gate と呼称分離)。lint-ssot-duplication.py は編集前に対象プラグイン全体を重複解析する事前ゲート (両方残し禁止・上書き一本化の判断材料)。検出は DUP-SCHEMA-ID (同一 $id=正本曖昧, exit1 で fail) / REDIRECT-FAT-BODY / DUP-REQUIRED-SET / DUP-PASSAGE (後 3 者は smell、build 時は warn・CI の --strict で fail 化) の 4 種。build Step4 は早期警告、強制は governance-check.yml の --strict 実行が担う。
validate-build-trace.py が source_docs / build_flow_coverage / doc_coverage / layer_decisions / reproducibility_gates の空欄・未読・N/A 理由なしを拒否。
context 予算 (CD-005): 同時 Read は 3 章まで。references/resource-map.yaml で task category → 章選択。
ch15/ch16 公式参照確認は必須 (Step 1 冒頭)。
26/27/28 章 / 29-35 章ゲートは N/A 理由つきで省略可、未記入は不可。
prompt 形式: 新規 prompt は Markdown (.md) を既定とし、prompts/<R-id>-<slug>.md で生成する。骨格は plugins/prompt-creator/skills/run-prompt-creator-7layer/references/seven-layer-markdown-template.md を写経。YAML (.yaml) は既存資産のみ許容し、新規作成は禁止 (warn を発する)。
Capability 7 kind 統一: skill / agent / hook / command / plugin-composition / prompt / workflow の全 kind で CapabilityManifest commonCore を必須とする。必須項目集合の正本は references/capability-manifest.schema.json#/definitions/commonCore.required 唯一（本文に再掲しない＝SSOT。現行は name / description / kind / version / owner の5項目。since / source-tier 等は任意）。kind 別追加フィールドは同 schema の definitions/<kind> を参照。commonCore 欠落は validate-frontmatter.py が exit 1（同 lint は必須集合を schema から動的ロードし、--self-test で正本との drift を検出）。
ゴールシーク必須 (固定手順禁止): ループ実行系 kind (run / wrap / delegate / orchestrator / agent / agent-team / hook-integrated) は達成手順を固定列挙せず、## ゴールシーク実行 (Goal + 目的/背景 + 完了チェックリスト + ゴールシークループ) で構成する。手順は実行時に AI がチェックリストの未達項目から都度生成する。assign-* は評価系のため Goal/Checklist 形は使うが runtime loop は配線しない。ref-* (read-only) は対象外で ## 手順 は「参照用。手順なし。」のまま。正本定義は references/goal-seek-paradigm.md。lint は lint-goal-seek.py (固定 ### Step N: の連番羅列を実行系本文で検出したら violation)。
render-combinators.py が with-goal-seek.patch をdefault-ON で自動適用し (--no-goal-seek で opt-out)、frontmatter goal_seek: と ### ゴールシーク配線 を注入する。周回状態は schemas/goal-seek-loop.schema.json 準拠の eval-log/<skill>-progress.json に記録し、重い周回は Skill(run-goal-seek) に fork 委譲する。assign-* は checklist のみ (ループ非配線)。lint-goal-seek.py は loop 実行系に対し二値チェックリスト項目の存在・曖昧語不在を violation、### ゴールシーク配線 不在を warning で検査する。フラグ仕様は schemas/build-flags.schema.json#/properties/with_goal_seek。goal_seek.engine は独立 combinator flag ではなく with-goal-seek 内の選択値。loop kind (run/wrap/delegate) の既定は task-graph (量産ハーネスは既定で依存順駆動+self-reflect。Step 10.6・with-goal-seek.patch default 準拠)、opt-down で inline(自己完結)・run-goal-seek(重量オーケストレータへ任意 fork) を明示選択する。task-graph は checklist の depends_on を依存充足順に消費し (ready-set-from-checklist.py で ready 集合の最小 id を拘束選択=依存順が「助言」でなく「拘束」)、実行中の新規タスクを self-reflect-append.py で checklist 末尾へ自己反映し (別状態ファイル新設せず progress.json を唯一の truth に保つ)、cross-surface dependency graph knowledge を extract-capability-dependency-graph.py/record-capability-graph-knowledge.py で抽出・記録・consult する engine 変種。同梱は Step 10.6 の決定論 materializer と build-plan required_deliverables で機械化し、欠落/byte drift/profile driftを --check で拒否する。現 profile は engine_profile=checklist-graph / full_task_spec_graph=false であり、plugin-dev-planner の task-specs→graph→envelope/state/projection→spec-improvement outer loop と同等とは扱わない。kind → templates/_base + combinator 対応表は schemas/template-selection.schema.json#/selection_rules を正本とする (本文に再掲しない)。
本 Skill は固定手順ではなく、下記ゴールへ向けて完了チェックリストの未達項目を埋める手順を都度生成して反復する。下記「局面カタログ」は順序固定の手順ではなく、未達項目に応じてループが選ぶ局面メニュー。正本:
references/goal-seek-paradigm.md。
対象 Capability (7 kind) が、全ゲート (命名/構造 lint・frontmatter・goal-seek/completeness lint・trace exit0・score>=80 かつ high=0) を満たす再利用可能な成果物として $OUT_BASE/<name>/ に生成・更新され、eval-log/skill-build-trace.json が同一 brief→同一判断順序の再現性を証跡化している状態。
量産対象は kind・ドメイン・出力先が多様で、固定手順は前提が崩れると破綻する。ゴール (= 全ゲート PASS) とチェックリストを到達点に固定し、手順は未達項目から都度導出することで、多様な Capability を同一基盤で再現性高く構築できる。
references/capability-manifest.schema.json#/definitions/commonCore.required: name/description/kind/version/owner) を生成した completeness_exempt 理由付き宣言のいずれかで満たした (lint-skill-completeness.py exit0) lint-goal-seek.py + lint-skill-completeness.py + lint-ssot-duplication.py + validate-build-trace.py が exit 0 assign-skill-design-evaluator の score>=80 かつ high=0 eval-log/skill-build-trace.json に source_docs/doc_coverage/layer_decisions/reproducibility_gates を空欄なく記録 (未使用は N/A 理由付き)。brief 経由 build は requirement_coverage (RTM) で brief 非空フィールドの被覆を宣言 feedback_contract.criteria を brief.goal/完了チェックリストから導出し inner/outer 各1件以上を trace に記録 (ref/assign は feedback_contract.skip_reason で N/A)。各 criterion は derived_from: [CL-n] で出所チェックリスト項目を宣言 (lint-criteria-provenance.py が被覆を検査) doc/harness-coverage-spec.md) を kind 別に満たす (毎回必達):
scripts/ があれば tests/ に機能テストを追加し当該スクリプト行カバレッジ ≥80% (network/secret 系は monkeypatch で副作用遮断し純関数・分岐・エラー経路を genuine に網羅)。純 re-export shim は import 経由の間接被覆+理由記録 (coverage record への明記) で代替可。LLM eval record は補完であり機能テストの代替にはならないvalidate-llm-coverage.py --gate-new --since <today> を ≥80% で通す)source/source-tier/last-audited/audit-trigger が埋まり、参照内容が source と整合することを eval-log/coverage/skills/<plugin>__<skill>.json の ref-review verdict (verdict=PASS) で記録。ref は behavioral criteria を持たない代わりにこの source 検証が必須カバレッジ (除外でなく ref 専用パス)eval-log/coverage/ に記録eval-log/build-plan.json (validate-build-plan.py --brief ... --out eval-log/build-plan.json で brief から決定論導出) の flags が true の subagent/prompt/evaluator/hook/knowledge を全て生成し、--check が exit 0 (フラグの要否をモデル判断で省略しない) --with-knowledge or brief.knowledge_loop 指定時のみ) knowledge/ 雛形展開 + 4スクリプト同梱 + ## ナレッジループ節注入 + knowledge_loop記述子(consult_at: ["runtime"]) + lint-knowledge-loop.py exit0 (KL-001..007) __file__ 相対で自己解決する doctor 同梱 + 疎通確認はチャット委譲(/<name>-doctor or 自然文) + 生 $CLAUDE_PLUGIN_ROOT 非露出 (README 及び references/*-setup.md 等 setup 手順の bash に裸変数/repo相対を書かず fallback 形 ${CLAUDE_PLUGIN_ROOT:-plugins/<name>} へ降格。番号付きリスト内の字下げフェンスも同様)。scripts/lint-readme-plugin-root-portability.py exit0。正本 ref-cross-platform-runtime/references/runtime-portability.md 層2 eval-log/<slug>/build/route-<id>.json を記録し validate-route-build-reports.py --route <id> exit0、全 route 終端で --complete exit0 (契約正本 references/route-build-report.md) 正本 references/goal-seek-paradigm.md の 6 ステップ (現状評価→手順生成→実行→検証→Anchor Step→反復/差し戻し) に従う。本 Skill 固有の差分:
### 局面: 命名・構造 Lint / ### 局面: フォーク評価 のコマンド群で機械判定する。open_issues に残し差し戻す。詳細フローは workflow-manifest.json の phases、各責務プロンプトは prompts/<R-id>.md (Markdown 既定。legacy .yaml も読み取り可) に委譲する。下記は固定順序ではなく、ゴールシークループが未達チェックリスト項目に応じて選ぶ局面群。
本 Skill は Capability 7 kind (skill / agent / hook / command / plugin-composition / prompt / workflow) を統一抽象として扱う。以下 4 段で分岐する。
kind または brief.kind を確定。既定は skill。未指定なら Step 1 のヒアリングで決める。7 kind 以外は exit 1。schemas/build-flags.schema.json#/properties/capability_kind (7値 enum)、kind → skeleton/出力先/kind別lint の対応表の正本は references/build-steps.md §I.1 (本文に再掲しない=SSOT)。kind=skill 配下のサブ種別 5 値の template 選択は schemas/template-selection.schema.json#/selection_rules に従う。CapabilityManifest commonCore を references/capability-manifest.schema.json で検証。kind 別追加フィールド (definitions/kindSkill, definitions/kindAgent …) も同 schema で検証する。lint-agent-prompt-section.py + lint-agent-prompt-content.py --mode agent (route C02 内容 lint)、hook→lint-script-frontmatter.py、plugin-composition→lint-plugin-composition.py (整備済・CI 配線済)、prompt→lint-agent-prompt-content.py --mode prompt (route C02))。command / prompt (構造面) / workflow の kind 専用 lint (lint-command-md.py / lint-prompt-md.py / lint-workflow-md.py) は未実装 (script 実体なし・整備予定) のため起動しない — それまで当該 3 kind は共通 lint (validate-frontmatter.py 等) のみで検査する。agent/prompt 生成は本文7層 (l5-contract v2.0.0) を prompt-creator 経由で生成し route C02 を fail-closed ゲートとして通す (契約: ../../../prompt-creator/skills/run-prompt-creator-7layer/references/subagent-hybrid-format.md)。単独生成の抜け道は Step 3.5 の prompt_provenance で塞ぐ。既存「Skill のみ作る」呼び出し (
kind=run|ref|assign|wrap|delegate) は kind=skill 配下のサブ種別 として後方互換維持。引数なしまたはkindが 5 択のいずれかなら従来通り Step 1 以降の skill 専用フローへ直行する。適用範囲の宣言:workflow-manifest.jsonの phaseinit-pre(本 Step) のみ Capability 7 kind 全てに適用され、init以降の phase のkind_filterはこのサブ種別 5 値 (= kind=skill の場合) を指す。非 skill kind は init-pre で skeleton / kind 別 lint を確定し、scaffold 相当の生成 + Step 4 の kind 別 lint で完結する。
[MANDATORY] 冒頭で
Skill(ref-yaml-spec-fetcher)を呼びyaml-spec-cache.mdを Read。validate-build-trace.pyが 15/16 章未実施を exit 1 で拒否する。
resolve-skill-dirs.py で $PLUGIN_ROOT / $SKILL_DIR / $OUT_BASE を確定する。$SKILL_DIR は harness-creator plugin 内資産、$OUT_BASE は生成先であり、両者を同一パスと仮定しない。続けて references/resource-map.yaml で task category 選択 → 01章 5 要素 + 01a Step2 実行レイヤー判断表を埋める。詳細は references/build-steps.md。
蓄積知見の参照 (Loop B / build-time): brief.consult_build_knowledge が true (既定) のとき、harness-creator 自身の蓄積知見を検索し、過去の設計判断・落とし穴回避を初期設計に反映する (knowledge/knowledge-index.json の consult 宣言と対。run-skill-elicit の同名節と同形):
# パスはプロジェクトルート基準 (eval-log/ 出力と同じ規約)
python3 plugins/harness-creator/skills/run-build-skill/templates/knowledge-skeleton/scripts/search_knowledge.py \
--dir plugins/harness-creator/knowledge/ --query "<brief.goal と kind の要約>" --limit 5
検索 0 件・スクリプト不在でも build を止めない。採否は trace の layer_decisions に記録する。loop 実行系 (run/wrap/delegate) はこの時点で brief.goal と完了チェックリストから per-skill 評価基準 (feedback_contract.criteria) を test-first で導出し、Step 3.5 で trace に固定する (criteria は goal-seek checklist と同源)。
build-plan の決定論導出 (フラグはモデルが決めない): brief 確定直後に必須成果物集合を機械導出し、以降はこの plan を作業リストの正本とする。--with-* の要否・必須セクション・必須資産は brief の非空フィールドとテンプレート見出しから純関数で決まる (モデルの記憶・判断に依存しない):
python3 "$SKILL_DIR/scripts/validate-build-plan.py" --brief eval-log/skill-brief.json --out eval-log/build-plan.json
充足検査は Step 4 の --check が行う (欠落は exit 1)。brief 無しのフラグ明示 build は NOTE 付き skip。
kind → template 選択は prompts/R3-template-select.md (R3) と schemas/template-selection.schema.json に従う。骨格生成は prompts/R1-scaffold.md (R1)。COMPOSER_MODE=atomic の場合は combinator を kind → flag 順で適用。
run 系は templates/ / scripts/ / examples/、ref 系は references/articles-full.md、assign 系は references/rubric.json / scripts/render-findings-score.py。本文 100 行超は references/ へ追い出す。
投入系 (外部システムへ書込む skill) の必須参照: brief.external_systems に書込み先 (Notion/DB/API 等) がある場合、Skill(ref-output-routing) の Sink Contract (schema SSOT / 冪等 upsert / fail-closed) を Read し、その不変条件を feedback_contract.criteria と deterministic_checks へ反映する (build-plan の notes が要求。モデル知識での再発明は過去に品質ばらつきを生んだ既知の穴)。
eval-log/skill-build-trace.json を schemas/skill-build-trace.schema.json と prompts/R4-trace-write.md (R4) に従って章別記入。loop 実行系 (run/wrap/delegate) は Step 1 で導出した feedback_contract (inner/outer criteria を id/loop_scope/text/verify_by で記述) を 生成 SKILL.md frontmatter と trace の両方 に固定する。frontmatter は量産先が携帯する評価基準の正本、trace は再現性証跡。ref/assign は feedback_contract.skip_reason で N/A escape。validate-build-trace.py と lint-feedback-contract.py が kind-aware に gating する。
要望カバレッジ (RTM): brief 経由 build は requirement_coverage[] を trace に記録する。brief の非空要求フィールド (例 key_constraints[2] / boundary) ごとに disposition: mapped (+mapped_to=反映先 criteria id/生成物) か not_applicable (+reason) を宣言する。被覆完全性と requirement_id 実在は validate-build-trace.py が機械検査し (段階導入: coverage 無しは WARN)、写像の意味的妥当性は Step 12 content-review (LLM 層) が判定する。
agent/prompt 生成の provenance (route C09): agents/.md・skills//prompts/*.md を生成/更新した build は prompt_provenance を trace に記録する。prompt_creator_invocation=true (prompt-creator 経由で本文7層を生成)・source_contract_ref (準拠契約: agent=subagent-hybrid-format.md / prompt=seven-layer-format.md)・content_lint={mode, status:PASS} (route C02 lint-agent-prompt-content.py の結果) の3点を持つ。run / assign が prompt を生成する build (per_responsibility 非空) では resolved_policy=optional/skip を禁止し required+provenance を強制する (生成物があるのに optional へ降格する迂回=バイパスを封鎖)。本 build が prompt を生成しない場合 (共有 prompt を消費する等、per_responsibility 空) は optional で宣言してよい (skip は不可)。required の build ではこのブロックが必須で、validate-build-trace.py が invocation=false・契約参照欠落・content_lint≠PASS・ブロック欠落のいずれも exit1 で止める (バイパス不能性)。実際の本文7層準拠は route C02 の CI repo 全走査が trace 非依存で独立強制する。
route 実行レポート (plugin 一括 build のみ): handoff-run-plugin-dev-plan.json の routes を消費する build では、route 1 本の完了ごとに eval-log/<target_plugin_slug>/build/route-<id>.json (schemas/route-build-report.schema.json) へ実行レポートを書き、後続 route は依存 route のレポート (handover/deviations) を読んでから着手する。契約正本は references/route-build-report.md、機械検証は scripts/validate-route-build-reports.py (route 毎 --route <id> / 終端 --complete)。単発 build (route 外) は対象外。
lint 集合の正本は
$PLUGIN_ROOT/references/lint-matrix.json(context: build-preflight / p0-gate / ci)。下記 bash ブロックはその build-preflight 射影であり、集合の乖離はplugins/skill-governance-lint/scripts/lint-matrix-sync.pyが CI で fail させる (lint の増減は matrix を先に更新)。workflow-manifest.jsonは宣言的リソース (schema/prompt/reference) の正本で、lint を manifest に resource 登録はしない (責務分離)。
GOV_LINT_DIR="$(dirname "$PLUGIN_ROOT")/skill-governance-lint"
python3 "$GOV_LINT_DIR/scripts/lint-skill-name.py" "$OUT_BASE/$SKILL_NAME/SKILL.md"
python3 "$GOV_LINT_DIR/scripts/lint-skill-description.py" "$OUT_BASE/$SKILL_NAME/SKILL.md"
python3 "$GOV_LINT_DIR/scripts/lint-skill-tree.py" "$OUT_BASE/$SKILL_NAME"
python3 "$GOV_LINT_DIR/scripts/validate-frontmatter.py" "$OUT_BASE/$SKILL_NAME/SKILL.md"
python3 "$GOV_LINT_DIR/scripts/lint-script-frontmatter.py" "$OUT_BASE/$SKILL_NAME"
python3 "$GOV_LINT_DIR/scripts/lint-skill-completeness.py" "$OUT_BASE/$SKILL_NAME" # kind別必須サポート資産(prompts/references/schemas/scripts)を実在/共有正本参照/completeness_exempt理由付きのいずれかで充足。空欄(無宣言の欠落)は exit 1
python3 "$SKILL_DIR/scripts/lint-goal-seek.py" "$OUT_BASE/$SKILL_NAME/SKILL.md"
python3 scripts/lint-feedback-contract.py --changed-only # loop実行系(run/wrap/delegate)のSKILL.md frontmatterに feedback_contract.criteria(inner/outer) が無ければ fail
python3 "$SKILL_DIR/scripts/lint-ssot-duplication.py" --plugin-dir "$(dirname "$OUT_BASE")" # SSOT 重複(正本曖昧/redirect 太り/required 二重定義/本文再掲)を検出。DUP-SCHEMA-ID は exit 1
python3 "$SKILL_DIR/scripts/lint-knowledge-loop.py" "$OUT_BASE/$SKILL_NAME" # knowledge/ がある場合のみ KL-001..007 を検査(無ければ exit0 skip)。既定 warn、CI の --strict で fail 化
python3 "$SKILL_DIR/scripts/lint-capability-graph-knowledge.py" "$OUT_BASE/$SKILL_NAME" # brief.goal_seek.engine=task-graph の生成 harness のみ ENG-C06/ENG-C07 同梱・consult token・source_ref を検査(非 task-graph は not-applicable exit0・ENG-C08)
python3 "$SKILL_DIR/scripts/validate-build-trace.py" eval-log/skill-build-trace.json
python3 "$SKILL_DIR/scripts/validate-build-plan.py" --brief eval-log/skill-brief.json --check --skill-dir "$OUT_BASE/$SKILL_NAME" # brief から決定論導出した必須成果物 (flags/セクション/資産) のディスク実体を突合。brief 不在は NOTE skip
python3 scripts/lint-readme-plugin-root-portability.py # kind=plugin / README 更新時。裸 $CLAUDE_PLUGIN_ROOT・repo相対直書き・os.environ添字を検出
全て exit 0 でなければ Step 2 / 3.5 へ戻る。
Skill(assign-skill-design-evaluator) target=$OUT_BASE/$SKILL_NAME を fork 呼び、{"score":N,"findings":[...]} を受領。skill-build-trace.json も評価対象に含め、01/01a / 26-28 章漏れを C2、rubric 自己編集を C1/C4 失敗として扱う。
score >= 80 かつ high=0 で完了。それ以外は findings を本文に反映し Step 4 へ戻る (最大 3 周)。判定結果と差し戻し履歴は trace (reproducibility_gates) に記録する。
--with-subagent)build-subagent.py で .claude/agents/<skill-name>-subagent.md を派生 → lint-skill-description.py で検証。9 セクション固定構造に準拠。
--with-prompts or brief.use_prompt_creator)brief.responsibilities[] の R-id 単位 でループ。詳細は prompts/R2-responsibility-emit.md (R2) と references/prompt-placement-convention.md。
--with-evaluator or brief.generate_pair_evaluator)公式 CLI は render-frontmatter.py --out --pair --rubric-refs。詳細は references/build-steps.md#h5-evaluator-ペア生成。
--with-hooks or brief.hook_events 非空)scripts/hook-<name>-<event>.py スケルトンと settings.json マージ案を生成。自動 merge 禁止、人間承認後の手動 merge とする。
--with-knowledge or brief.knowledge_loop)生成スキルに「知識を更新・蓄積し、検索して活用し、使うほど良くなる」ループを組み込む横断 combinator。正本仕様は Skill(ref-knowledge-loop)(構築編+運用編)。手順:
ref-knowledge-loop を Read し、brief.knowledge_loop.pattern(index-search | router-registry)を確定(未指定なら §パターン選択フローで決定)。templates/knowledge-skeleton/<pattern>/ を $OUT_BASE/$SKILL_NAME/knowledge/ へ展開し、scripts/{search_knowledge,build_index,record_usage,add_entry}.py を scripts/ へコピー(注入される ## ナレッジループ 節が参照する4スクリプトと一致させる)。render-combinators.py --with-knowledge で SKILL.md に ## ナレッジループ 節と frontmatter knowledge_loop ブロックを決定論注入(検索・追加・§12活用ログ・分割閾値・consult_at を記載)。注入本文は同梱 scripts/ のみ参照し harness-creator 内部へ依存しない(配布スキル自己完結)。knowledge_loop 記述子に consult_at: ["runtime"] が入る(references/capability-manifest.schema.json#/definitions/commonCore.properties.knowledge_loop)。Loop A は必ず runtime。lint-knowledge-loop.py で KL-001..007 を検査(KL-006=add_entry.py存在/warn、KL-007=ストア位置↔consult_at一致/error)。assign-skill-design-evaluator も KL-* を採点。Loop B (harness-creator 自己適用): harness-creator 自身も
plugins/harness-creator/knowledge/を持ち、consult_at: [build-time]で過去ビルド知見を作成時に検索する。生成物側(Loop A)と同一機構を dogfooding する(SSOT)。
engine 既定は task-graph: loop kind (run/wrap/delegate) で brief が goal_seek.engine を明示しない場合、validate-build-plan.py / render-combinators.py が同一規則で task-graph へ default し、本 Step を適用する (量産ハーネスは既定で依存順駆動+self-reflect のタスク実行になる)。opt-out は brief に goal_seek.engine: inline (または run-goal-seek) を明示するか --no-goal-seek。engine は brief 由来のテンプレート変数で、--engine=task-graph の独立 flag は追加しない。validate-build-plan.py が同梱資産と profile claim を決定論導出し、render-combinators.py --brief <brief> --materialize-task-graph-engine <skill-dir> が実体化する。手順:
task-graph でなければ本 Step を skip (inline/run-goal-seek の明示 opt-out と非 loop kind は従来どおり)。templates/task-graph-engine/scripts/ の 4 スクリプト (ready-set-from-checklist.py=ENG-C01 / self-reflect-append.py=ENG-C02 / extract-capability-dependency-graph.py=ENG-C06 / record-capability-graph-knowledge.py=ENG-C07) を $OUT_BASE/$SKILL_NAME/scripts/ へ byte 一致で冪等コピーし、frontmatter を engine_profile: checklist-graph / full_task_spec_graph: false へ収束させる。render-combinators.py は default-ON の with-goal-seek 内へ既に ### ゴールシーク配線（task-graph 変種） / ### ゴールシーク検証（task-graph 変種・機械検査） / ### dependency graph knowledge consult の 3 サブセクションを注入済み (engine 値 task-graph で有効化)。追加の combinator 適用は不要。validate-build-plan.py --check と Step 4 の lint-capability-graph-knowledge.py を後段検査する。engine:task-graph でなければ not-applicable、指定時は4資産欠落・テンプレートとのbyte drift・profile claim driftを fail-closed にする。単一truth: 本 engine 変種は別状態ファイル (task-graph.json 相当) を生成せず、
eval-log/<skill>-progress.jsonの checklist を唯一の truth とする。ready 算出 (ENG-C01)・self-reflect 追記 (ENG-C02) は同一 checklist 配列を読み書きし、cross-surface dependency graph knowledge (ENG-C06/ENG-C07) は実行前判断用の派生情報として分離レイヤに置く。route C05 (= 本 skill 更新 component) 自身のgoal_seek.engineは inline を維持する (builder skill の更新タスクは依存が自明で並列 dispatch も self-reflect も要さないため self-適用の利得がない・dogfooding 非適用は意図的判断)。
--notion-register)build 完了後、量産プラグインを Notion の SSOT (スキル一覧 DB) に冪等登録する。プラグイン単位 1 行で、配下の個別 Skill はページ本文に列挙される(scripts/notion-upsert-plugin.py が plugins/<plugin>/skills/ を走査)。手順:
--notion-register または brief.notion_register=true 未指定なら phase skip。python3 scripts/notion-upsert-plugin.py --plugin <plugin> 実行 (TITLE 検索→PATCH/POST 冪等)。ヒアリングシート由来なら --hearing-sheet-id <notion-page-id> で 1:1 relation を埋める。.notion-config.json の keychain_service / keychain_account (既定: notion-api-key.<keychain-prefix> / harness) から Keychain 経由で取得する。CI では INTAKE_ALLOW_ENV_TOKEN=1 を明示した場合のみ $NOTION_TOKEN を許可する。不在なら警告のみで skip。scripts/lint-notion-relations.py が 1:1 / N:1 不変条件 (プラグイン名重複・ヒアリング多重紐付け・改善要望の対象未設定) を CI で検証。正本スクリプト: scripts/notion-upsert-plugin.py / スキーマ SSOT: doc/notion-schema/skill-list.schema.json (含む feedback_protocol SSOT)。
量産プラグインに改善要望ループを default-ON で機械的に保証 する。詳細は references/feedback-loop-deployment.md。要点:
feedback-deploy (workflow-manifest, default_on: true) が <target-plugin>/skills/run-skill-feedback を実体コピーで冪等配備。plugin 境界を越える symlink は marketplace install で dangling するため禁止。doc/notion-schema/skill-list.schema.json#feedback_protocol。プラグイン側で再定義しない。run-skill-feedback への発火経路を必ず記載。scripts/lint-feedback-protocol.py --strict が R1-R7 (schema/SKILL.md/upsert 三者整合 + R6 周知 + R7 配備存在) を CI で検査。違反時 merge ブロック。brief.no_feedback_loop: true または CLI --no-feedback-loop のみ。trace.layer_decisions に理由必須。harness-creator 自身は自動除外。機械 lint・意味adequacy・実走acceptanceを別々の全件workflowとして起動しない。derive-verification-contract.py でgraph全体のclaimを deterministic/semantic/observational/audit obligationへcompileし、plan-verification-obligations.py がcurrent receiptと依存fingerprintから次の最小work setを決める。まず check を実行・記録してから再planし、machine proof後に残った llm_batches[] だけを独立 evaluatorへ渡す。既存 {elegance,rubric}-verdict.json はCI互換projectionとして維持し、同時に record-verification-evidence.py でsemantic fingerprintへ束縛する。observational_queue[] だけをGate Dへ渡す。30思考法は exhaustive 明示時のaudit obligationであり通常runtime fan-outにしない。正本は references/verification-obligation-protocol.md、legacy verdict/hook projectionは references/content-review-protocol.md。
| 用途 | 出力先 | 正本 |
|---|---|---|
| Harness Creator 基盤 | plugins/harness-creator/skills/<skill>/SKILL.md | plugins/harness-creator/skills/ |
| 他 plugin 所属 | plugins/<plugin>/skills/<skill>/SKILL.md | plugins/<plugin>/ |
.claude/{skills,agents,commands}/<name> は symlink 派生 (直接書き込まない)。build/更新後は build 完了契約として bash scripts/sync-skills-to-claude.sh --apply (唯一の生成器 scripts/build-claude-symlinks.py を冪等呼び出し。make sync も可) を必ず実行し、新規 skill/agent/command を .claude/ へ展開する (未実行だと Claude Code が認識しない)。最終ゲートは CI build-claude-symlinks.py --check (orphan/broken/欠落 を fail-closed 検出)。生成器が SSOT であり、build 工程内に別途 symlink 生成を再実装しない。詳細: 34章 § plugin 物理レイアウトと symlink 戦略。
.js .sh 新規生成、いずれも禁止。詳細は references/build-steps.md。manifest / responsibility_refs / template_refs / schema_refs / script_refs / reference_refs) は起動契約上の主要資産のみを列挙する (全資産の網羅索引ではない)。全資産の索引正本はディレクトリ実体 (scripts/ / schemas/ / templates/ / prompts/ / references/) そのもの。references/resource-map.yaml は task category → 設計書章選択の progressive disclosure 索引 (+local_artifacts に manifest/schemas/prompts の一部) であり、これも全資産列挙ではない。examples/ = 完成例 (minimal-ref / workflow-with-evaluator)。design-docs-index.md (設計書索引) / build-steps.md (詳細手順) / capability-manifest.schema.json (Capability 7 kind 統一 Manifest 正本)。他の references/ は本文各 Step から個別参照。