7 層構造プロンプトを生成・更新するとき、owner_agent 向けに Prompt Templates/Self-Evaluation を充填するときに使う。
インストール方法を見るインストールする前に、エージェントに与えられる指示の中身を確認できます。
Purpose & Output Contractの最小の実成果物をmain contextで作成する。effect別のparse/open・secret・irreversible・corrupt guardだけを実行し、現物path・digest・開き方を提示してからaccept-as-is/light/standard/detailedを記録する。accept-as-isはその場でhandoff完了とし、後続sectionを実行しない。
以下の既存workflow・goal-seek・評価・修正sectionはlight/standard/detailedが記録されてsemantic_evaluator_startedへ遷移した場合だけ実行する。release/exhaustiveは別の明示eventを必要とする。
doc/prompt-creator/ を harness-creator 仕様準拠で plugins/prompt-creator/ へ移植した正本。SKILL.md/SubAgent 各 300 行以下、Progressive Disclosure 厳守。
ユーザー要求またはヒアリング結果から、成果物としての 7 層構造プロンプト を生成する。 7 層: L1 基本定義 / L2 ドメイン定義 / L3 インフラストラクチャ / L4 共通ポリシー / L5 エージェント定義 / L6 オーケストレーション / L7 ユーザーインタラクション。 Layer 5 はゴールシーク型 (達成ゴール+完了チェックリスト+実行方式)。固定手順は書かず、手順はエージェントが実行時に自律生成する。
本スキルの責務は エンドユーザー向け成果物プロンプトの生成 に純化する。SubAgent .md の Prompt Templates / Self-Evaluation への注入は、owner_agent 指定時のみ行う付随機能 (legacy) であり、本スキルの主目的ではない。
入力: --responsibility-id <R-id> (skill-local-v1 既定で必須、brief.responsibilities[].id と 1:1) / --output <path> (省略時は規約パス自動解決) / --target-agent (任意、owner_agent がある場合のみ注入) / --skill-brief / --format (md 既定、yaml は内部正規形または legacy 互換) / --inject-sections (既定: "Prompt Templates,Self-Evaluation")
出力 (path_convention で切替):
skill-local-v1 (既定): plugins/<plugin>/skills/<skill>/prompts/<R-id>-<slug>.md — references/prompt-placement-convention.md (harness-creator 側) 準拠、validate-build-trace.py が正規表現と sha256 で機械検証agents-legacy (--responsibility-id 省略時のみ): plugins/<plugin>/agents/prompts/<role>.yaml — 後方互換、brief.responsibilities[] が空の ref/wrap/delegate 用eval-log/prompt-build-trace.json (run-prompt-create/schemas/build-trace.schema.json 互換)eval-log/prompt-creator-trace.json (worker-local trace。必須フィールド: path_convention, responsibility_id, layer_artifact_path, sha256)完了条件: verify-completeness.py PASS + validate-prompt.py PASS + lint-agent-prompt-section.py PASS + C1-C4 設計評価 PASS (worker 内蔵ゲート: assign-prompt-design-evaluator を fork し findings 出力のみ受領。呼出元が同等ゲートを機械証跡 (design-findings JSON) で保証する場合のみ免除)。run-build-skill Step 7.5 直呼びでも同一の設計保証が成立する (経路非依存)。
references/ は Phase 直前で必要分のみ読込。writing-style-principles.md)。lint-agent-prompt-section.py 通過必須。FAIL 時最大 3 回自律修正→未達なら orchestrator 差戻。.md) を既定とする。論理構造の正本は references/seven-layer-format.md。内部正規形は YAML (scaffold/merge/verify の前提) とし、最終成果物は convert-format.py で Markdown へ変換する。references/seven-layer-markdown-template.md は提示形式の補助テンプレ。verify-completeness.py が固定手順を検出したら FAIL。references/idempotent-update-policy.md。Phase 1 ヒアリング委譲 (run-prompt-elicit) [delegate] hearing-result/brief 供給時 skip
↓
Phase 2 Prompt 作成シート生成+導出確認 [script→LLM] brief.user_confirmed で skip
↓
Phase 3 フォーマット選択 (yaml/md/json/xml) [LLM] brief 供給時/ループ時 skip (md 既定)
↓
Phase 4-A Layer 単位生成 (L1→L7) [script→LLM] generate-prompt
↓
Phase 4-B 4 パス品質レビュー [script→LLM] review-prompt
↓
Phase 4-C 自律改善 (最大 3 回+Anchor 記録) [LLM]
↓
Phase 4-D フォーマット変換+注入 [script + Write/Edit]
↓
Phase 5 戻り検証+設計ゲート (C1-C4) [script + evaluator fork]
詳細 (各 Phase のゴール+完了条件+判断基準): references/workflow-guide.md
本節は各局面のゴール+完了条件+判断基準のみを宣言する。実行順・依存関係・fatal exit code の機械正本は workflow-manifest.json (phases[].dependsOn)。手順はゴールシークループ (5.4 実行方式相当) で都度立案し、固定ステップ列挙を持たない。
| Phase | ゴール (到達状態) | 完了条件 (機械判定) | 判断基準 / skip 条件 |
|---|---|---|---|
| 1 ヒアリング | 検証済み hearing-result が存在する | validate-prompt.py --phase hearing exit 0 | hearing-result / brief 供給時は skip。無ければ run-prompt-elicit へ委譲 (interview-user agent を直接呼ばない: 収集正本の二重経路を作らないため) |
| 2 シート生成+導出確認 | goals/checklist を含む内部正規形材料が確定 | generate-sheet.py + validate-sheet.py exit 0 | brief.user_confirmed=true なら導出確認 skip。単独起動時のみユーザー承認を取る |
| 3 フォーマット選択 | 出力 format が一意確定 | format ∈ {md,yaml,json,xml} (md 既定) | brief 供給時 / ループ呼出時は md 既定で skip。単独起動時のみ AskUserQuestion。YAML は内部正規形または legacy 互換に限定 |
| 4-A Layer 単位生成 | 7 層 (または brief.layers_required サブセット) の Layer 別 artifact が揃う | 各 layer artifact 実在 + merge-layers.py exit 0 | 1 Layer = 1 出力 (一括生成禁止)。prompt-creator-generate-prompt fork。Layer 役割・依存方向の正本: references/seven-layer-format.md |
| 4-B 4 パスレビュー | Pass 0 (動的基準生成)〜Pass 4 の findings が確定 | 全 Pass PASS または修正指示付き findings | prompt-creator-review-prompt fork。基準: references/quality-criteria.md |
| 4-C 自律改善 | 完了チェックリスト全充足 or 上限到達 | verify-completeness.py (+--layers サブセット時) + validate-prompt.py --phase prompt exit 0 | 最大 3 回。冪等更新 (idempotent-update-policy.md)。各周回末に Anchor 追記 (下記契約) |
| 4-D 変換+注入 | 最終成果物出力 + (owner_agent 時) 注入完了 | convert-format.py exit 0、注入 diff が inject-sections 内 | 注入セクション名は不変契約 (下記) |
| 5 戻り検証+設計ゲート | 全機械ゲート+C1-C4 設計ゲート PASS | lint-agent-prompt-section.py exit 0 + C1-C4 findings PASS + log-usage.py 記録 | FAIL は Phase 4-A 再起動 (最大 3 周)。設計ゲート免除は呼出元の機械証跡がある場合のみ |
各周回末に eval-log/prompt-creator-intermediate.jsonl へ 1 行 append する: original_goal (全周回不変) / current_goal_snapshot / delta_from_original / merged_directive_for_next / drift_signal。schema 正本は harness-creator run-build-skill/schemas/goal-seek-loop.schema.json の intermediate_artifacts[] (本 skill で再宣言しない)。次周回の手順立案は直前行の merged_directive_for_next + original_goal を必須入力とする。drift_signal が stagnant/widening/oscillating で 2 周連続なら orchestrator へ差し戻す。
C1-C4 設計評価は worker の完了条件に内蔵する: assign-prompt-design-evaluator を fork (read-only・findings 出力のみ) して PASS を得る。呼出元 (例: run-prompt-create Step 3b) が同等ゲートを機械証跡 (design-findings JSON パス) で保証する場合のみ免除。これにより run-build-skill Step 7.5 直呼び・orchestrator 経由・手動起動のどの経路でも同一の設計保証が成立する。
Prompt Templates / Self-Evaluation はどの呼出元でも不変 (lint-agent-prompt-section.py の検証契約と 1:1)。user_confirmed に委譲する (orchestrator の user_question_budget=1 違反を防ぐ)。references/seven-layer-format.md — 7 層 YAML 正本テンプレ (Phase 4-A 直前読込)references/workflow-guide.md — Phase 1-4 詳細references/quality-criteria.md — 4 パス評価基準 + §8 冪等更新基準references/idempotent-update-policy.md — 既存改善時の重複回避・上書き優先・セッション分離 (Phase 4-B/4-C 直前読込)references/writing-style-principles.md — 記述スタイルreferences/prompt-sheet-template.md — シート項目schemas/hearing-result.schema.json — legacy sheet/scaffold 入力スキーマ (raw hearing の正本は run-prompt-elicit 側)plugins/prompt-creator/agents/prompt-creator-{generate-prompt,review-prompt}.md (ヒアリングは run-prompt-elicit へ委譲)plugins/harness-creator/skills/run-build-skill (Step 7.5)plugins/skill-governance-lint/scripts/lint-agent-prompt-section.pyplugins/prompt-creator/skills/assign-prompt-design-evaluator (C1-C4、fork・findings 出力のみ)plugins/harness-creator/skills/run-build-skill/schemas/goal-seek-loop.schema.json (intermediate_artifacts[])まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
アプリ・Webサービス・業務ツールの制作を、証拠分析→確定的な初稿→要件定義→体験設計→機能分解→実装→品質ゲート→リリース判定の手順ゲート制で進めるスキル。質問で要件を埋めるのではなく、依頼文・既存コード・資料・ログから最有力案を選び、動く成果物を先に出して差分で改善する。ユーザーが「アプリを作りたい」「ツールを作って」「〜を自動化したい」「システム化したい」「要件定義」「仕様を決めたい」「UI/UXを設計して」「体験を良くしたい」「機能を洗い出して」「MVPを決めたい」「品質チェック」「リリースしていいか判断して」などと言ったら必ず使用する。外部データの取込・マスタ・締め処理を伴う業務システムでは references/data-lifecycle.md も併用する。新規・既存を問わずアプリの制作・改善・リニューアルで使用する。
Webアプリの準備→要件定義→設計→実装→公開→品質ゲートを実行する内部オーケストレーター。Claude Codeの /build-app /improve-app、Codexの $build-app / $improve-app から明示的に委譲された場合、custom agent起動時、または利用者が $app-orchestrator を明示した場合だけ使用する。一般のアプリ相談から暗黙起動しない。
run-extract-blueprint が生成した章別ブループリントの忠実性を独立 context で評価したいとき、事実/推測区別と粒度と被覆を検証し draft_hash に束縛した PASS/FAIL verdict をローカル品質ゲート (C01 の周回内の受入判定・差し戻し) へ渡したいときに使う。
確認点で利用者が見る深さを選んだあと打ち合わせ資料を作り手とは別の目で確かめたいとき、正確さ・言葉・見た目・シンプルさの指摘を資料の編集なしで受け取りたいときに使う。
生成した handout 資料が初心者に伝わるか読みやすさレビューを依頼したいとき、独立 context のレビュアーから指摘と根拠つきの verdict を回収したいときに使う。
Notion ページを描画する直前に粒度を検証したいとき、info-collector-agent ページと同等の section 充足度を section_canonical_map 基準で機械検証したいときに使う。