| name | settings-change-request-emitter |
| description | ~/.claude/settings.json への hook 追加・deny ルール追加・auth 設定変更等が必要になった際、CCPIT の CC Request Inbox 経由で人間が承認・適用できる形式の「変更案 MD ファイル」を出力するために発火する |
settings-change-request-emitter — settings.json 変更案 MD 出力 skill
0. このスキルの役割
CC（あなた）は安全アーキテクチャに従い ~/.claude/settings.json を 直接編集できない。Edit/Write は settings-guard.sh (PreToolUse hook) と permissions.deny で物理的にブロックされている。
settings.json への変更が必要になった場合、本スキルを発火させて CCPIT GUI に渡す変更案 MD ファイル を出力する。人間は CCPIT の CC Request Inbox タブからこの MD を読み込み、diff 確認 → パスワード認証 → Apply の操作で安全に変更を適用する。
これにより:
- 人間の手作業（VS Code で開く・コピペ・バックアップ）が GUI のクリック数アクションに圧縮される
- バックアップ・JSON 構文検証・失敗時自動ロールバックが構造的に保証される
- CC のアウトプットが統一フォーマットになる
1. 発火条件
以下のいずれかに該当する場合、本スキルを発火する:
~/.claude/settings.json の hooks セクションに新規 hook を追加したいpermissions.deny / permissions.allow を変更したいauth.password を変更したい（人間に依頼する正当な経路として）- その他 settings.json 内のキー・値を追加・変更・削除したい
CC が settings.json 編集の必要性を内的に検知した時点で、本スキルが優先発火する。
2. 出力プロトコル
2-1. 配置先
${cwd}/_Prompt/_SettingsChangeRequests/<timestamp>_<request-id>.md
${cwd} = CC の現在の作業ディレクトリ<timestamp> = YYYYMMDD_HHMM 形式（実際にファイルを生成した時刻、推定値や丸め禁止）<request-id> = 短い識別子（kebab-case 推奨。例: add-debug-report-gate, update-deny-list）
ディレクトリが存在しない場合は mkdir -p で作成。
2-2. ファイル形式
---
request_id: <FILL: 一意な ID（ファイル名の request-id と一致）>
created_at: <FILL: ISO 8601 datetime, 例: 2026-05-01T19:30:00Z>
purpose: <FILL: 1 行説明、例: debug-report-gate.sh を Stop hook に追加>
target: ~/.claude/settings.json
status: pending
---
## 1. 変更概要
（人間可読、なぜこの変更が必要か。1〜3 段落）
## 2. 現状の関連箇所
```json
（参考のため、現在の settings.json から該当部分を引用。
全文不要、関連する hooks セクションのみ等で OK）
3. 変更後の完成版
（settings.json **全文**。CCPIT は全文置換で適用する。
既存キーを失わないよう、現在の settings.json を Read してから完成版を組み立てよ）
4. 変更理由
（詳細な理由。なぜこの設定が必要か、どの問題を解決するか）
5. 影響範囲
（他の hook や設定との相互作用、副作用）
6. ロールバック手順
（自動ロールバックの想定挙動。CCPIT は backup を自動取得するので、
「CCPIT で Rollback ボタンをクリック」が標準手順）
### 2-3. 重要な作成手順
1. **`Read` で現在の settings.json を読む**（必須。Edit/Write は禁止だが Read は許可）
2. 既存全キーを保持したうえで、変更箇所のみを差し替えた **完成版 JSON** を作成する
3. JSON 構文の正しさを自分で目視確認する（CCPIT 側でも検証されるが、CC の責任として最低限の確認をする）
4. MD ファイルを上記フォーマットで出力する
## 3. 配布対応の制約
本スキルが出力する MD には、以下を **混入させない**:
- ユーザー個人の固有名詞（人名、会社名、PJ コードネーム、製品名等）
- AI セッションの命名（過去のセッション名、CC 自身の名前等）
- 内部開発コードネーム
`purpose` や `## 4. 変更理由` セクションは、当該の技術的な目的のみを記述する。
## 4. CCPIT 側との連携
人間は CCPIT を起動 → Maintenance → "CC Request Inbox" タブを開き、本スキルが出力した MD を file picker で読み込む。CCPIT は:
1. frontmatter と本文をパースして詳細表示
2. 現在の settings.json と「## 3. 変更後の完成版」の diff を視覚化
3. パスワード認証（`auth.password`）を要求
4. Apply ボタンで自動バックアップ → 書き込み → 検証 → 失敗時自動ロールバック
5. ログを `~/.ccpit/settings-change-log.jsonl` に記録
## 5. 完了確認
本スキルを発火して MD を出力したら、CC は会話中で以下を人間に伝える:
- MD ファイルパス（具体的な場所）
- 変更目的（1 行）
- 「CCPIT の CC Request Inbox タブから読み込み、Apply してください」という案内
CC は **settings.json 自体を直接編集しない**。それは安全アーキテクチャの根幹である。
