HANDOFF — Phase 4：Phase 3 事後レビュー修正 + .skill 化 + 真SSOT反映¶

項目	内容
起案	Chat Claude（Phase 3 contentSnippet レビューに基づく）
宛先	Code Claude（ローカル Mac）
起案日	2026-05-15
前提	Phase 3 完了（phase3-patches/ に 9ファイル）。Chat が contentSnippet で事後レビュー実施
所要時間	30-40 分

0. 背景¶

Chat が Drive 上の phase3-patches/ 9ファイルを contentSnippet レビューした結果、2つの懸念点を発見。Phase 4 で修正し、真の SSOT（claude.ai スキル設定）への反映経路を確立する。

Phase 3 で判明した真 SSOT 3層構造： - 真 SSOT = ~/Library/.../skills-plugin/{device}/{user}/skills/（claude.ai 設定 UI 経由のみ更新可） - snapshot 層 = ~/.claude/skills.git-mirror/snapshots/2026-05-17/（Code 編集着地点） - kudo-skill-sync = regenerate_ssot_map 参照先（古いバイト数）

Part 1：Phase 3 事後レビュー修正¶

1-1. バージョン番号の整合（4スキル）¶

Code 完了報告では各スキルを新バージョンに上げたとあるが、Chat の contentSnippet レビューでは本文タイトル・description・改訂履歴が旧版表記のまま見える。以下を確認し、未更新なら修正：

スキル	本文タイトル(`# kudo-xxx vN`)	description 末尾	改訂履歴
kudo-naming-unification-protocol	`v2.4` に	description に「v2.4（2026-05-15）でマスター名簿パスを global 化」追記	v2.4 エントリ
kudo-cowork-code-handoff-protocol	`v1.13` に	description に「v1.13 §13 を global/handoffs/ 化」追記	v1.13 エントリ
kudo-workflowy-double-save	`v3.2` に	description に「v3.2 §7保存先に global 追記」追記	v3.2 エントリ
kudo-persist-settings	`v3.8` に	description に「v3.8 所在マップに集中原則SSOT＋参照腐敗フラグ」追記	v3.8 エントリ

重要：3スキル（context-routing v1.3 / gemini-bridge v0.2 / html-publish v0.5 / ai-error-watchlist）は contentSnippet で正しくバージョン更新済みを確認。上記4件のみ要確認。

description は1024字以内厳守（validate）。超過する場合は古い改訂履歴記述を圧縮。

1-2. ★CLAUDE.md §4 参照の reference rot 修正¶

問題：kudo-persist-settings 本文に下記の旧い参照が残っている：

> WorkFlowyの書込ルール詳細はCLAUDE.md §4を参照すること。
（親IDロック・noteフィールド禁止・読込先優先順位... すべて§4が一次ソース）

しかし Phase 3 で新設した CLAUDE.md の §4 は「状態再構成・読込ルール」であり、WorkFlowy 書込ルール本体ではない。新設により参照腐敗が発生。

修正方針（案A 採用）： WorkFlowy 書込ルールの真の一次ソースは kudo-workflowy-double-save §運用ルール SSOT（本文に「本セクションが WorkFlowy統合の唯一の正本」と明記済）。したがって kudo-persist-settings の参照を修正：

旧：「WorkFlowyの書込ルール詳細は CLAUDE.md §4 を参照」
新：「WorkFlowy の書込ルール詳細は kudo-workflowy-double-save §運用ルール SSOT を参照（親IDロック・noteフィールド禁止・読込先優先順位・書込み前チェックリスト・失敗検知・重複セクション防止のすべての一次ソース）」

kudo-persist-settings 内の「CLAUDE.md §4」を参照している全箇所（Step 3 の WorkFlowy 書き込み手順含む）を同様に修正。

1-3. ★横断チェック：他スキルの「CLAUDE.md §4」参照¶

kudo-persist-settings 以外にも「CLAUDE.md §4」「CLAUDE.md §4.x」を WorkFlowy ルール一次ソースとして参照しているスキルがないか grep：

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

ヒットしたスキルは、WorkFlowy ルール参照なら kudo-workflowy-double-save §運用ルール SSOT へ、状態再構成参照なら CLAUDE.md §4 のままで OK。判別して修正。

Part 2：.skill ZIP パッケージング¶

Phase 3 で更新した 8 SKILL.md を .skill 形式（ZIP）にパッケージングする。

2-1. 対象（8件）¶

phase3-patches/ の SKILL.md（CLAUDE.md は .skill 化対象外・後述 Part 4）： 1. kudo-naming-unification-protocol（Part 1-1 修正後） 2. kudo-cowork-code-handoff-protocol（Part 1-1 修正後） 3. kudo-context-routing 4. kudo-gemini-image-bridge 5. kudo-html-publish 6. kudo-workflowy-double-save 7. kudo-persist-settings（Part 1-1・1-2 修正後） 8. kudo-ai-error-watchlist

2-2. .skill 形式（kudo-persist-settings §.skill ファイル形式準拠）¶

各スキルにつき：

# フォルダ構造: {skill-name}/SKILL.md
mkdir -p /tmp/skill-build/{skill-name}
cp {修正済みSKILL.md} /tmp/skill-build/{skill-name}/SKILL.md
cd /tmp/skill-build && zip -r {skill-name}.skill {skill-name}/

references フォルダを持つスキルがあれば同梱（今回の8件は単一 SKILL.md のみのはず・要確認）。

2-3. Drive 配置¶

8つの .skill を ~/working/_claude_workspace_global/outputs/phase3-skills/ に配置（Drive 同期）。

mkdir -p ~/working/_claude_workspace_global/outputs/phase3-skills
cp /tmp/skill-build/*.skill ~/working/_claude_workspace_global/outputs/phase3-skills/

Part 3：完了報告¶

~/working/_claude_workspace_global/reports/2026-05-15-phase4-completion.md に配置：

# Phase 4 完了報告
- Part 1-1 バージョン番号整合：4スキル [修正済み / 既に正しかった]
- Part 1-2 CLAUDE.md §4 reference rot 修正：kudo-persist-settings [N箇所修正]
- Part 1-3 横断チェック：「CLAUDE.md §4」参照 [N件発見 → 修正]
- Part 2 .skill 化：8件 [全件成功]
- Part 3 Drive 配置：outputs/phase3-skills/ に8件 ✅
- description 1024字チェック：8件 [全件合格]

Part 4：CLAUDE.md の Chat/Cowork 扱い（★重要・要 Chat 判断）¶

論点：CLAUDE.md（~/.claude/CLAUDE.md）は Claude Code が自動読込するが、Chat / Cowork 環境では読まれない。8スキルが「CLAUDE.md §3 が一次ソース」と参照していても、Chat でそのスキルが起動したとき CLAUDE.md は不可視。

これは Phase 3 で生まれた構造的論点。Code は判断せず、完了報告にこの論点を明記して Chat に差し戻すこと。Chat 側で以下を検討： - 案A：CLAUDE.md の §3 集中原則を個人設定項目15 に全文インライン化（既に項目15 はある）→ 8スキルの「CLAUDE.md §3 参照」を「個人設定項目15」参照に変更 - 案B：CLAUDE.md の内容を kudo-shared-storage-protocol に集約し、8スキルの参照先をそちらに - 案C：現状維持（CLAUDE.md は Code 環境専用の一次ソースと割り切る）

これは Phase 5 として別途。

絶対遵守事項¶

❌ バージョン番号を上げずに .skill 化しない（Part 1-1 を必ず先に）
❌ reference rot を残したまま .skill 化しない（Part 1-2 を必ず先に）
❌ .skill を _claude_workspace_global/outputs/ 以外に置かない
✅ description 1024字以内を全8件で確認してから .skill 化
✅ 完了報告に Part 4 論点を必ず明記して Chat に差し戻す