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 日本語ローケールでは マイドライブ/。実体パスに補正して削除実行:
1-2. 中身(想定通り)¶
- README.md(2579 B・「3環境共通SSOTストレージ」と謳う旧仕様の説明)
- master-lists/ handoffs/ outputs/ reports/(全て空)
- 想定外ファイルなし → 削除実行 OK
1-3. ゴミ箱移動¶
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. 実体確認¶
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"
4-2. symlink 張り替え(HANDOFF 逸脱 3)¶
新 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 件)¶
- Part 1:
My Drive/→マイドライブ/パス補正(Mac 日本語ローケール) - Part 3:ls grep / find -iname が NFD のため不発、Python
Path.iterdir()直接走査で代替(NFC/NFD ズレの副次的発見として記録) - 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)
★工藤さんへの次アクション¶
- 17 件 .skill 保存(正規ルート / 経路2):
~/working/_claude_workspace_global/outputs/skills-to-save/を Finder で開き →claude.ai > 設定 > カスタマイズ > スキルで 17 件を順次アップロード保存 - 保存完了の合図:「全部保存した」と伝えれば Code が
skills-to-save/→skills-saved/2026-05-18/へ移送 - 次回 auto-snapshot(月曜 4:00)後の確認:snapshot に v3.10 / Entry #17 等が反映されているか
- マスター名簿 v0.6 生成(Chat 側) →
master-lists/に直接配置 + symlink を v0.6 に張り替え - 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 件明記