Skip to content
cccskills
FreePublished on GitHub

skill

スキルが失敗・批判を受けたとき,根本原因を診断してその定義を更新し再発を防ぐ.どのスキルにも適用できる.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md4.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

対象:失敗を招いた定義——ふつうはそのスキルの SKILL.md だが,スキルが従う正典(BEAUTY.md・RUBRIC.md 等,複数のスキルが参照する基準文書)も対象に含む.失敗が個々の手順ではなく基準そのものの未完に由来するなら,正典の側を直す.

手順

  1. 在処の特定:下の「定義の在処」に従い,直す先を決める——ここを誤ると,効いたように見えて次の更新で消える.
  2. 診断:定義を読み,下の「類型と更新先」で失敗を分類する(複合も可).あわせて,その規則が実物と合っているかを確かめる——コマンド・パス・ツールの仕様・プラットフォームの前提は,書いた時点で正しくても失効する.定義が現実と食い違っていたなら,類型に関わらず実物で裏取りしてから書き直す.
  3. 更新:類型に対応する節にピンポイントで追記・修正する——周辺を書き直さない.
  4. 走査:下の「固有の走査」を全件通し,ゼロを確認して確定する.

定義の在処

同じ定義が複数の場所に存在しうる.

  • ソース(リポジトリの作業ツリー・プロジェクトの .claude/skills/):手元にあればここが唯一の真実.ここを直す.
  • 導入済みの実体(~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/):ソースが手元に無いときの最後の手段.書き換えれば今すぐ効くが,プラグインの更新・再導入で上書きされて消える.直した上でそのことを告げ,上流(リポジトリへの反映,他人のプラグインなら issue・PR)へ渡す道を示す——さもないと同じ失敗が更新のたびに蘇る.
  • 両方が手元にあるならソースを直したことを告げ,今のセッションに反映したいなら /reload-plugins(または次セッション)で読み直せると伝える.

失敗の定義

次のいずれかを失敗とみなす.

  • ユーザーが出力の誤り・不足を指摘した.
  • ユーザーが期待と異なることを表明した(「違う」「そうじゃない」等).
  • 規則では次の一手が決まらなかった(未定義・矛盾).

類型と更新先

  • 確認漏れ(見るべきファイル・状態・依存を確認していなかった)→ 確認・走査規則の節(なければ手順節の該当ステップ)に追記.
  • 基準未定義(判断すべき規則が定義に書かれていなかった)→ 該当節に規則を追加(なければ節を新設).
  • 手順誤り(ステップの順序・方法を誤った,または必要なステップを省略した)→ 手順節を修正(順序・省略禁止を明記).
  • 適用範囲誤認(スキルの対象・除外・前提を誤解した)→ 対象・前提の定義を明確化.
  • 判断ミス(基準はあったが適用を誤った)→ 制約・走査節に例外条件を追記(なければ節を新設).

固有の走査

定義は放っておくと単調増加する——追記だけを重ね,SKILL.md は膨らみ,description(全セッションに常駐する)は長くなり,やがて読まれなくなる.確定前に全件を通す.

  • 防止確認:今回の失敗がこの規則で防げるか,通読して確かめる.
  • 吸収:既存の規則を一段深めれば足りたのではないか——足りるなら足した項を消し,そちらを直す.
  • 失効:今回の更新で不要になった規則・前提が残っていないか——削除も更新のうち.
  • 一般化の広さ:一度の失敗から広すぎる禁止則を立てていないか——正しい振る舞いまで潰す.規則は失敗を防ぐ最小の広さに留める.

失敗時

本書自身が失敗すれば,他のスキルは呼ばず「手順」以降を本書自身に適用する.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

clean

Free

このマシンに溜まった Claude Code の履歴・痕跡・キャッシュを,何を消すか列挙して承認を得たうえで消し,ログイン・設定・導入済みプラグインは残す.「Claude Code の履歴を消して」「痕跡を掃除して」など,Claude Code がローカルに残したものの削除を明示的に求められたときだけ使う——「クリーンアップして」等の一般の整理の依頼では発動しない.実行中ジョブのログを見たいだけなら /ops:progress を使う.

The English summary is being prepared. Showing the original description.

tomoking2004/claude-plugins3Updated Jul 23, 2026

code

Free

コード(スクリプト・設定含む)を美の基準で走査し,公開挙動を保ったまま最も美しい確定版へ仕上げる.「コードを完璧にして」「リファクタして美しく」「コードを洗練して」など,コードの仕上げを求められたときに使う(単発の小修正には使わない).

The English summary is being prepared. Showing the original description.

tomoking2004/claude-plugins3Updated Jul 23, 2026

commit

Free

変更を意味単位のコミットに分割し,各メッセージを全文で提案.承認後にステージ〜コミットのみ実行する(push しない).「コミットして」「変更を記録して」など,記録を求められたときに使う(スキル名の指定は要らない)——素の git commit で済ませない.版を公にするなら /capstone:release を使う.

The English summary is being prepared. Showing the original description.

tomoking2004/claude-plugins3Updated Jul 23, 2026

複数の媒体(レポート・コード等)にまたがる大学の課題を,出題文・採点基準に照らして過不足なく仕上げる.要求を媒体へ割り当て,assignment プラグインの対応スキルへ委譲し,媒体間の継ぎ目を走査して一つの提出物として確定する.「この課題をやって」「課題を完璧に仕上げて」など,課題まるごとを任されたときに使う(単一媒体なら /assignment:report ・ /assignment:program を直接使う).

The English summary is being prepared. Showing the original description.

tomoking2004/claude-plugins3Updated Jul 23, 2026

docs

Free

参照文書(README・SKILL.md・API 文書・Markdown 全般)を美の基準で走査し,最も美しい確定版へ仕上げる.「READMEを完璧にして」「ドキュメントを美しくして」など,文書の仕上げを求められたときに使う(単発の小修正には使わない).

The English summary is being prepared. Showing the original description.

tomoking2004/claude-plugins3Updated Jul 23, 2026

exec

Free

数十秒を超えて走るプログラム・スクリプト(学習・評価・データ処理・サーバ等)をログを残す形で起動し,異常の早期検知と完了報告まで担う.「実行して」「動かして」「学習を回して」など,明示の有無に関わらず自動適用する.数十秒で終わる実行(テスト・ビルド・lint 等)は対象外.既に動いているものの状況を知りたいだけなら /ops:progress,UI を見た目で確かめたいだけなら組み込みの run スキルを使う.

The English summary is being prepared. Showing the original description.

tomoking2004/claude-plugins3Updated Jul 23, 2026

See all skills by tomoking2004

Report a problem with this skill