HANDOFF — Phase 5 v2：集中原則波及の仕上げ＋スキル更新 .skill 完結原則の恒久化¶

項目	内容
起案	Chat Claude
宛先	Code Claude（ローカル Mac）
起案日	2026-05-17
前提	Phase 4 完了。Part 4 論点は B案で確定
★v2 追加理由	工藤さんから「スキル更新は毎回 .skill 保存ボタン形式にしてほしい・アルゴリズム化せよ」の指摘。Part 0 を最優先で新設
所要時間	40-50 分

★Part 0（最優先・新設）：スキル更新 → .skill 完結原則の恒久化¶

0-1. 背景¶

個人設定項目11 に「改良が生まれた瞬間に必ず SKILL.md を present_files または .skill ファイルで出力し、保存を促す（後回し禁止）」と明記されているが、Phase 3-5 で「Code が snapshot 層を編集 → 後で Chat が .skill 化」という多段階フローになり、原則が徹底されていなかった。工藤さんが毎回指摘する手間が発生。

0-2. kudo-persist-settings へ恒久ルールを追記¶

kudo-persist-settings の §.skill ファイル形式セクションに、以下を新サブセクション「§スキル更新 .skill 完結原則」として追記：

## §スキル更新 .skill 完結原則（恒久アルゴリズム・2026-05-17 確定）

スキルの新規作成・更新は、SKILL.md を編集しただけでは「未完了」。
.skill ファイル化して工藤さんが claude.ai 設定で「保存」できる状態に
するまでが1セット。

### 判定フロー（毎回必ず通す）

1. スキルを編集したら → .skill 化したか？
   NO → .skill 化する（{skill-name}/SKILL.md 構造で ZIP、
        scripts/ 等サブフォルダがあれば同梱）
2. 工藤さんが保存できる場所にあるか？
   - Code/Cowork が編集 → ~/working/_claude_workspace_global/outputs/skills-to-save/ に配置
   - Chat が編集 → present_files で出力
3. 完了報告に「保存待ち .skill リスト」を明記したか？
   NO → 明記する

### skills-to-save/ フォルダ運用

- ~/working/_claude_workspace_global/outputs/skills-to-save/ が
  「保存待ち .skill」の唯一の置き場（SSOT）
- ここに .skill があれば「未保存のスキル更新がある」状態
- 工藤さんは常にここだけ見れば保存すべき .skill が一覧できる
- 工藤さんが claude.ai > 設定 > カスタマイズ > スキル で保存完了したら、
  Code が次回起動時に skills-to-save/ → skills-saved/{YYYY-MM-DD}/ へ移動

### 環境別の責任分担

- Code/Cowork がスキルを更新 → その環境が自分で .skill 化して
  skills-to-save/ へ配置。「Chat で .skill 化し直す」中間ステップは廃止
- Chat がスキルを更新 → Chat が .skill 化して present_files
- どの環境でも「SKILL.md 編集だけで完了報告」は禁止

0-3. kudo-cowork-code-handoff-protocol へも追記¶

kudo-cowork-code-handoff-protocol の §3 ハンドオフ標準フローまたは §16 系に、以下を追記：

### スキル更新タスクの完了定義（2026-05-17）

Cowork/Code がスキル更新タスクを実行した場合、完了条件は：
- SKILL.md 編集完了
- .skill 化完了（kudo-persist-settings §スキル更新 .skill 完結原則 準拠）
- skills-to-save/ への配置完了
- 完了報告に「保存待ち .skill リスト」明記

SKILL.md 編集だけで「完了」と報告するのは規約違反。

Part 1：B案実装 — 8スキルの §3 参照張り替え¶

1-1. 対象8スキル¶

autonomous-execution-protocol / brand-architecture / deck-generation-router / design-mockup / designer-lens-library / presenter-lens-library / proposal-deck / schedule-budget

1-2. 張り替えルール¶

元の参照	文脈	張り替え先
CLAUDE.md §3（保存先パス）	生成物の格納先	`kudo-shared-storage-protocol §5.5`
CLAUDE.md §3（NFC-NFD）	文字正規化	`kudo-naming-unification-protocol §6`
CLAUDE.md §3.2（二層ワークスペース）	案件直下 vs global	`kudo-context-routing §1.3`

SNAP=~/.claude/skills.git-mirror/snapshots/2026-05-17
grep -rn "CLAUDE.md §3\|CLAUDE.md§3" "$SNAP"/*/SKILL.md

各ヒットを文脈判断で張り替え。

1-3. CLAUDE.md 自体の索引化¶

~/.claude/CLAUDE.md の §3 冒頭に索引注記を追加：

※ §3 各規律の実体（一次ソース）は以下のスキルにある。本セクションは
  Code 環境向けの集約索引。Chat/Cowork では各スキルが直接参照される：
  - §3.1/§3.3 集中原則・特例配置 → kudo-shared-storage-protocol §5.5
  - §3.2 二層ワークスペース → kudo-context-routing §1.3
  - §3.4 文字正規化 → kudo-naming-unification-protocol §6

Part 2：全スキルの .skill 化（Part 0 原則を適用）¶

2-1. 対象¶

Phase 3-5 で編集された全スキルを .skill 化する。重複に注意し、最新版を1つずつ：

グループ	スキル	編集 Phase
A	kudo-naming-unification-protocol / kudo-cowork-code-handoff-protocol / kudo-context-routing / kudo-gemini-image-bridge / kudo-html-publish / kudo-workflowy-double-save / kudo-persist-settings / kudo-ai-error-watchlist	Phase 3-4（8件・Phase 4 で .skill 化済だが Part 0/3 で再編集されるため再 .skill 化）
B	autonomous-execution-protocol / brand-architecture / designer-lens-library / design-mockup / deck-generation-router / presenter-lens-library / proposal-deck / schedule-budget / project-state-recovery	Phase 4 Part 1-3（9件）＋ Part 1 B案で 8件が再編集

※ kudo-persist-settings は Part 0 で再編集、kudo-cowork-code-handoff-protocol も Part 0 で再編集、kudo-ai-error-watchlist は Part 3 で再編集。Part 0/1/3 を全て終えてから .skill 化すること（順序厳守・二度手間防止）。

2-2. 配置¶

全 .skill を ~/working/_claude_workspace_global/outputs/skills-to-save/ に配置（Part 0 で確立する新フォルダ）。

mkdir -p ~/working/_claude_workspace_global/outputs/skills-to-save
# 各スキルを {skill-name}/SKILL.md 構造で ZIP、scripts/ 同梱、.skill 拡張子

旧 outputs/phase3-skills/ の8 .skill は古いので、skills-to-save/ の最新版で置き換え（phase3-skills/ は archive 扱いに）。

2-3. validate¶

kudo-persist-settings/scripts/validate_skill.py で全 .skill 内の SKILL.md を検査（description 1024字以内・7項目）。

Part 3：Entry #16 追加¶

kudo-ai-error-watchlist に追加（§4 を15件→16件に）：

### Entry #16：snapshot サブフォルダを走査範囲から除外し validate_skill.py を「不在」と誤認

- 日付：2026-05-17
- 領域：ファイル探索 / 走査範囲の設定
- 誤り：Phase 3 で「validate_skill.py 不在」と報告したが、実際は
  kudo-persist-settings/scripts/validate_skill.py に同梱されていた
- 真相：snapshot 配下スキルフォルダの scripts/ サブフォルダを走査範囲から除外
- 一次ソース：Phase 4 で実機発見・17件全件 PASS
- 永続化ルール：スキル付随スクリプトを探すときは {skill}/scripts/ まで走査する
- 関連：Entry #15 と同じ「作業前の確認不足」系

Part 4：完了報告＋保存待ちリスト¶

~/working/_claude_workspace_global/reports/2026-05-17-phase5-completion.md に配置。

★必須：完了報告の冒頭に「保存待ち .skill リスト」を明記：

## ★工藤さんが保存すべき .skill（skills-to-save/ 内）
1. kudo-naming-unification-protocol.skill
2. ...（全17件）
保存先：claude.ai > 設定 > カスタマイズ > スキル

リスクマネジメント実体確認も実施：

ls -la ~/working/顧客ビジネス/ | grep -i "リスクマネジメント"

絶対遵守事項¶

★ Part 0 → Part 1 → Part 3 を全て終えてから Part 2（.skill 化）を実行（順序厳守）
❌ SKILL.md 編集だけで「完了」と報告しない（Part 0 原則）
❌ .skill を skills-to-save/ 以外に置かない
✅ 完了報告に「保存待ち .skill リスト」を必ず明記
✅ description 1024字を全件 validate

HANDOFF — Phase 5 v2：集中原則波及の仕上げ ＋ スキル更新 .skill 完結原則の恒久化¶