Menu
実行して新規Skillを端から端まで作りたいとき、複数Gateを通した品質保証付きフローを起動したいときに使う。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | run-skill-create |
| description | 実行して新規Skillを端から端まで作りたいとき、複数Gateを通した品質保証付きフローを起動したいときに使う。 |
| disable-model-invocation | false |
| user-invocable | true |
| argument-hint | [topic?] [--mode create|update] [--fast] [--brief-path <skill-brief.json> [--handoff <handoff-run-plugin-dev-plan.json>]] |
| arguments | ["topic","mode","fast","brief_path","handoff"] |
| allowed-tools | ["Read","Write","Edit","Bash(python3 *)","Bash(git diff *)","Bash(git status *)","Skill","AskUserQuestion"] |
| model | opus |
| kind | run |
| prefix | run |
| effect | local-artifact |
| owner | team-platform |
| since | "2026-05-18T00:00:00.000Z" |
| version | 0.1.0 |
| pair | assign-skill-design-evaluator |
| manifest | workflow-manifest.json |
| responsibility_refs | ["prompts/R1-elicit.md","prompts/R2-gate-review.md","prompts/R3-governance-decide.md"] |
| rubric_refs | ["ref-skill-design-rubric"] |
| reference_refs | ["ref-task-context-map","ref-skill-glossary","ref-domain-task-spec-rubric"] |
| feedback_contract | {"max_iterations":3,"criteria":[{"id":"IN1","loop_scope":"inner","text":"workflow-manifest の p0-lint.commands 全件 (manifest-contents 含む) が exit0 で通り TODO や未展開プレースホルダや英語仮文の残存が無い(パラメーター名を除く)","verify_by":"lint","derived_from":["CL-7"]},{"id":"IN2","loop_scope":"inner","text":"各ゲート通過時の handoff JSON と build-trace JSON が schemas 配下の正本スキーマに準拠し章 coverage を空欄なく記録している","verify_by":"script","derived_from":["CL-3","CL-12"]},{"id":"OUT1","loop_scope":"outer","text":"全ゲートでユーザー承認前に自動前進せず evaluator と governance reviewer を必ず context fork で起動している","verify_by":"elegant-review","derived_from":["CL-1","CL-2","CL-8","CL-11"]},{"id":"OUT2","loop_scope":"outer","text":"fork した assign-skill-design-evaluator の findings に FAIL 残存が無く新規や30行超変更時は elegant-review の C1-C4 が全 PASS","verify_by":"evaluator","derived_from":["CL-9","CL-10"]}]} |
| source | doc/ClaudeCodeスキルの設計書/ |
| source-tier | internal |
| last-audited | "2026-05-19T00:00:00.000Z" |
| audit-trigger | quarterly |
Phase 2 移行後は
plugins/harness-creator/skills/が正本、.claude/skills/は symlink/deploy target。schema/prompt 参照は self-relative パスだが、本SKILL.md 内の lint / スクリプト起動コマンド (python3 plugins/...) は repo-root cwd 前提。
ユーザー要望 → skill-brief.json → Skill生成 → plugin/marketplace 登録判定 → P0 lint → 設計評価 → パラダイム評価 → governance 承認 をゲートあり自動連鎖で実行する端から端まで orchestrator。各 Step/Gate の機械可読定義は workflow-manifest.json、責務別プロンプトは prompts/*.md、データ契約は schemas/*.schema.json を参照。
入力: topic (任意), mode ∈ {create, update}, brief_path (任意・E2 直接消費), handoff (任意・brief_path 併給時の parity preflight) 出力:
plugins/harness-creator/skills/<skill_name>/ 一式 (SKILL.md + references/ + scripts/)eval-log/skill-build-trace.json (schemas/build-trace.schema.json 準拠)plugins/harness-creator/.claude-plugin/plugin.json 登録差分eval-log/docs/<NN>-<timestamp>.json (評価結果、schemas/findings.schema.json 準拠)。deprecated: 27章 §3.1 の eval-log/<plugin>/<skill>/<gate>/<run-id>/ (repo root 基準) へ移行eval-log/handoff-<step>.json (schemas/handoff.schema.json 準拠)完了条件: P0 lint pass + evaluator JSON pass (--fast 低リスク ref/wrap は evaluator: N/A 理由必須) + (solo_operator_mode 下) LLM-reviewer pass。
禁則: ゲート前で必ず止まりユーザー承認なしに次フェーズへ進まない。P0 lint 失敗の自動修正は禁止 (根本原因をユーザー提示)。evaluator/governance reviewer は同一 context 評価禁止 (必ず context:fork)。詳細は ## Key Rules。
schemas/skill-brief.schema.json (詳細は references/skill-brief-schema.json)。--brief-path 指定あり (E2 直接消費): 上流 run-plugin-dev-plan の handoff-run-plugin-dev-plan.json を render-skill-brief.py で決定論射影した skill-brief.json を Step 1 の対話ヒアリング (run-skill-elicit) を skip して直接 Step 1 成果物に採用する (再ヒアリングなし)。詳細契約は prompts/R1-elicit.md CONST_014。--handoff 併給時は build dispatch 前に python3 $CLAUDE_PLUGIN_ROOT/scripts/check-route-component-parity.py <handoff> を実行し exit0 (routes↔inventory 一致) を確認する (CONST_015、非0 で停止)。--page-url または --page-id が含まれる場合、Step 1 は skill-intake の publish 完了証跡を必須入力とする。output/<hint>/notion-log.json.status=="published"、notion-publish-result.json.page_id、notion-url.txt が揃い、指定 page と一致するまで Step 2 build へ進まない。--fast: 1ファイル変更/<=30行/kind ∈ {ref,wrap}/evaluator pair 不要を全て満たす場合のみ軽量フロー (Step 4b/5 skip)。判定は機械決定:
python3 plugins/harness-creator/skills/run-skill-create/scripts/evaluate-create-gates.py \
--skill-name "$SKILL_NAME" --kind "$KIND" --brief eval-log/skill-brief.json --fast
prompts/R2-gate-review.md)。workflow-manifest.json の delegateSkill)。本スキルは制御のみ。eval-log/handoff-<step>.json を schemas/handoff.schema.json 準拠で残す。PostCompact hook で復元。build-manifest-registration-plan.py の提案 → Gate 2.5 承認 → --apply の順。新形式 plugin.json plugin のルート marketplace.json / bundles.json 登録は scripts/validate-plugin-completeness.py --fix（append-only・冪等・書込後自己再検証）が担い、人間が PR diff で最終承認する（破壊的変更を含まない append-only ゆえ生成フロー内で自動実行可）。references/resource-map.yaml を最初に読み、必要ファイルのみ open。output_language=ja と parameter_language_exception=true を既定とし、本文・レビュー・完了レポートを日本語に保つ (パラメーター名・JSON キー・CLI 引数は英語)。.md) 既定。prompts/<R-id>-<slug>.md で plugins/prompt-creator/skills/run-prompt-creator-7layer/references/seven-layer-markdown-template.md を写経して生成。YAML は legacy のみ許容 (新規禁止、P0 lint で warn)。[Step 1 elicit] run-skill-elicit ─→ skill-brief.json ─[Gate 1]─▶
[Step 2 build] run-build-skill ─→ skill-build-trace.json
[Step 3 manifest-register] [Gate 2.5] [Step 3.5 bundle-register]
[Step 4a p0-lint] (fail→Step 2、最大3周) ─[Gate 2 diff]─▶
[Step 4a.5 pkg-check] run-plugin-package-check (条件: kind==plugin-composition or 新規 plugin 横展開)
[Step 4b design-evaluate] (context:fork) ─→ findings
[Step 5 elegant-review] (条件: new or >30 行, context:fork) ─[Gate 3]─▶
[Step 6 governance] (solo_operator_mode 自動承認) ─[Gate 4]─▶
[Step 7 report]
依存・entryHook/exitHook・resourceIds・fatal_exit_codes は workflow-manifest.json 参照。
ユーザー要望から生成された <skill_name>/ 一式が、全 P0 lint pass・evaluator JSON pass・(solo_operator_mode 下) LLM-reviewer pass を満たし、4 ゲート全承認済みで、登録判定・handoff・完了レポートまで完結した状態になっている。
新規/更新 Skill を「端から端まで」品質保証付きで送り出すための制御層。各フェーズは独立 Skill へ委譲し、本スキルはゲート制御とハンドオフ整合のみを担う。固定手順では入力 (topic/mode/--fast)・lint 失敗・FAIL 差し戻しなど実行時文脈に脆いため、未達ゲートを都度埋める。
eval-log/skill-brief.json が schemas/skill-brief.schema.json 準拠で生成され、Gate 1 承認済み python3 plugins/harness-creator/skills/run-skill-create/scripts/validate-intake-publish-ready.py --dir output/<hint> --page-url <url> が exit 0。未公開・page_id 不一致・URL 欠落なら Gate 1 で停止し、skill 本体生成へ進んでいない <skill_name>/ 一式 (SKILL.md + references/ + scripts/) が Skill(run-build-skill, args=[skill_name, kind, --mode={mode}]) で生成され、eval-log/skill-build-trace.json が schemas/build-trace.schema.json 準拠・章 coverage 全 PASS/N/A/skip 理由付き python3 scripts/validate-plugin-completeness.py --fix 実行済みで、marketplace.json plugins[] + bundles.json (bundle_targets) へ append-only 登録され、検出モード (validate-plugin-completeness.py) が exit 0。プロジェクト固有 (横展開しない) は未登録理由がレポートに記録されている .claude-plugin/bundles.json の現行 bundle (skills-full / skills-intake) のうち plugin.json.bundle_targets で宣言した対象へ登録済み (上記 --fix が bundle_targets を読み自動 append)。不要なら理由がレポートにある (理由なき未登録は rubric 違反) --apply 済み (build-manifest-registration-plan.py) workflow-manifest.json の phases[id=p0-lint].commands 全件 (lint-manifest-contents 含む) が exit 0。TODO/未展開 {{...}}/英語仮文の残存なし (パラメーター名除く) git diff <skill_path> + build-trace を提示し承認済み assign-skill-design-evaluator (context:fork) の eval-log/docs/<NN>-<timestamp>.json (schemas/findings.schema.json 準拠) が FAIL 残存なし run-elegant-review (context:fork) で C1-C4 全 PASS。PASS 時 eval-log/pattern-feedback.json に pattern_ref_candidates/new_patterns/mass_production_risk を提案保存 workflow-manifest.json の phases[id=governance].auto_approve_conditions で機械評価し、全充足で自動承認。条件値の正本は repo-root references/governance-params.json (27章§11 パラメータ正本、gitignore。未配備なら references/governance-params.json.example から provision。不在時は graceful degrade=手動承認フロー)。不充足なら run-skill-rubric-governance 経由 (prompts/R3-governance-decide.md R3)。Gate 4 承認済み eval-log/handoff-<step>.json が schemas/handoff.schema.json 準拠で保存されている 正本 ../run-build-skill/references/goal-seek-paradigm.md の 6 ステップ (現状評価/手順生成/実行/検証/Anchor Step/反復) に従う。本スキル固有の差分:
workflow-manifest.json の gate_order 順に「未承認」とみなして都度埋める (Gate 番号順の直書き禁止、順序正本は manifest)。ゲート前で必ず止まりユーザー承認を取る (自動推測禁止、AskUserQuestion 経由 prompts/R2-gate-review.md)。run-skill-elicit / run-build-skill / assign-skill-design-evaluator / run-elegant-review / run-skill-rubric-governance。Notion 指定ありの非技術者 intake は skill-intake 完了証跡を先に検証する。本スキルは制御のみ、各子が自設計書を参照。run-build-skill 再実行へ戻す (最大 3 周)。--fast 判定・elegant 起動判定は scripts/evaluate-create-gates.py で機械決定 (条件不一致は黙って通常フロー)。workflow-manifest.json 参照。プロンプト R1/R2/R3 は prompts/*.md。run-skill-rename に委譲。本スキル対象外。schemas/handoff.schema.json 準拠で必ず保存。lint-manifest-contents.py を必ず通す。新規/更新/プロンプト改善時は Elegant Review Protocol を適用する。本プロトコルの正本は plugins/harness-creator/skills/run-elegant-review/SKILL.md (Phase 1→2→3 で C1-C4 全 PASS を確認、大規模設計は必須、軽微修正は --fast と整合可)。結果は Step 5 findings に紐付け eval-log/ に残す。
references/resource-map.yaml を最初に読む (machine-readable と人間向け資料を一覧化)。主要参照:
workflow-manifest.json — Step/Gate/Phase の機械可読定義 (entryHook/exitHook/dependsOn/delegateSkill)schemas/skill-brief.schema.json — Step 1→2 渡し正本スキーマschemas/handoff.schema.json — Gate 通過時 handoff 共通形式schemas/findings.schema.json — orchestrator handoff envelope (evaluator 集約結果の封筒)。Step 5 producer 出力の正本は ../run-elegant-review/schemas/findings.schema.jsonschemas/build-trace.schema.json — Step 2 emit する章別 coverage 形式schemas/rubric-merge.schema.json — L0/L1/L2 rubric deep-merge 物質化形式prompts/R1-elicit.md / prompts/R2-gate-review.md / prompts/R3-governance-decide.md — R1/R2/R3 責務別プロンプトreferences/gate-templates.md — Gate 確認質問テンプレ (人間向け詳細手順)run-skill-elicit, run-build-skill, run-plugin-package-check, assign-skill-design-evaluator, run-elegant-review, run-skill-rubric-governance, run-skill-renameYAML仕様が変わったか確認するとき、公式仕様との差分を確認するときに使う。
北原さん式ナレッジソースの差分を検知したいとき、6カテゴリへ分類・格納してナレッジを同期したいときに使う。
Capability 7 kind を新規作成・更新するとき、CapabilityManifest と plugin-composition.yaml を整備するときに使う。
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 を出したいときに使う。