notifications-extract-all
.github/workflows/**/*.{yml,yaml} の --body 通知文と hooks/**/*.sh の長文 echo/printf/heredoc を .claude/rules/notification-prompt-extraction.md 基準で個別 .md ファイルに切り出す migration skill。「/notifications-extract-all」
SKILL.mdskills/notifications-extract-all/SKILL.md
GitHub🤖 通知文切り出し migration スキル
[!IMPORTANT] 本スキルは
.github/workflows/**とhooks/**に embed された CEO 向け通知文 を.claude/rules/notification-prompt-extraction.md基準で個別.mdファイルに切り出す。 diff 提案 → CEO 承認 → 書換の 2 段階を必須とする。自動マージは禁止。 本スキルは自律改善ループの自動実行対象外(.claude/rules/autonomous-restrictions.md不可領域 4 / 6 該当)。
🎯 対象範囲
本スキルが切り出し提案の対象とするファイル種別は以下とする。
| 種別 | パス | 切り出し対象 |
|---|---|---|
| 🤖 GHA workflow | .github/workflows/**/*.yml, .github/workflows/**/*.yaml |
gh issue comment --body "..." / gh pr comment --body "..." / actions/github-script の script: 等 |
| 🪝 hook シェル | hooks/**/*.sh |
echo / printf / cat <<EOF で出力する CEO 向けエラー・警告文 |
切り出し先(notification-prompt-extraction.md の規定パス):
| 由来 | 切り出し先 |
|---|---|
| GHA workflow | .github/workflows/messages/<name>.md |
| hook シェル | hooks/messages/<name>.md |
対象外
skills/**/SKILL.mdのプロンプトテンプレ → 兄弟スキル/prompts-extract-allの管轄docs/配下の純粋なドキュメント →/docs-rewrite-all- コード内コメント
- 動的生成文(実行時に値を埋め込む 1〜2 行)
📝 使用方法
/notifications-extract-all
/notifications-extract-all --target workflows
/notifications-extract-all --target hooks
--target未指定なら workflow / hook を順次処理する- 1 ファイル単位で diff 提案 → CEO 承認 → 書き換えを繰り返す
🧭 8 段階動線
本スキルは以下 8 段階を順に進める。各段は前段の出力を受け取り次段へ渡す。
| ステップ | 名称 | 役割 |
|---|---|---|
| 1️⃣ | 列挙 | 対象ファイルを収集する |
| 2️⃣ | 照合 | 基準と機械的に突き合わせる |
| 3️⃣ | 委譲 | CISO Agent を呼び出す |
| 4️⃣ | 提案 | diff を CEO に提示する |
| 5️⃣ | 承認 | CEO の判断を待つ |
| 6️⃣ | 書換 | 承認分のみファイルに反映する |
| 7️⃣ | 配布版同期 | ローカル配布版スナップショットを同期する |
| 8️⃣ | レポート | 結果を CEO 向けに整形する |
1️⃣ 列挙: 対象ファイル収集
find .github/workflows -type f \( -name '*.yml' -o -name '*.yaml' \) -print
find hooks -type f -name '*.sh' -print
- ファイル一覧を保持してステップ 2 へ渡す
- 隠しファイル・除外ディレクトリ(
node_modules,vendor等)は対象外
2️⃣ 照合: 基準との機械的突き合わせ
各ファイル内の通知文候補を以下のパターンで grep / awk 抽出する。
| 由来 | 抽出パターン |
|---|---|
| GHA workflow | --body "..."、script: ブロック、heredoc(<<EOF / <<-EOF) |
| hook シェル | echo "..." / printf "..." / cat <<EOF(連続行) |
抽出した候補に対し、notification-prompt-extraction.md の 指針 MUST 全項目 と 禁止パターン全項目 を 1 件ずつ突き合わせる。
- 照合対象の項目本体は
.claude/rules/notification-prompt-extraction.mdが Single Source of Truth - 指針 / 禁止の項目本体は基準ルールに閉じる(スキル側で項目を重複列挙しない)
- 各候補に「該当する基準項目(閾値 / 用途軸 / 除外)」と「該当行番号」を表で記録する
- 検出結果が空のファイルはステップ 3 以降の対象から外す
3️⃣ 委譲: CISO Agent 呼出
通知文は CEO が GitHub UI で読む文面であり、情報露出経路を含むため CISO に委譲する。
Agent ツールで CISO を起動し、以下のプロンプト要素を含める。
- 対象ファイルと抽出された通知文候補(行番号付き)
- ステップ 2 の照合結果(該当した閾値・用途軸・除外条件)
- 適用基準 (
.claude/rules/notification-prompt-extraction.md/.claude/rules/communication.md/.claude/rules/markdown.md) - 制約: 文面の意味改変禁止、切り出し前後で厳密一致(whitespace 含む)、規定パス・命名規約遵守
- 出力フォーマット: 切り出し先パス候補・命名・diff 形式の対比表・判断根拠
CISO は複数並列で起動してよい(各 CISO は別ファイルを扱うため競合しない)。
4️⃣ 提案: diff を CEO に提示
ステップ 3 で集めた書き換え案をファイル単位の diff として整形し、以下を明示する。
- ✅ 適用候補: 基準逸脱を解消する切り出し
- ⚠️ 要判断: 用途軸 vs 行数軸が拮抗する候補
- 📍 根拠: 該当する閾値・用途軸・命名規約の引用
- 🔒 除外確認:
permissions:/secrets:セクションを巻き込んでいないこと
提示は ファイル単位 にまとめる。CEO の指示で「まとめて見る」と言われた場合のみ複数ファイル同時提示に切り替える。
5️⃣ 承認: CEO 判断を待つ
CEO に以下の選択肢を提示する。
| 選択肢 | 効果 |
|---|---|
| ✅ 全採用 | 提示した diff を全て切り出し対象に取る |
| 🔢 項目選択 | 採用したい項目の番号を指定する |
| ⏭️ スキップ | このファイルの切り出しを保留する |
| ✋ 中止 | スキル全体を中止する |
CEO 承認なしに本体ファイルを書き換えない。AskUserQuestion ツールで選択肢を明示提示してもよい。
6️⃣ 書換: 承認分のみファイル反映 + 挙動不変性検証
ステップ 5 で承認された項目のみ反映する。手順は以下。
- 切り出し先
.mdファイルをWriteで新規作成(通知文本体をそのまま配置) - 元ファイルを
Editで書き換え(--body "..."→--body-file <path>、echo "..."→cat "${SCRIPT_DIR}/messages/<name>.md") - 挙動不変性検証(必須、2 層):
- 文字列層: 切り出し先
.mdの中身と元の通知文をdiff -qまたはcmp -sで whitespace 含めて厳密一致 することを確認 - テスト層:
bash tests/test_*.shを全件走らせ、通過することを確認
- 文字列層: 切り出し先
- 破壊が出た場合はその場で書き換えをロールバックし、CEO に報告する
書き換えは ファイル単位の commit で行う(後追いで diff を追跡できるように)。
[!NOTE] workflow yaml の実 CI 動作確認はローカル不能。SKILL.md の本動線では文字列厳密一致 + テスト全件通過までを担保し、push 後の CI 結果は CEO がレビューする運用とする。
7️⃣ 配布版同期チェック
書き換えた本体に対応するローカル配布版スナップショット(.claude/vibecorp-base/)があれば同内容で同期する。
- 配布版は
install.shが生成するローカルスナップショット(.claude/.gitignoreで除外) - 配布版が存在しない種別は同期不要(CI / fresh clone では未生成)
- 差分が残ったら CEO に再提示する
- 切り出し先
.md自体はtemplates/claude/配下に同期する経路は持たない(vibecorp プラグインの skills/hooks はskills//hooks/ディレクトリそのものが配布元)
8️⃣ レポート: CEO 向け結果整形
.claude/rules/communication.md の 30 秒ルール(一覧性・状態絵文字で変化が一目で掴める)を満たすレポートを返す。
## /notifications-extract-all レポート
- ✅ 対象ファイル数: N
- ✅ 切り出し提案: M
- ✅ CEO 承認: A
- ✅ 切り出し完了: A
- ✅ 配布版同期: B
- ⚠️ スキップ: S
- 🔒 除外保護(permissions/secrets): 検出 K 件、全て除外維持
- ✅ 挙動不変性検証: 文字列厳密一致 全件 PASS / テスト全件 PASS
状態絵文字の選び方:
- ✅: 全件成功 / 完了している
- ⚠️: 一部スキップ / 警告あり(スキップ件数が 0 でないなど)
- ❌: 失敗・却下が発生した(テスト破壊・CEO 却下など)
🚧 除外ルール(MUST)
以下は 絶対に切り出さない(巻き込み禁止)。
| 除外対象 | 理由 |
|---|---|
permissions: セクション |
autonomous-restrictions.md 不可領域 6(CI エージェント) |
secrets: セクション |
同上 |
$'...'(ANSI-C クォート) |
機械検出困難、初版スコープ外 |
$(cat ...) / $(echo ...) 動的展開 |
文脈依存で意味が変わる |
| 短い通知文(閾値以下) | notification-prompt-extraction.md の閾値で除外 |
| エージェントログ・デバッグ出力 | CEO 向けではない開発者向け出力(>&2 リダイレクト等) |
ステップ 2 の照合フェーズで除外検出を必ず実行し、ステップ 4 の提案で「🔒 除外確認」を明示する。
🛡️ 自律ループ対象外宣言
本スキルは以下の理由により .claude/rules/autonomous-restrictions.md の 不可領域 4(ガードレール: skills/**) と 不可領域 6(CI エージェント: .github/workflows/**) に該当する。
.github/workflows/**配下の yaml を書き換える(不可領域 6)hooks/**配下のシェルを書き換える(ガードレール周辺)
そのため:
- 自律改善ループ(
/vibecorp:diagnose→/vibecorp:autopilot→/vibecorp:ship-parallel)の自動実行対象外 diagnose-activeスタンプ中はdiagnose-guard.shのデフォルト deny で実行不可- CEO 明示起動時のみ動作
- 自動マージ禁止(ステップ 5 の CEO 承認ゲート必須)
🤝 委譲先エージェント
| エージェント | 専門領域 | 本スキルでの担当 |
|---|---|---|
ciso |
セキュリティ・情報露出 | 通知文の切り出し提案(CEO 向け文面、情報露出経路を含むため) |
CISO は 管轄ファイルのみ 切り出し提案する。
✅ 指針(MUST)
本スキル固有の指針のみを定義する。切り出し基準そのものは .claude/rules/notification-prompt-extraction.md を Single Source of Truth として参照する。
🔒 除外ルールを必ず先に確認する
permissions:/secrets:/$'...'/$(cat ...)/ 動的展開 / 短文を巻き込まない- ステップ 2 の照合で除外検出を実行し、ステップ 4 で「🔒 除外確認」を明示する
🛑 diff 提案 → CEO 承認 → 書換の 2 段階を守る
- CEO 承認なしに本体ファイルを書き換えない
- 自動マージは禁止する
🔍 挙動不変性検証(文字列厳密一致 + テスト全件通過)を必ず実行する
- 切り出し前後で whitespace 含めて厳密一致することを確認
- 書き換え後に
bash tests/test_*.sh全件を走らせ通過させる - 破壊が出たらロールバックして CEO に報告
📦 ローカル配布版スナップショットを同期する
.claude/vibecorp-base/配下に対応ファイルがあれば同内容で同期する- 未配置なら同期不要(CI / fresh clone では未生成)
🛡️ 自律ループ対象外宣言を尊重する
- 本スキルは自律実行の対象外、CEO 明示起動時のみ動作する
❌ 禁止パターン
本スキル固有の禁止のみを定義する。切り出し基準の禁止パターンは notification-prompt-extraction.md を参照する。
- ❌
permissions:/secrets:セクションに踏み込むautonomous-restrictions.md不可領域 6 違反、最大の攻撃経路を開く
- ❌ CEO 承認なしにファイルを書き換える
- 自動マージ禁止に違反する
- ❌ 挙動不変性検証をスキップして commit する
- 通知文面が変わる事故を見逃す
- ❌ 動的展開(
$(cat ...)/$(echo ...))を機械的に切り出す- 文脈依存で意味が変わる、初版スコープ外
- ❌ 自律ループから起動する
- 不可領域 4 / 6 に該当する skill であり、CEO 明示起動時のみ動作する
🔗 関連
- 切り出し基準(Single Source of Truth):
.claude/rules/notification-prompt-extraction.md - 動作主語ルール:
.claude/rules/communication.md - マークダウン規約:
.claude/rules/markdown.md - shell 規約:
.claude/rules/shell.md - 自律実行不可領域(人間承認必須):
.claude/rules/autonomous-restrictions.md - 兄弟スキル(プロンプト切り出し):
/prompts-extract-all - 類似多段動線スキル:
/docs-rewrite-all//prompts-rewrite-all - 親エピック: Issue #636