prompts-extract-all

skills/**/SKILL.md 内に embed された 5 行以上のエージェント呼出プロンプトテンプレ・長文ブロックを .claude/rules/notification-prompt-extraction.md 基準で skills/<skill>/prompts/<name>.md に切り出す migration skill。「/prompts-extract-all」「プロンプト切

SKILL.md

GitHub

🤖 プロンプト切り出し migration スキル

[!IMPORTANT] 本スキルは skills/**/SKILL.md に embed された エージェント呼出プロンプトテンプレ を .claude/rules/notification-prompt-extraction.md 基準で個別 .md ファイルに切り出す。 diff 提案 → CEO 承認 → 書換の 2 段階を必須とする。自動マージは禁止。 本スキルは自律改善ループの自動実行対象外（.claude/rules/autonomous-restrictions.md 不可領域 4 該当）。

🎯 対象範囲

本スキルが切り出し提案の対象とするファイル種別は以下とする。

種別 パス 切り出し対象
⚙️ スキル本体 skills/**/SKILL.md ```text / ```markdown フェンスブロック内のエージェント呼出プロンプトテンプレ・長文

切り出し先（notification-prompt-extraction.md の規定パス）:

由来 切り出し先
スキル本体 skills/<skill>/prompts/<name>.md

対象外

  • .github/workflows/** の通知文 → 兄弟スキル /notifications-extract-all の管轄
  • hooks/**/*.sh の通知文 → 同上（/notifications-extract-all）
  • .claude/agents/*.md / .claude/rules/*.md → /prompts-rewrite-all（書き直し系、切り出しではない）
  • 短いコードブロック（行数閾値未満かつ用途軸非該当）
  • frontmatter / 章立て見出し内のフェンスコードブロック（構造要素）

📝 使用方法

/prompts-extract-all
/prompts-extract-all --skill <skill-name>
  • --skill 未指定なら skills/**/SKILL.md を順次処理する
  • 1 ファイル単位で diff 提案 → CEO 承認 → 書き換えを繰り返す

🧭 8 段階動線

本スキルは以下 8 段階を順に進める。各段は前段の出力を受け取り次段へ渡す。

ステップ 名称 役割
1️⃣ 列挙 対象ファイルを収集する
2️⃣ 照合 基準と機械的に突き合わせる
3️⃣ 委譲 CTO Agent を呼び出す
4️⃣ 提案 diff を CEO に提示する
5️⃣ 承認 CEO の判断を待つ
6️⃣ 書換 承認分のみファイルに反映する
7️⃣ 配布版同期 ローカル配布版スナップショットを同期する
8️⃣ レポート 結果を CEO 向けに整形する

1️⃣ 列挙: 対象ファイル収集

find skills -name 'SKILL.md' -type f -print
  • ファイル一覧を保持してステップ 2 へ渡す
  • 隠しファイル・サブディレクトリ配下のテキストは対象外

2️⃣ 照合: 基準との機械的突き合わせ

各 SKILL.md 内のフェンスコードブロックを awk で抽出する。

抽出対象 パターン 行数カウント
text フェンス ```text で開いて ``` で閉じる 開閉行除く実行内容行数
markdown フェンス ```markdown で開いて ``` で閉じる 同上

抽出した候補に対し、notification-prompt-extraction.md の 指針 MUST 全項目 と 禁止パターン全項目 を 1 件ずつ突き合わせる。

  • 照合対象の項目本体は .claude/rules/notification-prompt-extraction.md が Single Source of Truth
  • 指針 / 禁止の項目本体は基準ルールに閉じる（スキル側で項目を重複列挙しない）
  • 行数軸（プロンプト 5 行以上）と用途軸（エージェント呼出 / 再利用定型文）の OR で判定する
  • 各候補に「該当する基準項目（閾値 / 用途軸 / 除外）」と「該当行番号」を表で記録する
  • 検出結果が空のファイルはステップ 3 以降の対象から外す

3️⃣ 委譲: CTO Agent 呼出

プロンプトテンプレはエージェント呼出（技術的判断の伝達手段）であり CTO に委譲する。

Agent ツールで CTO を起動し、以下のプロンプト要素を含める。

  • 対象 SKILL.md と抽出されたプロンプトテンプレ候補（行番号付き）
  • ステップ 2 の照合結果（該当した閾値・用途軸・除外条件）
  • 適用基準 (.claude/rules/notification-prompt-extraction.md / .claude/rules/prompt-writing.md / .claude/rules/markdown.md)
  • 制約: プロンプト文面の意味改変禁止、切り出し前後で厳密一致（whitespace 含む）、規定パス・命名規約（agent-call- プレフィックス + kebab-case）遵守
  • 出力フォーマット: 切り出し先パス候補・命名・diff 形式の対比表・判断根拠

CTO は複数並列で起動してよい（各 CTO は別 SKILL.md を扱うため競合しない）。

4️⃣ 提案: diff を CEO に提示

ステップ 3 で集めた書き換え案をファイル単位の diff として整形し、以下を明示する。

  • ✅ 適用候補: 基準逸脱を解消する切り出し
  • ⚠️ 要判断: 用途軸 vs 行数軸が拮抗する候補（短いが再利用される定型文等）
  • 📍 根拠: 該当する閾値・用途軸・命名規約の引用
  • 🛡️ 不可領域確認: skills/** を書き換える操作なので CEO 明示承認が必須であることを毎回明示する

提示は ファイル単位 にまとめる。CEO の指示で「まとめて見る」と言われた場合のみ複数ファイル同時提示に切り替える。

5️⃣ 承認: CEO 判断を待つ

CEO に以下の選択肢を提示する。

選択肢 効果
✅ 全採用 提示した diff を全て切り出し対象に取る
🔢 項目選択 採用したい項目の番号を指定する
⏭️ スキップ この SKILL.md の切り出しを保留する
✋ 中止 スキル全体を中止する

CEO 承認なしに本体ファイルを書き換えない。AskUserQuestion ツールで選択肢を明示提示してもよい。

6️⃣ 書換: 承認分のみファイル反映 + 挙動不変性検証

ステップ 5 で承認された項目のみ反映する。手順は以下。

  1. 切り出し先 skills/<skill>/prompts/<name>.md を Write で新規作成（フェンス内のテキスト本体をそのまま配置）
  2. 元 SKILL.md を Edit で書き換え（フェンスブロックを「以下のプロンプトは skills/<skill>/prompts/<name>.md を参照」のような相対パス記述に置き換える）
  3. 挙動不変性検証（必須、2 層）:
    • 文字列層: 切り出し先 .md の中身と元のフェンス内容を diff -q または cmp -s で whitespace 含めて厳密一致 することを確認
    • テスト層: bash tests/test_*.sh を全件走らせ、通過することを確認（特に test_*_skill.sh 系の構造テスト）
  4. 破壊が出た場合はその場で書き換えをロールバックし、CEO に報告する

書き換えは ファイル単位の commit で行う（後追いで diff を追跡できるように）。

7️⃣ 配布版同期チェック

書き換えた本体に対応するローカル配布版スナップショット（.claude/vibecorp-base/skills/）があれば同内容で同期する。

  • 配布版は install.sh が生成するローカルスナップショット（.claude/.gitignore で除外）
  • 配布版が存在しない場合は同期不要（CI / fresh clone では未生成）
  • 切り出し先 skills/<skill>/prompts/<name>.md 自体も含めて同期する（snapshot 内に prompts ディレクトリを作る）
  • 差分が残ったら CEO に再提示する

8️⃣ レポート: CEO 向け結果整形

.claude/rules/communication.md の 30 秒ルール（一覧性・状態絵文字で変化が一目で掴める）を満たすレポートを返す。

## /prompts-extract-all レポート

- ✅ 対象 SKILL.md 数: N
- ✅ 切り出し提案: M
- ✅ CEO 承認: A
- ✅ 切り出し完了: A
- ✅ 配布版同期: B
- ⚠️ スキップ: S
- 📐 行数閾値該当: P 件 / 用途軸該当: Q 件
- ✅ 挙動不変性検証: 文字列厳密一致 全件 PASS / テスト全件 PASS

状態絵文字の選び方:

  • ✅: 全件成功 / 完了している
  • ⚠️: 一部スキップ / 警告あり（スキップ件数が 0 でないなど）
  • ❌: 失敗・却下が発生した（テスト破壊・CEO 却下など）

🚧 除外ルール（MUST）

以下は 絶対に切り出さない。

除外対象 理由
短いプロンプト（5 行未満かつ用途軸非該当） notification-prompt-extraction.md の閾値で除外
動的生成プロンプト（変数展開を多量に含む） 実行時に値を埋め込む文面はテンプレ化が難しい
文脈依存で意味が変わる短文 周辺コードと一体で意味を成すもの
構造要素（章立て見出しの直下にあるサンプル） embed が読み手の理解を助ける場合
frontmatter 内のフェンスブロック 構造要素、切り出し対象外

ステップ 2 の照合フェーズで除外検出を必ず実行し、ステップ 4 の提案で除外判定の根拠を明示する。

🛡️ 自律ループ対象外宣言

本スキルは以下の理由により .claude/rules/autonomous-restrictions.md の 不可領域 4（ガードレール: skills/**） に該当する。

  • skills/** 配下の SKILL.md を書き換える（スキル定義はエージェント行動制御の中核）

そのため:

  • 自律改善ループ（/vibecorp:diagnose → /vibecorp:autopilot → /vibecorp:ship-parallel）の自動実行対象外
  • diagnose-active スタンプ中は diagnose-guard.sh のデフォルト deny で実行不可
  • CEO 明示起動時のみ動作
  • 自動マージ禁止（ステップ 5 の CEO 承認ゲート必須）

🤝 委譲先エージェント

エージェント 専門領域 本スキルでの担当
cto 技術・アーキテクチャ プロンプトテンプレの切り出し提案（エージェント呼出は技術的判断の伝達手段）

CTO は 管轄ファイルのみ 切り出し提案する。

✅ 指針（MUST）

本スキル固有の指針のみを定義する。切り出し基準そのものは .claude/rules/notification-prompt-extraction.md を Single Source of Truth として参照する。

  1. 📐 行数軸 + 用途軸の OR で判定する

    • 5 行以上のプロンプト OR エージェント呼出 OR 再利用定型文 → 切り出し対象
    • 行数閾値だけで機械的に切り出すと「短いが再利用される定型文」を見落とすため、LLM 判断を必ず挟む

  2. 🛑 diff 提案 → CEO 承認 → 書換の 2 段階を守る

    • CEO 承認なしに本体ファイルを書き換えない
    • 自動マージは禁止する

  3. 🔍 挙動不変性検証（文字列厳密一致 + テスト全件通過）を必ず実行する

    • 切り出し前後で whitespace 含めて厳密一致することを確認
    • 書き換え後に bash tests/test_*.sh 全件を走らせ通過させる
    • 破壊が出たらロールバックして CEO に報告

  4. 📦 ローカル配布版スナップショットを同期する

    • .claude/vibecorp-base/skills/ 配下に対応ファイルがあれば同内容で同期する
    • 切り出し先 prompts/<name>.md も snapshot 内に同期する
    • 未配置なら同期不要（CI / fresh clone では未生成）

  5. 🛡️ 自律ループ対象外宣言を尊重する

    • 本スキルは自律実行の対象外、CEO 明示起動時のみ動作する

❌ 禁止パターン

本スキル固有の禁止のみを定義する。切り出し基準の禁止パターンは notification-prompt-extraction.md を参照する。

  • ❌ 行数閾値だけで機械的に切り出す
    • 短いが再利用される定型文を見落とす、LLM 判断を必ず挟む
  • ❌ CEO 承認なしにファイルを書き換える
    • 自動マージ禁止に違反する
  • ❌ 挙動不変性検証をスキップして commit する
    • プロンプト文面が変わるとエージェント挙動が変わる
  • ❌ 動的展開を多量に含むプロンプトを機械的に切り出す
    • テンプレ化困難で逆に追跡コストが上がる
  • ❌ 自律ループから起動する
    • 不可領域 4 に該当する skill であり、CEO 明示起動時のみ動作する

🔗 関連

  • 切り出し基準（Single Source of Truth）: .claude/rules/notification-prompt-extraction.md
  • プロンプト書き方基準: .claude/rules/prompt-writing.md
  • 動作主語ルール: .claude/rules/communication.md
  • マークダウン規約: .claude/rules/markdown.md
  • shell 規約: .claude/rules/shell.md
  • 自律実行不可領域（人間承認必須）: .claude/rules/autonomous-restrictions.md
  • 兄弟スキル（通知文切り出し）: /notifications-extract-all
  • 類似多段動線スキル: /docs-rewrite-all / /prompts-rewrite-all
  • 親エピック: Issue #636

Похожие навыки: agents

agent-memory-yamadashy-repomix

Use this skill when the user asks to save, remember, recall, or organize memories. Triggers on: 'remember this', 'save t...

Автор: yamadashy
21,427

openai-whisper-api

Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞

Автор: clawdbot
7,675

video-frames

Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞

Автор: clawdbot
7,675