Menu
新規/更新Skillの設計eleganceを多角的思考法と4条件で検証したいとき、量産パッケージの品質ゲートとして使いたいときに起動する。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
YAML仕様が変わったか確認するとき、公式仕様との差分を確認するときに使う。
北原さん式ナレッジソースの差分を検知したいとき、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 を出したいときに使う。
| name | run-elegant-review |
| description | 新規/更新Skillの設計eleganceを多角的思考法と4条件で検証したいとき、量産パッケージの品質ゲートとして使いたいときに起動する。 |
| disable-model-invocation | false |
| user-invocable | true |
| argument-hint | <target-type> <target-path> [--scope skill|plugin|repo] [--dry-run] [--max-iter 3] |
| arguments | ["target_type","target_path","scope_mode","dry_run","max_iterations"] |
| allowed-tools | ["Read","Write","Edit","Grep","Glob","Bash(python3 *)","Bash(git diff *)","Skill","Agent"] |
| kind | run |
| prefix | run |
| effect | local-artifact |
| owner | team-platform |
| since | "2026-05-18T00:00:00.000Z" |
| version | 0.1.0 |
| manifest | workflow-manifest.json |
| spec_version | 2.0 |
| responsibility_refs | ["prompts/R1-phase1-reset.md","prompts/R2-phase2-parallel.md","prompts/R3-phase3-execute.md"] |
| subagent_refs | ["elegant-reset-observer","elegant-logical-structural-analyst","elegant-meta-divergent-analyst","elegant-system-strategic-analyst","elegant-improvement-executor"] |
| schema_refs | ["schemas/finding.schema.json","schemas/findings.schema.json","schemas/phase-output.schema.json","schemas/verdict.schema.json"] |
| rubric_refs | ["ref-skill-design-rubric","references/4-conditions.json"] |
| reference_refs | ["references/30-paradigms-full.md","references/thought-methods.yaml","references/agent-roles.md","references/orchestration-flow.md","references/convergence-policy.json","references/amplified-patterns.json","references/variable-template-contract.md","references/observable-emit-examples.md"] |
| script_refs | ["scripts/build-paradigm-scorecard.py","scripts/validate-paradigm-coverage.py","scripts/emit-observable.py"] |
| merge_strategy | deep-merge |
| conflict_policy | most-specific-wins |
| source | doc/ClaudeCodeスキルの設計書/09-evaluation-orchestration.md |
| source_refs | ["doc/ClaudeCodeスキルの設計書/09-evaluation-orchestration.md","doc/ClaudeCodeスキルの設計書/17-agent-teams-reference.md","doc/ClaudeCodeスキルの設計書/25-meta-skill-runbook.md","doc/ClaudeCodeスキルの設計書/26-meta-skill-dogfooding.md","doc/ClaudeCodeスキルの設計書/30-paradigm-analogy-map.md","doc/ClaudeCodeスキルの設計書/35-meta-harness-feedback-loop.md","doc/ClaudeCodeスキルの設計書/36-plugin-package-harness-contract.md"] |
| source-tier | internal |
| last-audited | "2026-05-23T00:00:00.000Z" |
| audit-trigger | quarterly |
| feedback_contract | {"max_iterations":3,"criteria":[{"id":"IN1","loop_scope":"inner","text":"1周回内で30思考法が全種 finding を出すか skip_reason を残し used 足す skipped_with_reason が30に到達する","verify_by":"script","derived_from":["CL-2"]},{"id":"IN2","loop_scope":"inner","text":"各 SubAgent が出力する findings.json が集約スキーマを通過し issues[].severity が優先度列挙、condition_signal が4条件 signal 列挙に収まる","verify_by":"lint","derived_from":["CL-7"]},{"id":"OUT1","loop_scope":"outer","text":"矛盾なし 漏れなし 整合性あり 依存関係整合の4条件が全 PASS かつ未達時は force_pass せず human_review へ差し戻す","verify_by":"elegant-review","derived_from":["CL-3","CL-4","CL-5","CL-6","CL-9"]},{"id":"OUT2","loop_scope":"outer","text":"改善案の承認を同一 context が行わず別 SubAgent または人間が独立採点する proposer 非イコール approver を満たす","verify_by":"evaluator","derived_from":["CL-8"]}]} |
Reading Order: (1) ゴールシーク実行 → (2) Purpose & Output Contract → (3) 役割直交 → (4) 入出力契約 → (5) 30 思考法カタログ → (6) 検証 4 条件 → (7) 実行フロー (Phase 1→2→3) → (8) Gotchas。初見は (1)(2)(6) で全体像が掴める。
固定手順は書かず、ゴール+チェックリストへ向け都度手順を生成・反復する。正本: ../run-build-skill/references/goal-seek-paradigm.md。
対象（Skill / rubric 改訂 / アーキテクチャ提案 / plugin package）が 30 思考法で多角的に検証され、4 条件（矛盾なし / 漏れなし / 整合性あり / 依存関係整合）が全て PASS、または max_iter 到達で status: incomplete + human_review 必須として findings.json / verdict / レポートが eval-log に保存された状態になっている。
25章 §runbook Step 5.5（設計 elegance lint）として、契約適合（PKG check）・規範採点（rubric evaluator）と直交する「設計の elegance」を保証するため。固定手順では実行時文脈に脆く、未達条件に応じた手順生成が頑健。
shared_state.md（200字以内）を生成した thought_method_coverage.used + skipped_with_reason == 30（30 思考法全て使用 or skip_reason 付き） fail_counts.contradiction == 0（矛盾なし） fail_counts.omission == 0（漏れなし） fail_counts.inconsistency == 0（整合性あり） fail_counts.dependency_break == 0（依存関係整合） findings.json が schemas/findings.schema.json を通過する status: incomplete + force_pass 禁止で human_review へ差し戻した 正本 6 ステップ（現状評価→手順生成→実行→検証→Anchor Step→反復、既定 5 周 / max_iter=3）に従う。固有差分: ループ本体は Phase 1→2→3 を SubAgent へ context fork して回し（親へは最終成果物 + handoff のみ返す）、Phase 1/2 は read-only、write は Phase 3 限定。判定は scripts/validate-paradigm-coverage.py で機械実行。下記 Phase 群は順序固定の手順ではなく、未達条件を埋める局面カタログとして都度選ぶ。
新規/更新 Skill・rubric 改訂・アーキテクチャ提案・量産 plugin package を 30 思考法で検証し 4 条件を全 PASS まで改善する（詳細はゴールシーク実行節）。v2 位置づけ: 25 章 §runbook の Step 5.5（PKG check と assign-skill-design-evaluator の中間）= 「設計 elegance lint」。契約適合・規範採点と責務直交。
| Step | 役割 | 担当 skill |
|---|---|---|
| 5 | 契約適合: PKG-001〜015 機械検査 | run-plugin-package-check |
| 5.5 | 設計 elegance: 30 思考法 × 4 条件 lint | 本 skill |
| 6 | 規範採点: rubric 適合度 | assign-skill-design-evaluator |
dedup matrix と衝突時優先順位 (契約 > elegance > rubric) は plugins/harness-creator/references/orchestrate-gate-pattern.md に外出し (G9 resource-map 経由 lazy load)。
target:
plugin: "harness-creator" # plugin 名（kebab-case）
skill: "run-skill-rename" # skill 名（kebab-case）
scope_mode: "skill" # {skill, plugin, repo} 閉列挙
context:
build_log: "eval-log/.../build-XXX.json" # run-build-skill 直後の生成ログ
related_skills: [] # 横断検証する関連 skill
options:
dry_run: false # true なら write を禁止
max_iterations: 3 # 改善ループ上限
skip_thought_methods: [] # 緊急時のみ。skip_reason 必須
target.plugin / target.skill / target.scope_mode は全て必須。target_path だけの後方互換呼出も argument-hint 経由で受理するが、内部で target 構造体に正規化する。
findings.json — schemas/findings.schema.json 準拠の集約 object。各 paradigm_findings[] が 30 思考法のいずれかに対応thought_method_coverage — {used: [], skipped_with_reason: [], total: 30}verdict — {矛盾なし: PASS|FAIL, 漏れなし: PASS|FAIL, 整合性あり: PASS|FAIL, 依存関係整合: PASS|FAIL}review-<scope_mode>.md — 人間可読レポートeval-log/<plugin>/<skill>/elegant-review/<run-id>/ — 27 章 §3.1 規約準拠の保存先auto_fixable=true の finding を自動 commit、auto_fixable=false は人間判断各条件の PASS signal は上記ゴールシーク Checklist（fail_counts.<signal> == 0）と下記「検証 4 条件」テーブルを正本とする。issues[].severity は low/medium/high/critical の優先度、condition_signal は contradiction/omission/inconsistency/dependency_break/smell の機械観測 signal として分離する。smell は警告枠（PASS を妨げない）。判定は scripts/validate-paradigm-coverage.py と verdict.json で機械実行。
references/thought-methods.yaml を機械可読正本とする。本文は早見表のみ。
| カテゴリ | 配分 | 思考法 | 担当 SubAgent |
|---|---|---|---|
| 論理分析系 (5) | A2 | 批判的 / 演繹 / 帰納 / アブダクション / 垂直 | elegant-logical-structural-analyst |
| 構造分解系 (4) | A2 | 要素分解 / MECE / 2 軸 / プロセス | 同上 |
| 問題解決系 A2 移管 (1) | A2 | why 思考 (B1 で A4 → A2 へ移管) | 同上 |
| メタ抽象系 (3) | A3 | メタ / 抽象化 / ダブル・ループ | elegant-meta-divergent-analyst |
| 発想拡張系 (6) | A3 | ブレインストーミング / 水平 / 逆説 / 類推 / if / 素人 | 同上 |
| システム系 (3) | A4 | システム / 因果関係 / 因果ループ | elegant-system-strategic-analyst |
| 戦略価値系 (4) | A4 | トレードオン / プラスサム / 価値提案 / 戦略的 | 同上 |
| 問題解決系 A4 残置 (4) | A4 | 改善 / 仮説 / 論点 / KJ 法 | 同上 |
配分後: A2=10 / A3=9 / A4=11（B1 反映：why 思考を A4 → A2 に移管し均衡化）
CONST_002（30 種全使用）は 「全種が finding を出す or skip_reason を残す」 に緩和（C1 解消、B4 早期終了との両立）。
| # | 条件 | condition_signal | 検査手法 |
|---|---|---|---|
| C1 | 矛盾なし (Consistency) | contradiction | claim graph で contradiction edge 検出 |
| C2 | 漏れなし (Completeness) | omission | required-element checklist 全件 PASS |
| C3 | 整合性あり (Coherence) | inconsistency | rubric_refs / 上位仕様との diff violation=0 |
| C4 | 依存関係整合 (Dependency) | dependency_break | DAG topological sort 成立 |
警告枠: smell（PASS を妨げない、改善示唆）。
workflow-manifest.json が正本。各フェーズは 入力 / 出力 / 完了判定 signal / 失敗時アクション の 4 項目を必ず明示（D5）。
elegant-reset-observer（SubAgent 分離で context fork 強制、A2）target 構造体shared_state.md に 200 字以内で保存target.plugin / target.skill の全関連ファイルを fresh で Readshared_state.md（フェーズ 2 へのファンアウト中継、B6）shared_state.md 存在 + 全関連ファイル列挙完了elegant-logical-structural-analyst + elegant-meta-divergent-analyst + elegant-system-strategic-analyst（並列）shared_state.md + 担当思考法サブセットfindings-phase2-<agent>.json を独立出力thought_method_coverage.used + skipped_with_reason == 30（B2、CONST_002 機械検証）elegant-improvement-executor（必要時 delegate-codex-skill-review へ委譲、B5）findings[].location または paradigm_findings[].issues[].location から自動構築）→ 優先順位決定（issues[].severity: critical > high > medium > low）→ 独立対象は並列・依存ありは直列で改善 → auto_fixable=true は自動 commit / false は提案のみ → 4 条件再検証（max_iter=3）schemas/findings.schema.json 準拠の findings.json 最終版 + 改善 PR ブランチstatus: incomplete、human_review 必須、force_pass 禁止次のいずれかで delegate-codex-skill-review SubAgent へ委譲（Phase 3 限定、Phase 1/2 中は禁止＝context 再汚染 C2）: 変更行数 > 50 / テスト変更含む（tests/ *_test.py *.spec.*）/ 複数ファイル横断（findings[].location unique file 数 > 3）。
git diff --binary > eval-log/<plugin>/<skill>/elegant-review/<run-id>/pre-phase3.patch を取得dry_run=true は全フェーズで write 禁止。findings 出力のみ本 skill の改善内容を「同じ context」が承認することを禁止。承認経路は次のいずれか：
assign-skill-design-evaluator による独立採点governance-params.json: solo_operator_mode=false の場合は人間レビュー必須solo_operator_mode=true でも自己承認は不可（必ず別 SubAgent context）trigger: 4 条件のいずれかが FAIL、または safety_valve_fired=true の場合に emit (workflow-manifest.json observable.trigger と論理同一)。scripts/emit-observable.py が .claude/logs/meta-harness.jsonl に elegant_review_4condition_failed event を 1 行 append する。emit 呼出は phases[phase3-execute].steps.step6 (always 実行) に一本化済 (G3, append-only jsonl 重複防止)。
emit event の具体例 (4 条件 FAIL / safety_valve_fired=true 双方) は references/observable-emit-examples.md を参照。examples/safety-valve-fired-verdict.json を emit-observable.py --dry-run に与えれば生成 event を確認できる。
35 章 pkg_check_failed と並走し、collect → classify → improve の閉ループを成立させる。
詳細は references/convergence-policy.json 参照。
| 層 | 出力 | 用途 |
|---|---|---|
| L1 | C1-C4 の PASS/FAIL (4bit) | 最終判定 |
| L2 | 各 C 条件・各思考法のスコア (0.0-1.0) | 周回内精緻評価 |
| L3 | 周回間 Δベクトル（正/負両方向） | 収束兆候検出 |
amplified-patterns.json に蓄積 → 横展開Δneg < 0.10 AND Δpos < 0.10): status: completeΔneg 2周連続増加): human_escalateiteration_count >= max_iterations(=3)): status: incomplete・force_pass 禁止・human_review 必須scripts/validate-paradigm-coverage.py が thought_method_coverage.used + skipped_with_reason == 30 を機械検証。欠落で exit 1auto_fixable 安易フラグ禁止: 単純な path 修正・chmod 等のみ true。意味変更を伴う修正は必ず falseshared_state.md は 200 字制限: Phase 1 → 2 ファンアウト時に context 肥大を防ぐreference_refs / schema_refs / script_refs / source_refs) と references/resource-map.yaml (schemas / scripts / examples / related_skills / source_docs § ポインタ含む read_when 付き索引) を参照。references/thought-methods.yaml に外部化 (D2、本文再掲せず SubAgent 起動時に該当カテゴリを引用渡し)。