# Skill > スキルが失敗・批判を受けたとき，根本原因を診断してその定義を更新し再発を防ぐ．どのスキルにも適用できる． - Skill: `tomoking2004/skill` (Agent Skill) - Install (CLI): `npx skillmds@latest add tomoking2004/skill` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomoking2004/skill/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomoking2004 (https://skillmd.com/u/tomoking2004) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/tomoking2004/skill --- 対象：失敗を招いた**定義**——ふつうはそのスキルの SKILL.md だが，スキルが従う正典（BEAUTY.md・RUBRIC.md 等，複数のスキルが参照する基準文書）も対象に含む．失敗が個々の手順ではなく基準そのものの未完に由来するなら，正典の側を直す． ## 手順 1. **在処の特定**：下の「定義の在処」に従い，直す先を決める——ここを誤ると，効いたように見えて次の更新で消える． 2. **診断**：定義を読み，下の「類型と更新先」で失敗を分類する（複合も可）．あわせて，その規則が**実物と合っているか**を確かめる——コマンド・パス・ツールの仕様・プラットフォームの前提は，書いた時点で正しくても失効する．定義が現実と食い違っていたなら，類型に関わらず実物で裏取りしてから書き直す． 3. **更新**：類型に対応する節にピンポイントで追記・修正する——周辺を書き直さない． 4. **走査**：下の「固有の走査」を全件通し，ゼロを確認して確定する． ## 定義の在処 同じ定義が複数の場所に存在しうる． - **ソース**（リポジトリの作業ツリー・プロジェクトの `.claude/skills/`）：手元にあればここが唯一の真実．ここを直す． - **導入済みの実体**（`~/.claude/plugins/cache////`）：ソースが手元に無いときの最後の手段．書き換えれば今すぐ効くが，**プラグインの更新・再導入で上書きされて消える**．直した上でそのことを告げ，上流（リポジトリへの反映，他人のプラグインなら issue・PR）へ渡す道を示す——さもないと同じ失敗が更新のたびに蘇る． - 両方が手元にあるならソースを直したことを告げ，今のセッションに反映したいなら `/reload-plugins`（または次セッション）で読み直せると伝える． ## 失敗の定義 次のいずれかを失敗とみなす． - ユーザーが出力の誤り・不足を指摘した． - ユーザーが期待と異なることを表明した（「違う」「そうじゃない」等）． - 規則では次の一手が決まらなかった（未定義・矛盾）． ## 類型と更新先 - **確認漏れ**（見るべきファイル・状態・依存を確認していなかった）→ 確認・走査規則の節（なければ手順節の該当ステップ）に追記． - **基準未定義**（判断すべき規則が定義に書かれていなかった）→ 該当節に規則を追加（なければ節を新設）． - **手順誤り**（ステップの順序・方法を誤った，または必要なステップを省略した）→ 手順節を修正（順序・省略禁止を明記）． - **適用範囲誤認**（スキルの対象・除外・前提を誤解した）→ 対象・前提の定義を明確化． - **判断ミス**（基準はあったが適用を誤った）→ 制約・走査節に例外条件を追記（なければ節を新設）． ## 固有の走査 定義は放っておくと単調増加する——追記だけを重ね，SKILL.md は膨らみ，description（全セッションに常駐する）は長くなり，やがて読まれなくなる．確定前に全件を通す． - **防止確認**：今回の失敗がこの規則で防げるか，通読して確かめる． - **吸収**：既存の規則を一段深めれば足りたのではないか——足りるなら足した項を消し，そちらを直す． - **失効**：今回の更新で不要になった規則・前提が残っていないか——**削除も更新のうち**． - **一般化の広さ**：一度の失敗から広すぎる禁止則を立てていないか——正しい振る舞いまで潰す．規則は失敗を防ぐ最小の広さに留める． ## 失敗時 本書自身が失敗すれば，他のスキルは呼ばず「手順」以降を本書自身に適用する．