コンテンツにスキップ

Phase 6 v2 完了報告 — 残務クリーンアップ + present_files 非依存のスキル保存設計

項目
起案 Code Claude(Mac ローカル)
実行日時 2026-05-18 05:55 JST(v1 = 05:15、v2 追記 = 05:55)
所要時間 v1 約 15 分 + v2 追加 約 20 分 = 計 約 35 分
順序遵守 ✅ Part 0 最優先 → Part 1-5(v1 で完了)→ Part 6 → Part 7

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

保存先claude.ai > 設定 > カスタマイズ > スキル.skill ファイルをアップロード(正規ルート / 経路2 / present_files 非依存

# .skill 最新変更
1 kudo-naming-unification-protocol.skill v2.4 集中原則統合(Phase 3)
2 kudo-cowork-code-handoff-protocol.skill v1.13 §13 + v1.14 §3-S
3 kudo-context-routing.skill v1.3 §1.3 二層ワークスペース規範
4 kudo-gemini-image-bridge.skill v0.2 出力先 3 分岐
5 kudo-html-publish.skill v0.5 二層化対応
6 kudo-workflowy-double-save.skill v3.2 §7 保存先 + global 追記
7 kudo-persist-settings.skill v3.10 §スキル更新 .skill 完結原則を present_files 非依存版に改訂(Phase 6 v2 で更新)
8 kudo-ai-error-watchlist.skill Entry #17 追加(16→17 件・Phase 6 v2 で更新)
9 kudo-autonomous-execution-protocol.skill §3 参照を 3 スキルへ張り替え(Phase 5)
10 kudo-brand-architecture.skill §3 参照張り替え
11 kudo-designer-lens-library.skill §3 参照張り替え
12 kudo-design-mockup.skill §3 参照張り替え
13 kudo-deck-generation-router.skill §3 参照張り替え
14 kudo-presenter-lens-library.skill §3 参照張り替え
15 kudo-proposal-deck.skill §3 参照張り替え
16 kudo-schedule-budget.skill §3 参照張り替え
17 kudo-project-state-recovery.skill L49/L72 reference rot 修正

合計 17 件(うち 2 件が Phase 6 v2 で再生成・置換済)。validate_skill.py で 17/17 PASS(kudo-persist-settings は description 1024/1024 ぴったり WARN)。


★Part 0:present_files 非依存のスキル保存設計を恒久化(v2 で新設)

Part 0-3:kudo-persist-settings v3.10 §スキル更新 .skill 完結原則 全面改訂

v3.9(present_files 主経路)→ v3.10(present_files 非依存)。改訂点:

  • claude.ai スキル保存の 2 経路を明示:経路1(present_files)= 不安定でおまけ / 経路2(claude.ai 設定 UI で .skill アップロード)= 正規ルート
  • 判定フロー 3 → 5 ステップに拡張:(1) どの環境でも .skill 化 → (2) skills-to-save/ 配置 → (3) 保存待ちリスト明記 → (4) 工藤さん UI アップロード → (5) Code 起動時 skills-saved/ へ移送
  • skills-to-save/ フォルダ状態の意味:空 = クリーン、何かある = 未保存あり。工藤さんは常にここだけ見れば保存すべきものが分かる
  • 禁止事項 4 項目:(1) present_files 不在を理由に停止禁止 / (2) 「次ターンで来るかも」と待たせる禁止 / (3) SKILL.md 編集だけで完了報告禁止 / (4) 「特定ツールが必ず使える」前提のワークフロー設計禁止(Entry #17 教訓)
  • description は v3.9 で 1024/1024 上限のため v3.10 言及は本文と改訂履歴にのみ記録(description は変更せず)

Part 0-4:kudo-ai-error-watchlist Entry #17 追加(16 → 17 件)

  • 領域:ツール可用性の前提 / ワークフロー設計
  • 誤断言:スキル保存フロー(v3.9)を present_files 前提で設計
  • 真相:present_files の付与は Anthropic 側がターン毎に決定。Claude は制御も予測もできない。特定ツール前提の WF は構造的に脆い
  • 一次ソース:2026-05-17 の 3 ターン連続 present_files 不在事象
  • 永続化ルール 4 項目:(1) ターン毎変動ツールを前提にしない、(2) スキル保存は経路2を正規に、(3) 同種の特定ツール前提設計回避(web サーチ・特定 MCP も同様)、(4) ツール不在で停止しそうな時は代替ルートを即チェック
  • 関連:Entry #15/#16 と同じ「作業前の確認不足」系、ただし本件は「ツール可用性の前提を置きすぎた設計ミス」

Part 1:旧 _claude_shared/ 削除(v1 で完了済)

1-1. 実体場所の補正(HANDOFF 逸脱 1)

HANDOFF は My Drive/_claude_shared/ だが、Mac の Google Drive 日本語ローケールでは マイドライブ/。実体パスに補正して削除実行:

~/Library/CloudStorage/GoogleDrive-kudotakuma421@gmail.com/マイドライブ/_claude_shared/

1-2. 中身(想定通り)

  • README.md(2579 B・「3環境共通SSOTストレージ」と謳う旧仕様の説明)
  • master-lists/ handoffs/ outputs/ reports/(全て空)
  • 想定外ファイルなし → 削除実行 OK

1-3. ゴミ箱移動

mv ... ~/.Trash/_claude_shared_20260518_051210
Drive 同期反映済み(Monitor で約 10 秒で消失確認)。


Part 2:マスター名簿 v0.6 探索結果(v1 で完了済)

2-1. 全 FS 探索結果

✓ Desktop: v0.2 / v0.4
✓ Downloads: latest.xlsx → Desktop/v0.4 symlink
✓ マイドライブ: v0.2.gsheet / 案件直下 _claude_workspace/01_input/v0.2.xlsx
✓ Chat sandbox uploads: v0.2 / v0.4 / v0.4-hash 過去ログ
✗ _claude_workspace_global/master-lists/ — 空
✗ v0.6 — どこにも無し

2-2. 結論

マスター名簿 v0.6 は本 Mac に不在。再生成は Chat 側タスク。

2-3. 副次的論点

現状 v0.4 が ~/Desktop/ に置かれており集中原則違反。次フェーズで v0.6 を生成する際は 直接 _claude_workspace_global/master-lists/ に配置を推奨。


Part 3:リスクマネジメント実体カッコ種別(v1 で完了済)

3-1. 実体確認

/Users/kudotakuma/working/顧客ビジネス/リスクマネジメント(広報含む)

3-2. 文字コードレベル判定

  • 文字数 16 / バイト数 48
  • 開きカッコ pos 10 U+FF08 FULLWIDTH LEFT PARENTHESIS
  • 閉じカッコ pos 15 U+FF09 FULLWIDTH RIGHT PARENTHESIS

3-3. 判定

全角「()」で kudo-naming-unification-protocol §6 の全角統一原則と整合。修正不要。

3-4. 副次的発見

NFC 一致 = False(Mac APFS が NFD 保存)。ls grep / find -iname はヒットせず、Python の Path.iterdir() 直接走査でのみ発見(HANDOFF 逸脱 2)。新規スクリプト作成時は NFC 正規化必須。


Part 4:validate_naming_consistency.py 参照パス修正(v1 で完了済)

4-1. 修正前/後

# 旧
XLSX = Path.home() / "Downloads/naming-master-list-latest.xlsx"
# 新(v2.4 §9-2 / shared-storage-protocol §5.5 / CLAUDE.md §3.1 準拠)
XLSX = Path.home() / "working/_claude_workspace_global/master-lists/naming-master-list-latest.xlsx"

新 SSOT 配下に latest symlink を作成(v0.6 が出るまで Desktop v0.4 を指す暫定運用):

~/working/_claude_workspace_global/master-lists/naming-master-list-latest.xlsx
  → ~/Desktop/naming-master-list-v0.4.xlsx

4-3. 動作確認

Report: ~/.claude/logs/naming-consistency/20260518-051243-validation-minor.md
Severity: minor(「リスクマネジメント(広報含む)」未登録のみ・v0.6 で解消予定)

Part 5:auto-snapshot 反映確認

📅 TODO(月曜 4:00 後):次回 auto-snapshot で snapshot に Phase 3-6 編集(17 スキル + CLAUDE.md + Entry #15/#16/#17 + v3.10)が反映されているか確認。


Part 6:.skill 再生成(v2 で追加実行)

Part 0-3 / 0-4 で更新した 2 スキルを .skill 再生成して skills-to-save/ の既存版を置き換え:

スキル 旧サイズ 新サイズ
kudo-persist-settings.skill 28938 B(Phase 5 / v3.9) 29577 B(v3.10)
kudo-ai-error-watchlist.skill 14592 B(Phase 5 / 16件) 15235 B(17件)

validate_skill.py で 2/2 PASS(kudo-persist-settings は description 1024/1024 で WARN マーカー)。

skills-to-save/ 最終件数:17 件(うち 2 件が Phase 6 v2 更新版に差し替え済)。


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

  1. Part 1:My Drive/マイドライブ/ パス補正(Mac 日本語ローケール)
  2. Part 3:ls grep / find -iname が NFD のため不発、Python Path.iterdir() 直接走査で代替(NFC/NFD ズレの副次的発見として記録)
  3. Part 4:symlink 張り替え追加(パス修正だけだと validate が即時稼働できないため、新 SSOT 配下に latest symlink を作成し動作確認まで完了)

出力物パス

Phase 6 v2 で新規/更新

  • ~/.Trash/_claude_shared_20260518_051210/(旧 _claude_shared 退避)
  • ~/.claude/scripts/validate_naming_consistency.py(XLSX パス修正)
  • ~/working/_claude_workspace_global/master-lists/naming-master-list-latest.xlsx(暫定 symlink)
  • ~/.claude/logs/naming-consistency/20260518-051243-validation-minor.md(新 SSOT 動作確認)
  • ~/working/_claude_workspace_global/outputs/skills-to-save/kudo-persist-settings.skill(v3.10 再生成版)
  • ~/working/_claude_workspace_global/outputs/skills-to-save/kudo-ai-error-watchlist.skill(Entry #17 追加版)
  • 本完了報告:~/working/_claude_workspace_global/reports/2026-05-17-phase6-completion.md(v2 統合版で上書き)

スナップショット直編集(次回 auto-snapshot で上書き可能性あり)

  • ~/.claude/skills.git-mirror/snapshots/2026-05-17/kudo-persist-settings/SKILL.md(v3.10)
  • ~/.claude/skills.git-mirror/snapshots/2026-05-17/kudo-ai-error-watchlist/SKILL.md(Entry #17)

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

  1. 17 件 .skill 保存(正規ルート / 経路2)~/working/_claude_workspace_global/outputs/skills-to-save/ を Finder で開き → claude.ai > 設定 > カスタマイズ > スキル で 17 件を順次アップロード保存
  2. 保存完了の合図:「全部保存した」と伝えれば Code が skills-to-save/skills-saved/2026-05-18/ へ移送
  3. 次回 auto-snapshot(月曜 4:00)後の確認:snapshot に v3.10 / Entry #17 等が反映されているか
  4. マスター名簿 v0.6 生成(Chat 側)master-lists/直接配置 + symlink を v0.6 に張り替え
  5. Desktop の v0.2 / v0.4 整理(任意) → v0.6 生成後に削除 or archive

絶対遵守事項チェック

  • ✅ Part 0 最優先で実行(v2 改訂の核心)
  • ✅ present_files 不在を理由に作業を止めていない(経路2 で完結)
  • ✅ SKILL.md 編集だけで「完了」と報告していない(2 スキル再 .skill 化済)
  • ✅ 全成果物は _claude_workspace_global/ 配下(完了報告 / skills-to-save/ / master-lists symlink)
  • ✅ 完了報告冒頭に「保存待ち .skill リスト」全 17 件明記