HANDOFF — Phase 6 v2：残務クリーンアップ＋ present_files 非依存のスキル保存設計¶

項目	内容
起案	Chat Claude
宛先	Code Claude（ローカル Mac）
起案日	2026-05-17
★v2 追加理由	present_files がターン毎に不安定（3ターン連続で不在）。工藤さんから「常に present_files が起動する設計に」の要望。だが present_files 付与は Anthropic 側ロジックで Claude には制御不能。よって「present_files 非依存の保存設計」へ転換。Part 0 を最優先で新設
所要時間	30-40 分

★Part 0（最優先・新設）：present_files 非依存のスキル保存設計を恒久化¶

0-1. 背景・問題¶

スキル保存フローが present_files に依存していたため、present_files がツールセットに付与されないターン（3連続で発生）で詰まった。present_files の付与は Anthropic 側がターン毎に決定し、Claude は制御不能。よって「present_files に依存しない設計」へ恒久転換する。

0-2. 正規ルートの変更¶

claude.ai のスキル保存は2経路： - 経路1：present_files の「スキルを保存」ボタン（Chat 内・present_files 依存・不安定） - 経路2：claude.ai 設定 > カスタマイズ > スキルでの .skill アップロード（設定画面・present_files 不要・常時可能）

経路2を「正規ルート」とする。経路1は「使えればおまけ」に格下げ。

0-3. kudo-persist-settings への永続化¶

kudo-persist-settings の §スキル更新 .skill 完結原則を以下に全面改訂：

## §スキル更新 .skill 完結原則（v2・2026-05-17 改訂・present_files 非依存）

スキルの新規作成・更新は、SKILL.md 編集だけでは「未完了」。
.skill 化して工藤さんが claude.ai 設定で保存できる状態にするまでが1セット。

### 正規ルート（present_files 非依存・常に機能する）

1. どの環境（Chat/Cowork/Code）でスキルを更新しても → .skill 化
   （{skill-name}/SKILL.md 構造で ZIP、scripts/ 等サブフォルダ同梱）
2. .skill を ~/working/_claude_workspace_global/outputs/skills-to-save/ に配置
3. 完了報告に「保存待ち .skill リスト」を明記
4. 工藤さんが claude.ai > 設定 > カスタマイズ > スキル で
   skills-to-save/ 内の .skill をアップロード保存
5. 保存完了後、Code が次回起動時に skills-to-save/ → skills-saved/{YYYY-MM-DD}/ へ移動

### skills-to-save/ フォルダの状態が示すもの

- 空 = 未保存のスキル更新なし（クリーン）
- 何かある = 未保存の .skill あり（工藤さんの保存待ち）
- 工藤さんは常にこのフォルダだけ見れば保存すべきものが分かる

### present_files の位置づけ（格下げ）

- present_files は Anthropic 側がターン毎に付与を決めるツールで、
  Claude は制御できない。出るターンと出ないターンがある
- よって present_files に依存しない上記「正規ルート」を主とする
- present_files が使えるターンでは、おまけとして .skill を present_files
  しても良い（工藤さんの利便のため）。ただし使えなくても正規ルートで
  完結するため、present_files の有無で作業が止まることはない

### 禁止事項

- present_files が使えないことを理由にスキル保存作業を止めること（禁止）
- 「次のターンで present_files が来るかも」と工藤さんを待たせること（禁止）
- SKILL.md 編集だけで「完了」と報告すること（禁止）

0-4. kudo-ai-error-watchlist に Entry #17 追加¶

### Entry #17：present_files 依存のスキル保存フローが、present_files 不在ターンで詰まった

- 日付：2026-05-17
- 領域：ツール可用性の前提 / ワークフロー設計
- 誤り：スキル保存フローを present_files 前提で設計したため、present_files が
  ツールセットに付与されないターン（3連続）で保存作業が停止。工藤さんに
  「present_files を出せ」と複数回言わせ、フラストレーションを与えた
- 真相：present_files の付与は Anthropic 側がターン毎に決定し、Claude は
  制御も予測もできない。特定ツールの存在を前提にしたワークフローは脆い
- 一次ソース：2026-05-17 の3ターン連続 present_files 不在
- 永続化ルール：ワークフローは「ターン毎に変動しうるツール」を前提にしない。
  スキル保存は claude.ai 設定アップロード（経路2）を正規とし、present_files
  （経路1）に依存しない。同種の「特定ツール前提の設計」を避ける
- 関連：Entry #15/#16 と同じ「作業前の確認不足」系だが、本件は
  「ツール可用性の前提を置きすぎた設計ミス」

Part 1：旧 `_claude_shared/` 削除（Drive ルート直下のミス配置）¶

2026-05-15、Chat が誤って Drive ルート直下に _claude_shared/ を作成。削除する。

ls -la ~/Library/CloudStorage/GoogleDrive-kudotakuma421@gmail.com/My\ Drive/_claude_shared/ 2>/dev/null

中身が「README.md ＋空サブフォルダ」だけなら：

mv ~/Library/CloudStorage/GoogleDrive-kudotakuma421@gmail.com/My\ Drive/_claude_shared ~/.Trash/_claude_shared_$(date +%Y%m%d_%H%M%S)

他のファイルがあれば削除中止して Chat 報告。

Part 2：マスター名簿 v0.6 の所在確認 → master-lists/ 配置¶

find ~ -iname "naming-master-list*" 2>/dev/null

- 見つかれば最新版を ~/working/_claude_workspace_global/master-lists/ に配置 - 見つからなければ完了報告に「マスター名簿 v0.6 は要再生成」と明記

Part 3：リスクマネジメント表記揺れの Mac 実体確認（v8 Task D 残り）¶

ls -la ~/working/顧客ビジネス/ | grep -i "リスクマネジメント"
find ~/working -maxdepth 3 -iname "*リスクマネジメント*" 2>/dev/null

カッコ種別（全角/半角）を確認、kudo-naming-unification-protocol §6 の全角統一原則に沿うか判定。逸脱は mv で統一。結果を報告。

Part 4：validate スクリプトの参照パス確認¶

grep -n "master-list\|Downloads\|master-lists" ~/.claude/scripts/validate_naming_consistency.py

旧パス参照があれば _claude_workspace_global/master-lists/ に修正。

Part 5：auto-snapshot 反映確認（月曜 4:00 cron 後）¶

月曜 4:00 の auto-snapshot 後、最新スナップショットに Phase 3-5 編集が反映されているか確認。月曜まで実行不可なら完了報告に TODO 記載。

Part 6：.skill 再生成（Part 0 の kudo-persist-settings 改訂を反映）¶

Part 0-3 で kudo-persist-settings を改訂、Part 0-4 で kudo-ai-error-watchlist に Entry #17 追加。この2スキルを .skill 化し直して skills-to-save/ の既存版を置き換え。

→ skills-to-save/ の最終 .skill 件数を完了報告に明記（17件のうち2件が更新版に差し替わる）。

Part 7：完了報告¶

~/working/_claude_workspace_global/reports/2026-05-17-phase6-completion.md に配置： - Part 0 present_files 非依存設計の永続化：[結果] - Part 1-5：各結果 - Part 6 .skill 再生成：[skills-to-save/ 最終件数] - ★冒頭に「工藤さんが保存すべき .skill リスト（skills-to-save/ 内・全件）」を明記

絶対遵守事項¶

★ Part 0 を最優先で実行（present_files 非依存設計の恒久化）
❌ present_files が使えないことを理由に作業を止めない
❌ SKILL.md 編集だけで「完了」と報告しない
✅ 全成果物は _claude_workspace_global/ 配下
✅ 更新した .skill は skills-to-save/ に配置・完了報告に保存待ちリスト明記

HANDOFF — Phase 6 v2：残務クリーンアップ ＋ present_files 非依存のスキル保存設計¶