name: update-inst
description: user-level/PJ-levelの指示・スキルを個別修正する。使用タイミング: Claudeが間違いを犯した際の再発防止依頼時、/update-inst実行時、作業で得た運用知見をuser-level(AGENTS.md)/PJ-level(CLAUDE.md)・context・スキルに追記する依頼時。境界: 指示ファイル全体のベストプラクティス監査はinstructions-audit、セッション全体からの知見の自律的な洗い出し・反映はsession-retro、新規スキルの作成はcreate-skill。
指示更新スキル
概要
Claudeの間違いの再発防止、または作業で得た知見の恒久化のため、user-level(AGENTS.md)/PJ-level(CLAUDE.md)の指示・context・スキルを更新する。
トリガー条件
/update-inst <間違えた内容 or 追記したい知見> が実行された場合
- Claudeが指示に反した行動をした際に、ユーザーが再発防止を依頼した場合
- 作業中に得た運用知見(コマンドの落とし穴・環境固有の注意点等)をCLAUDE.mdやスキルに反映するよう依頼された場合
実行手順
Phase 1: 問題分析
-
間違いの特定
- 何が間違っていたか
- どこで間違いが発生したか(どのPhase、どの処理)
-
原因の特定
- 指示が不明確だったか
- 例示が誤解を招いたか
- 指示が存在しなかったか
- 優先度が不明確だったか
-
関連ファイルの特定
| ファイル | 確認観点 |
|---|
~/.claude/AGENTS.md(実体。CLAUDE.mdは互換symlink) | 全PJ共通の作業フロー、基本ルール |
~/.claude/context/*.md | 詳細ルール、フォーマット定義 |
~/.claude/skills/*/SKILL.md | スキル固有のルール(user-level) |
./CLAUDE.md | PJ固有ルール・コマンド・環境情報 |
./.claude/skills/*/SKILL.md | PJ固有スキル(運用手順・ドメイン知識) |
./.claude/context/*.md | PJ固有の詳細ルール |
Phase 2: 修正方針の決定
- 修正タイプの判断
| タイプ | 対応 | 例 |
|---|
| 指示の追加 | 新しいルールを追記 | 「〇〇の場合は△△すること」 |
| 指示の明確化 | 曖昧な表現を具体化 | 「yymmdd」→「システムプロンプトのToday's dateから取得」 |
| 例示の修正 | 誤解を招く例を修正 | 固定値の例示→動的な説明 |
| 優先度の明示 | IMPORTANT/CRITICALの追加 | 重要な指示の強調 |
- 修正対象の決定
- user-level(全PJ共通)か、PJ-level(特定PJのみ)かを判断
- 最小限の修正で最大の効果を狙う
- 既存の指示との整合性を確認
Phase 3: 修正の実施
-
修正前の状態を記録
-
修正を提案
## 修正提案
### ファイル: <パス>
**変更前:**
<現在の内容>
**変更後:**
<修正後の内容>
**理由:** <なぜこの修正が必要か>
-
ユーザーの承認を得る
- ユーザーに確認する(Claude Code: AskUserQuestion)
- 必要に応じて修正案を調整
-
修正を適用
Phase 4: 検証
-
整合性の確認
-
今回の間違いが防げるか確認
- 修正後の指示で、同じ間違いが発生しないか
- エッジケースも考慮
修正のベストプラクティス
1. 強調・記述の原則は真実源に従う
- CLAUDE.md のサイズ・強調(IMPORTANT/CRITICAL/YOU MUST)・命令形・理由付けの原則は @context/claude-customization-guide.md §3 に従う(本スキルに重複定義しない。真実源を一つに保つため)
- 詳細ガイドは
@ 参照で context/ に委譲する(常駐コストを避けたい参照は Read-when 形式で誘導)
2. 例示の注意点
- 固定値(日付、ID等)を例示に使わない
- 「システムプロンプトから取得」等の動的な説明を使う
- 例示が誤解を招かないか確認
3. 禁止事項リストの活用
- 繰り返し発生する間違いは「禁止事項」セクションに追加
- 簡潔に記載(理由は別ファイルに)
出力フォーマット
# 指示更新レポート
## 問題
- 間違い: <何が間違っていたか>
- 原因: <なぜ間違いが発生したか>
## 修正内容
### 1. <ファイルパス>
- 修正タイプ: <追加/明確化/例示修正/優先度明示>
- 変更内容: <概要>
## 検証
- 同じ間違いが防げるか: <Yes/No + 理由>
- 整合性: <問題なし/要注意点>
## 適用状態
- [ ] ユーザー承認済み
- [ ] 修正適用済み