コンテンツにスキップ

Phase 5 v2 完了報告 — 集中原則波及の仕上げ + スキル更新 .skill 完結原則の恒久化

項目
起案 Code Claude(Mac ローカル)
実行日時 2026-05-17 10:35 JST
所要時間 約 35 分
順序遵守 ✅ Part 0 → 1 → 3 → 2 → 4(HANDOFF 絶対遵守事項)

★工藤さんが保存すべき .skill(skills-to-save/ 内・全 17 件)

保存先:claude.ai > 設定 > カスタマイズ > スキル

# .skill サイズ 主要変更(最新版)
1 kudo-naming-unification-protocol.skill 12.9 KB v2.4 集中原則統合
2 kudo-cowork-code-handoff-protocol.skill 28.2 KB v1.13 §13 + v1.14 §3-S スキル更新タスク完了定義
3 kudo-context-routing.skill 7.9 KB v1.3 §1.3 二層ワークスペース規範
4 kudo-gemini-image-bridge.skill 7.9 KB v0.2 出力先 3 分岐
5 kudo-html-publish.skill 10.1 KB v0.5 二層化対応
6 kudo-workflowy-double-save.skill 11.6 KB v3.2 §7 保存先 + global 追記
7 kudo-persist-settings.skill 28.9 KB v3.8 所在マップ拡張 + v3.9 §スキル更新 .skill 完結原則 新設(scripts/validate_skill.py 同梱)
8 kudo-ai-error-watchlist.skill 14.6 KB Entry #15 + Entry #16 追加(15→16 件)
9 kudo-autonomous-execution-protocol.skill 7.0 KB §3 参照を 3 スキルへ張り替え
10 kudo-brand-architecture.skill 13.3 KB §3 参照張り替え + L253 修正
11 kudo-designer-lens-library.skill 14.6 KB §3 参照張り替え + L354 修正
12 kudo-design-mockup.skill 14.7 KB §3 参照張り替え
13 kudo-deck-generation-router.skill 13.7 KB §3 参照張り替え
14 kudo-presenter-lens-library.skill 17.8 KB §3 参照張り替え
15 kudo-proposal-deck.skill 26.9 KB §3 参照張り替え + L728 修正
16 kudo-schedule-budget.skill 10.6 KB §3 参照張り替え(references/ 同梱)
17 kudo-project-state-recovery.skill 4.8 KB L49/L72 reference rot 修正

合計 17 件 / 検証:validate_skill.py で 17 件全件 PASS(7 検査項目)。配置先:~/working/_claude_workspace_global/outputs/skills-to-save/


Part 0:スキル更新 → .skill 完結原則の恒久化

Part 0-2:kudo-persist-settings v3.9 §スキル更新 .skill 完結原則 新設

§.skillファイル形式 セクションのに新セクションを挿入:

  • 判定フロー 3 ステップ:(1) .skill 化したか → (2) 工藤さんが保存できる場所にあるか → (3) 完了報告に保存待ちリスト明記したか
  • skills-to-save/ SSOT 運用:唯一の置き場、未保存検出の指標、保存完了後 skills-saved/{YYYY-MM-DD}/ へ移送
  • 環境別責任分担:Code/Cowork は自分で .skill 化、Chat は present_files、「SKILL.md 編集だけで完了」は規約違反
  • kudo-cowork-code-handoff-protocol §3-S と双方向参照

Part 0-3:kudo-cowork-code-handoff-protocol v1.14 §3-S スキル更新タスクの完了定義 新設

§3 ハンドオフ標準フロー本体のに §3-S を挿入。4 ステップ完了条件(SKILL.md 編集 → .skill 化 → skills-to-save/ 配置 → 保存待ちリスト明記)を規定。kudo-persist-settings §スキル更新 .skill 完結原則 と双方向参照。


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

Part 1-2:8 スキルの CLAUDE.md §3 → 3 スキルへ分岐

定型行(8 件、L15 / L16 / L17)の sed 一括置換:

旧: CLAUDE.md §3「作業環境」(保存先・NFC/NFD・ビューワー・Gist)
新: `kudo-shared-storage-protocol §5.5`(生成物の集中原則・保存先パス規律)
    /`kudo-naming-unification-protocol §6`(NFC/NFD・全角カッコ統一)
    /`kudo-context-routing §1.3`(二層ワークスペース)
    (旧 CLAUDE.md §3 集約索引)

文脈別個別修正(4 箇所): - kudo-autonomous-execution-protocol L191(保存先・NFC/NFD 文脈)/ L194(ディレクトリ規則文脈) - kudo-brand-architecture L253(クラウド同期文脈) - kudo-proposal-deck L728(保存先・Coworkビューワー文脈)

加えて kudo-persist-settings 内の所在マップ表 2 行(L213/L214)を集中原則 SSOT 参照へ修正: - 「GitHub Gist運用 / CLAUDE.md §3+個人設定13」 → kudo-shared-storage-protocol §7 +個人設定13 - 「Google Drive保存ルール / CLAUDE.md §3」 → kudo-shared-storage-protocol §5.5

Part 1-3:CLAUDE.md §3 冒頭に索引注記追加

~/.claude/CLAUDE.md §3 セクション冒頭に blockquote ノート追加:「§3 各規律の実体は各スキルにある。本セクションは Code 環境向けの集約索引であり、Chat/Cowork では各スキルが直接参照される(Phase 5 Part 1 B 案で確定)」+ 3 規律の参照先マップ。


Part 2:17 スキル全件 .skill 化

同梱物発見(事前確認の成果・Entry #16 学習適用)

  • kudo-persist-settingsscripts/validate_skill.py(v1.1 / 6987 B)同梱
  • kudo-schedule-budgetreferences/ 同梱(Phase 5 で発見・Phase 4 までは未検出)

全 17 件 ZIP 構造 valid({skill-name}/SKILL.md + 同梱物)。HANDOFF 命名規則準拠で ~/working/_claude_workspace_global/outputs/skills-to-save/ に配置。

旧 outputs/phase3-skills/ の処理

outputs/phase3-skills/outputs/phase3-skills.archive-phase4/ にリネーム(HANDOFF Part 2-2 「phase3-skills/ は archive 扱いに」準拠)。


Part 2-3:validate_skill.py 全件検査

✅ 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
✅ kudo-autonomous-execution-protocol         ✅ kudo-brand-architecture
✅ kudo-designer-lens-library                 ✅ kudo-design-mockup
✅ kudo-deck-generation-router                ✅ kudo-presenter-lens-library
✅ kudo-proposal-deck                         ✅ kudo-schedule-budget
✅ kudo-project-state-recovery

PASS: 17 / 17
FAIL: 0  / 17

7 検査項目:(1) frontmatter / (2) name / (3) description / (4) description ≤ 1024 字 / (5) XML タグなし / (6) 動詞群明示 / (7) セッション固有パス禁止。


Part 3:kudo-ai-error-watchlist Entry #16 追加

§4 タイトル「14件 → 15件」を「16件」に更新。Entry #15 の後に Entry #16 を挿入:

  • 領域:ファイル探索 / 走査範囲の設定 / Phase 2 監査の不備
  • 誤断言:Phase 3 完了報告で「validate_skill.py 不在」と報告
  • 真相:snapshot の kudo-persist-settings/scripts/ に同梱されていた
  • 永続化ルール:(1) {skill}/scripts/ まで走査、(2) snapshot 配下のサブフォルダを走査範囲に含める、(3) Phase 監査の Phase 0 に「各スキル同梱物一覧」追加

Part 4:リスクマネジメント実体確認

✅ 実体存在:~/working/顧客ビジネス/リスクマネジメント(広報含む)
   - リスクマネジメント活動支援のご提案0528.pptx
   - リスクマネジメント活動支援のご提案0528-DESKTOP-J7OT6ME.pdf
   - リスクマネジメント活動支援のご提案0528.pdf

フォルダ名は全角カッコ「リスクマネジメント(広報含む)」で、マスター名簿 v0.5 の半角カッコ表記とズレ(Phase 1 validate で軸2 として検出された 1 件)。次回マスター名簿 v0.6 で全角カッコに統一すべき箇所。


HANDOFF からの逸脱(reasonable assumption 補正・1 件)

  1. kudo-schedule-budget の references/ 同梱発見:HANDOFF Part 2-1 表は kudo-persist-settings の scripts/ のみ言及していたが、Phase 5 の .skill ZIP build で kudo-schedule-budget/references/ も発見・同梱。Entry #16 の学習(snapshot サブフォルダを走査範囲に含める)を即時適用。

出力物パス

真の永続化(global 集中原則準拠)

  • outputs/skills-to-save/(17 .skill ZIP・★保存待ち SSOT)
  • outputs/phase3-skills.archive-phase4/(旧 8 件・archive 化)
  • outputs/phase3-patches/(SKILL.md 8 件 + CLAUDE.md・Phase 3+4 修正反映)
  • outputs/phase4-patches-extra/(SKILL.md 9 件・Phase 4 Part 1-3)
  • 本完了報告reports/2026-05-17-phase5-completion.md

Code 環境で実体化済

  • ~/.claude/CLAUDE.md(Phase 5 Part 1-3 で §3 索引注記追加・索引化済)
  • ~/.claude/skills.git-mirror/snapshots/2026-05-17/{17 skills}/SKILL.md(直編集・次回 snapshot で消える可能性)

★工藤さんへの次アクション

  1. 17 件 .skill 保存skills-to-save/ から claude.ai > 設定 > カスタマイズ > スキル へ順次保存
  2. 保存完了後の合図:「全部保存した」と伝えていただければ、Code が次回起動時に skills-to-save/skills-saved/2026-05-17/ へ移送する
  3. 次回 auto-snapshot(月曜 4:00)後の確認:snapshot に v3.9 / v1.14 / v1.3 / v2.4 / Entry #16 等が反映されているか
  4. マスター名簿 v0.6(任意):リスクマネジメント(広報含む)の表記揺れ解消 + naming-master-list を _claude_workspace_global/master-lists/ に新規配置(現状は外部 Desktop に v0.4 のみ)

絶対遵守事項チェック

  • ✅ Part 0 → Part 1 → Part 3 → Part 2 の順序厳守(HANDOFF 指示通り)
  • ✅ SKILL.md 編集だけで「完了」と報告していない(17 件全件 .skill 化済)
  • ✅ .skill は skills-to-save/ のみに配置
  • ✅ 完了報告冒頭に「保存待ち .skill リスト」明記
  • ✅ description 1024 字を全 17 件で validate(7 検査項目 PASS)