Pre-choice usable artifact execution
Purpose & Output Contractの最小の実成果物またはremote mutation previewをmain contextで作成する。effect別のparse/open・secret・irreversible・corrupt guardだけを実行し、現物path・digest・開き方またはpreview receiptを提示してからaccept-as-is/light/standard/detailedを記録する。accept-as-isはmutationを実行せずhandoff完了とし、後続sectionを実行しない。
Post-choice selected improvement execution
以下の既存workflow・goal-seek・評価・修正sectionおよびexternal mutation safety wrapperはlight/standard/detailedが記録されてsemantic_evaluator_startedへ遷移した場合だけ実行する。actual mutationはcanonical preview→hook-confirm→authorize→execute wrapperだけを通し、release/exhaustiveは別の明示eventを必要とする。
<!-- external-mutation-guard-cli:v1 -->
Canonical external mutation receipt flow (mandatory)
Never execute the external mutation argv directly. Replace every angle-bracket placeholder
with the reviewed value from this run; the central CLI fails closed on missing/invalid values.
Resolve the guard plugin root once, before preview. An installed plugin cannot reach a sibling
plugin as <plugin root>/.., so never guess that path:
python3 "${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/extract-plugin-root.py" skill-governance-adapters
Use the printed absolute path as <GUARD_PLUGIN_ROOT> in preview, authorize and execute
(other Bash is blocked while the confirmation is pending, so do not resolve it again).
If the resolver exits non-zero, stop without any external mutation and tell the user to install
the skill-governance-adapters plugin.
python3 "<GUARD_PLUGIN_ROOT>/scripts/build-external-mutation-guard.py" preview --project-root "$PWD" --entrypoint-ref "plugin:<PLUGIN_NAME>/skills/<SKILL_NAME>/SKILL.md" --target-scope "<TARGET_SCOPE>" --diff-summary "<DIFF_SUMMARY>" --side-effect-summary "<SIDE_EFFECT_SUMMARY>" --command-json '<MUTATION_ARGV_JSON>'
Present that official preview output to the user. Only the exact user reply printed by preview
may trigger the registered hook-confirm producer. Then use the two returned receipt paths:
python3 "<GUARD_PLUGIN_ROOT>/scripts/build-external-mutation-guard.py" authorize --project-root "$PWD" --preview-receipt "<PREVIEW_RECEIPT_PATH>" --confirmation-receipt "<CONFIRMATION_RECEIPT_PATH>"
python3 "<GUARD_PLUGIN_ROOT>/scripts/build-external-mutation-guard.py" execute --project-root "$PWD" --authorization-receipt "<AUTHORIZATION_RECEIPT_PATH>" --command-json '<MUTATION_ARGV_JSON>'
Do not use an auto-approval flag or invoke the mutation command outside this receipt flow.
<!-- /external-mutation-guard-cli:v1 -->
run-template-sync
Runtime root contract
runtime_root_policy: host-skill-path を適用する。- Claude Codeでは
CLAUDE_PLUGIN_ROOT をplugin rootとして使用する。
- Codexではホストが提示したこの
SKILL.md のabsolute pathから、plugin manifestを持つ祖先を上方探索して論理 PLUGIN_ROOT を解決する。
cwd からplugin rootを推測せず、literal placeholderをshellへ渡さない。各shell invocation内で解決済みabsolute pathを PLUGIN_ROOT に設定する。prompts/ 配下はこのowner Skill契約を継承する。
Purpose & Output Contract
ユーザーが「ひな形が変わった/テンプレートが更新された」と明示した時のみ発火する独立スキル。自社のひな形フォルダに置き換えられた .docx を scan_template で診断し、黄色run/プレースホルダの差分(MISSING=差込位置消失/UNMAPPED=新規プレースホルダ)を検知。--apply で template-mapping.json・台帳列の更新を促し、completed 行に再生成フラグを立てて 未作成 へ差し戻す→次回 run-contract-generate(--phase draft) で作り直される。実体は scripts/sync.py(共有 ../../lib/scan_template.py を使用)。
境界
ひな形差分検知と再生成フラグ付与(completed→未作成)まで。下書き生成は run-contract-generate、PDF確定は run-contract-finalize。作成意図(「契約書を作って」)では発火しない(誤発火防止のため独立スキル化)。
主要ルール
- 明示発火のみ: 「ひな形が変わった」等の意図でのみ起動。作成フローに scan を混ぜない(常時発火でDrive API浪費・誤って再生成フラグ誤爆を防ぐ)。
- 条文は改変しない。差込アンカー(
template-mapping.json)のみ更新対象。
- ひな形は名前パターンで最新版を取得(差し替えに追従)。
--apply 前は診断のみ(dry的)。再生成フラグ付与は明示 --apply で。
ゴールシーク実行
固定手順は書かない。毎周「ゴール・目的/背景・チェックリスト」を読み最適手順を都度生成。詳細は run-build-skill references/goal-seek-paradigm.md。
ゴール (Goal)
変更されたひな形と template-mapping.json の差分が解消(整合)し、影響する completed 行が再生成対象(未作成+再生成フラグ)に差し戻され、作り直しの準備が整っている状態。
目的・背景 (Why)
ひな形は法務課により随時更新される。変更を「黙って壊れる」のでなく「検知して知らせ、作り直す」運用にする。作成意図と異質な発動条件のため独立スキルに分離し、自然言語「ひな形が変わった」で発火させ誤爆を防ぐ。
完了チェックリスト (Checklist)
ゴールシークループ
- 未達
[ ] を特定 → 2. 手順を都度生成 → 3. 実行 → 4. 再評価し [x] 更新 → 全 [x] まで反復。規定周回で未達なら open_issues へ。
ゴールシーク配線
ひな形差分解消を多周回す場合の周回状態とドリフト圧縮の配線。周回末に eval-log/run-template-sync-intermediate.jsonl へ {iteration, original_goal, current_goal_snapshot, delta_from_original, merged_directive_for_next, drift_signal} を1行追記する。original_goal は全周回で不変(SHA-256 を eval-log/run-template-sync-progress.json の original_goal_hash に固定し毎周回照合)。次周回は直前の merged_directive_for_next と original_goal を必須入力として読む(AI単独再導出禁止)。重い周回は Skill(run-goal-seek) に fork 委譲。
python3 "${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/lib/check_intermediate.py" run-template-sync
# → eval-log/run-template-sync-intermediate.jsonl の original_goal_hash 不変・required_keys 充足を検査
# 不整合は exit 2 で次周回を停止
ゴールシーク品質ループ (正負フィードバック)
各周回末に lib/feedback_loop.py の record_positive() / record_negative() を呼び、シグナルを eval-log/run-template-sync-feedback.jsonl に追記。次周回開始時に derive_next_directive("run-template-sync", round) を参照し、戻り値を merged_directive_for_next の先頭に prepend する。
正負シグナル定義表は prompts/R1-diagnose-and-resync.md の Layer 4.4 を正本(SSOT)とする(本 SKILL.md には再掲しない)。反映タイミング: 周回末 record_* → 次周回開始時 derive_next_directive → merged_directive に prepend。
検証
scan_template --type {individual,corporate} が exit 0(整合)/5(drift)--apply 後、対象 completed 行が 未作成+再生成フラグ◯ になっている--dry-run で台帳書込を抑止可能- 実装:
scripts/sync.py(集約診断 + --apply 時の台帳差し戻し entrypoint) / ${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/lib/scan_template.py(個別ひな形の drift 判定)
Gotchas
read_file_content(MCP)ではハイライト属性が取れない。黄色run確認は scan_template(標準ライブラリ docx_lib)で行う。- ひな形の構造を大改訂した場合は
template-mapping.json の anchor/conditionals の手修正が必要(run-contract-generate/references/template-change-runbook.md)。
変数化契約
ひな形フォルダID/spreadsheet_id は google-config.json から注入。差込アンカーは run-contract-generate/references/template-mapping.json を正本参照。
追加リソース
run-contract-generate/references/template-change-runbook.md — ひな形変更時の手順run-contract-generate/references/template-mapping.json — 差込アンカー正本prompts/R1-diagnose-and-resync.md — ひな形差分診断・マッピング/台帳追従・再生成フラグ付与の責務単位7層プロンプト(SSOT正本)。../../agents/template-sync-agent.md は本プロンプトを参照する薄い実行アダプタ(本文を持たない)。- 追加リソースは plugin 直下
lib/ ディレクトリ全体を参照。各ファイルは PEP723 風メタブロックで purpose を記載。
- 本 skill が強く依存する lib:
scan_template.py(差分診断) / ledger.py(再生成フラグ付与・台帳列追加) / docx_lib.py(黄色 run 抽出)
scripts/sync.py — エントリ(lib/scan_template.py を集約診断し、--apply 時は ledger へ completed 行の再生成フラグ書込。scan_template の等価 shim ではなく drift 時も exit 0)
使い方
python3 "${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/run-template-sync/scripts/sync.py" --type all # 診断のみ(差分検知)
python3 "${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/run-template-sync/scripts/sync.py" --type all --apply # 差分解消後: 再生成フラグを立て未作成へ差し戻し
または自然言語で「契約書のひな形が変わりました」と伝える。
セキュリティと権限
台帳への書込(effect=external-mutation)。SA鍵はKeychainのみ(hooks/hook-guard-secret.py が保護)。条文・法務承認済書式は改変しない。