コンテンツにスキップ

HANDOFF — Phase 5:集中原則波及の仕上げ

項目 内容
起案 Chat Claude
宛先 Code Claude(ローカル Mac)
起案日 2026-05-17
前提 Phase 4 完了(8 .skill 化済・9スキル追加修正済)。Part 4 論点は B案で確定
所要時間 30-40 分

0. 背景

Phase 4 完了。残るは仕上げ5パート。Part 4 論点(CLAUDE.md の Chat/Cowork 不可視)は B案で確定: CLAUDE.md は Code 環境用の集約索引として残すが、8スキルの「CLAUDE.md §3 参照」を実体スキルへ張り替える。


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. 張り替えルール

各スキルの「保存先パス/NFC-NFD対策は CLAUDE.md §3 が一次ソース」という記述を、文脈別に張り替え:

元の参照 文脈 張り替え先
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

grep で該当箇所を特定:

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:phase4-patches-extra/ の 9 SKILL.md を .skill 化

Part 1-3 で修正された 9 SKILL.md(autonomous / brand-architecture / designer-lens / design-mockup / deck-generation-router / presenter-lens / proposal-deck / schedule-budget / project-state-recovery)を .skill 化。

順序重要:Part 1 の B案実装で8スキルが更に編集される。Part 1 完了後に .skill 化すること(二度手間防止)。

# 各スキル: {skill-name}/SKILL.md 構造で ZIP
# scripts/ 等のサブフォルダがあれば同梱

~/working/_claude_workspace_global/outputs/phase5-skills/ に9件配置。

description 1024字を validate_skill.py で全件チェック(kudo-persist-settings/scripts/validate_skill.py)。


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 に同梱されていた(6987B/2026-05-07作成)
- 真相:snapshot 配下のスキルフォルダの s------ サブフォルダ(scripts/ 等)を
  走査範囲から除外していたため見落とした
- 一次ソース:Phase 4 で実機発見・17件全件 PASS 確認
- 永続化ルール:スキル付随スクリプトを探すときは {skill}/scripts/ サブフォルダまで
  含めて走査する。「{skill}/SKILL.md のみ」と走査範囲を狭めない
- 関連:Entry #15 と同じ「作業前の確認不足」系

Part 4:(完了済み)v8 完了報告

Cowork v8 完了報告は Chat が reports/2026-05-17-cowork-v8-completion.md に永続化済(ID: 1NOjgHt68qAIvC1FTKXHQG0__VmVKcDTA)。Code 側作業は不要。

ただし、v8 Task D の「リスクマネジメント全角/半角カッコ」は Mac 実体側確認が Code に残っている:

ls -la ~/working/顧客ビジネス/ | grep -i "リスクマネジメント"
結果を completion 報告に記載。


Part 5:完了報告

~/working/_claude_workspace_global/reports/2026-05-17-phase5-completion.md に配置: - Part 1 張り替え:8スキル [N箇所] - Part 2 .skill 化:9件 [全件成功/失敗] - Part 3 Entry #16:追加済 - Part 4 リスクマネジメント実体確認:[結果] - 全 .skill リスト(phase3-skills 8件 + phase5-skills 9件 = 17件)


★Phase 5 完了後の最終アクション(工藤さん手作業)

Phase 5 完了で、保存すべき .skill が出揃う: - outputs/phase3-skills/ … 8 .skill(Phase 4 作成) - outputs/phase5-skills/ … 9 .skill(Phase 5 Part 2 作成) - 合計 17 .skill

工藤さんが claude.ai > 設定 > カスタマイズ > スキル で 17 .skill を保存 → 集中原則の全 SKILL 波及が真の SSOT に反映され完了。


絶対遵守事項

  • ❌ Part 1 完了前に Part 2 の .skill 化をしない(順序厳守)
  • ❌ description 1024字超過のまま .skill 化しない
  • ✅ 全成果物は _claude_workspace_global/ 配下(outputs/reports/)
  • ✅ 完了報告に「17 .skill の最終リスト」を明記