スキルのカタログ
・書いた日時 2026-11-11T23:02:53+09:00
最新の記録で作り直す: python3
スキルのファイルと検証の記録を読み直し、一覧とすべてのページを作る。skill-foundation の run.py finish も、終えるたびに同じことをする
skill-foundation で作ったスキル
write-commit-message
コミットメッセージを書く
ステージ済みの差分とチケットIDから、このリポジトリの形式のコミットメッセージを1つ書く
先に見るもの
- 問題なしEval・違反の検出・hooks の動作・収束テストに、先に見るべきものは無い。
作っていない 理由: 公開作例の隔離実行で、実ユーザーとの価値の確認と独立AIの実行を行わないため
SKILL.md の「2. 手順」と出力の決まり(assets/contract.json)から描いた流れ。左の番号が手順、右が最後のラウンドの収束テストで、独立エージェント(これまでの会話を持たないエージェント)が残した記録。カードに重ねると本文が出る。
run.py start・check・finish)のある手順hooks が働く範囲↻ 繰り返す 通るまで繰り返す手順(エラー 0 件まで、すべて成功まで、直してやり直す)。番号の横の輪■ 終了 途中で終える道(「〜なら…終える」)◇ 条件 文の頭の「〜なら、」「〜なければ、」で変わる作業↩ 戻る 手順の文にある戻り(「手順Nに戻る」)。戻る元のカードに、戻る場合と戻り先、「└ なぜ」に終了コードの意味(スクリプトの説明の「終了コード:」の行)と戻った先で直すことを書くID機械が確かめるルールIDスクリプト・ひな形IDレビュー・文書だけ(✓ ✕ は、違反の見本を検査が止めたかどうか)手順の本文(SKILL.md の「2. 手順」)
- 依頼から「3. 入力」の項目を読み取る。表で「start の前に聞く」とある項目が依頼に無ければ、ここでまとめてユーザーに聞く(CTL-03)
python3 <skill>/scripts/run.py start --set ticket=<チケットID> "<依頼文>"を実行する。終了コード3なら、出力された質問をユーザーに聞き、答えを--setで渡してやり直す(CTL-01)python3 <skill>/scripts/collect_diff.pyを実行する。終了コード4なら IN-01、終了コード2なら STEP-04 に従って中断する。出力に出たファイルと差分だけを材料にする。git はこのスクリプトの中だけで使い、git add・git commitを実行しない(IN-02、STEP-01、STEP-03)- 1行目を
<チケットID> <要約>の形で書く。チケットIDは start が出したticketの値を使い、要約は「<対象>を<動詞>する」の形にする。[skip ci]のような CI を止める記法は書かない(OUT-02、OUT-03、OUT-04、OUT-05、OUT-06) - 2行目を空行にし、3行目から本文を、collect_diff.py が出した「本文の単位」と STEP-02 の場合分けに従って書く。形は見本
assets/examples/commit-message.txtと同じにする。書いたものを.skill-runs/write-commit-message/out/commit-message.txtに保存する(OUT-01、STEP-02) python3 <skill>/scripts/run.py checkを実行する。「整形」で始まる行は check が契約の format で自動で直した記録なので、ファイルを読み直す。指摘があれば、ルールIDを「4. ルール」で引いて出力を直す。検査や契約を変えて通さない- 決めきれなかったことがあれば
.skill-runs/write-commit-message/notes.mdに「- 」の箇条書きで書き、python3 <skill>/scripts/run.py finishを実行する。終了コード1なら手順6に戻る。終了コード0なら、出力された本文をそのまま返答する(RPT-01)
hooks の方針
決めたall を指定されたので、聞かずに決めた| 出力の検査 | 使う編集の直後と応答を終える前に自動で検査する |
|---|---|
| 登録する製品 | Claude Code・CodexCodex は /hooks で信頼するまで動かない |
| 利用中の指摘 | 集める完了の後の発言と、直す前と後の成果物を記録する |
| 登録先 | プロジェクトの設定install.py が .claude/settings.json・.codex/hooks.json に書く |
記録: dev/hooks-plan.json(hooks_plan.py が書く)。受付の後に init_skill.py が dev/spec.json の control に写す
hooks のライフサイクル
登録済みhooks は、Claude Code や Codex が決まった時機(イベント)に自動で実行するコマンド。下の図は、公式ドキュメント(code.claude.com/docs/ja/hooks)にあるイベントの流れを、同じ配置と色で描いたもの。
write-commit-message は、太い枠と札の付いた 4 つのイベント(UserPromptSubmit、PreToolUse、PostToolUse、Stop)に hooks を置いている。札は、置いている製品。箱を押すと、右にそのイベントで何が起きるかが出る。
Setup
--init-only で起動したときか、-p と --init・--maintenance で起動したときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。終了コードと出力は無視される。
- 絞り込み
- 起動したフラグ(init、maintenance)で、呼ぶ場面を絞り込める(matcher)。
SessionStart
セッションを始めたとき・再開したときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。出力はユーザーにだけ見える。
- 絞り込み
- 始め方(startup、resume、clear、compact、fork)で、呼ぶ場面を絞り込める(matcher)。
UserPromptSubmit このスキルが使う
ユーザーの発言を Claude が処理する前に呼ばれる。
write-commit-message の hooks がすること
ユーザーが発言するたびに、write-commit-message が質問の答えを待っているか(run.py wait の後か)を確かめる。
- 待っていれば、待ちを解き、休んでいた検査を再開する
- 待っていなければ、何もしない
- どちらのときも、発言を止めたり書き換えたりはしない
- write-commit-message が出力を見せた後の発言なら、発言をそのまま記録し、出力への指摘かどうかを Claude に分けさせる。直したら、直す前と後を並べた確認画面の URL を渡させ、承認はユーザーが画面のボタンで行う
ねらい質問の答えをもらったら、休んでいた検査を自動で再開する(質問している間は、run.py wait が検査を休ませている)。使っている間に受けた指摘と、直した結果にユーザーが納得したかを、次の改善の材料として残す。
hooks はプロジェクト全体に効くため、別のセッションでの発言でも待ちが解ける。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、発言は Claude に届かない。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
登録の中身 Claude Code: 登録済み・Codex: 登録済み
Claude Code登録済みプロジェクトの設定(.claude/settings.json)に書いてある
- 絞り込み
- なし(いつも呼ぶ)
- 時間の上限
- 10 秒
python3 "$CLAUDE_PROJECT_DIR/.claude/skills/write-commit-message/scripts/hook.py" --platform claude prompt
Codex登録済みプロジェクトの設定(.codex/hooks.json)に書いてある
- 絞り込み
- なし(いつも呼ぶ)
- 時間の上限
- 10 秒
python3 "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.agents/skills/write-commit-message/scripts/hook.py" --platform codex prompt
UserPromptExpansion
入力したコマンドがプロンプトに展開されるとき(Claude に届く前)に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、コマンドは展開されない。
- 絞り込み
- コマンドの名前で、呼ぶ場面を絞り込める(matcher)。
PreToolUse このスキルが使う
ツールを呼ぶ前に呼ばれる。
write-commit-message の hooks がすること
Claude がファイルを編集しようとするたびに、編集先を確かめる。実行記録(1)は write-commit-message を実行している間(run.py start から finish まで)だけ守り、指摘の記録(3)はいつも守る。
- 編集先が実行記録(
.skill-runs/write-commit-message/のstate.json・report.md)なら、編集を拒否する - ほかのファイルなら、スキル自身のファイル(SKILL.md、scripts、assets、references)でも、何もしない
- 編集先が、使っている間に受けた指摘の記録(
.skill-feedback/)なら、実行していないときも編集を拒否する
ねらい実行記録は run.py だけが書くので、検査の結果や報告を手で書き換えることを防ぐ。スキル自身は、使いながら直せるように止めない。指摘の記録も、記録のスクリプトと確認画面だけが書く。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、そのツールは呼ばれない。
- 絞り込み
- ツールの名前(例: Bash、Edit|Write)で、呼ぶ場面を絞り込める(matcher)。
登録の中身 Claude Code: 登録済み・Codex: 登録済み
Claude Code登録済みプロジェクトの設定(.claude/settings.json)に書いてある
- 絞り込み
Edit|Write|MultiEdit|NotebookEdit- 時間の上限
- 30 秒
python3 "$CLAUDE_PROJECT_DIR/.claude/skills/write-commit-message/scripts/hook.py" --platform claude pre-tool
Codex登録済みプロジェクトの設定(.codex/hooks.json)に書いてある
- 絞り込み
apply_patch- 時間の上限
- 30 秒
python3 "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.agents/skills/write-commit-message/scripts/hook.py" --platform codex pre-tool
PermissionRequest
ツールの呼び出しに許可の判断が要るときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。終了コードでは止められないが、判定(decision)を返して拒否はできる。
- 絞り込み
- ツールの名前で、呼ぶ場面を絞り込める(matcher)。
PermissionDenied
auto モードがツールの呼び出しを拒否したときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。拒否はもう起きている。retry: true を返すと、やり直してよいと伝えられる。
- 絞り込み
- ツールの名前で、呼ぶ場面を絞り込める(matcher)。
PostToolUse このスキルが使う
ツールの呼び出しが成功した後に呼ばれる。
write-commit-message の hooks がすること
write-commit-message を実行している間、Claude がファイルを編集した直後に、そのファイルを確かめる。
- そのファイルが SKILL.md の「5. 出力の契約」の出力でなければ、何もしない
- 出力なら、自動で直せる書式を直してから、契約の検査をする
- 指摘があれば、Claude に返して直させる(編集はもう終わっているので、取り消しはしない)
ねらい間違いを、最後にまとめてではなく、書いたその場で直させる。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。ツールはもう動いている。出力は Claude に返る。
- 絞り込み
- ツールの名前で、呼ぶ場面を絞り込める(matcher)。
登録の中身 Claude Code: 登録済み・Codex: 登録済み
Claude Code登録済みプロジェクトの設定(.claude/settings.json)に書いてある
- 絞り込み
Edit|Write|MultiEdit|NotebookEdit- 時間の上限
- 120 秒
python3 "$CLAUDE_PROJECT_DIR/.claude/skills/write-commit-message/scripts/hook.py" --platform claude post-tool
Codex登録済みプロジェクトの設定(.codex/hooks.json)に書いてある
- 絞り込み
apply_patch- 時間の上限
- 120 秒
python3 "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.agents/skills/write-commit-message/scripts/hook.py" --platform codex post-tool
PostToolUseFailure
ツールの呼び出しが失敗した後に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。ツールはもう失敗している。出力は Claude に返る。
- 絞り込み
- ツールの名前で、呼ぶ場面を絞り込める(matcher)。
PostToolBatch
並べて呼んだツールがすべて終わり、次にモデルを呼ぶ前に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、エージェントのループがそこで止まる。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
SubagentStart
サブエージェントを作ったときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。出力はユーザーにだけ見える。
- 絞り込み
- エージェントの種類で、呼ぶ場面を絞り込める(matcher)。
SubagentStop
サブエージェントが終わるときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、サブエージェントは終わらずに続ける。
- 絞り込み
- エージェントの種類で、呼ぶ場面を絞り込める(matcher)。
TaskCreated
TaskCreate でタスクを作ったときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、タスクは作られなかったことになる。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
TaskCompleted
タスクを完了にするときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、タスクは完了にならない。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
Elicitation
MCP サーバーがツールの実行中にユーザーの入力を求めたときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、求めは拒否され、入力の画面は出ない。
- 絞り込み
- MCP サーバーの名前で、呼ぶ場面を絞り込める(matcher)。
ElicitationResult
ユーザーが MCP サーバーの求めに答えた後、答えを送る前に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、答えは送られず、断ったことになる。
- 絞り込み
- MCP サーバーの名前で、呼ぶ場面を絞り込める(matcher)。
Stop このスキルが使う
Claude が応答を終えようとするときに呼ばれる。
write-commit-message の hooks がすること
write-commit-message を実行している間、Claude が応答を終えようとするたびに、作った出力をすべて検査する。
- 指摘が残っていれば、応答を終えさせず、指摘を Claude に返して直させる
- 指摘が無くても、そのままは終えさせず、
run.py finishを実行して報告するよう伝える - 3 回止めても終わらなければ、それ以上は止めず、この実行を失敗として記録する
- 実行を終えたときと質問を待つときは、そのときユーザーに見せた出力と、スキルのファイルを、指摘の記録に保存する
ねらい検査に通らない出力のまま「完了」と返されることを防ぐ。後で指摘を受けたときに、どの版の出力への指摘かを確かめられるようにする。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、Claude は応答を終えずに作業を続ける。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
登録の中身 Claude Code: 登録済み・Codex: 登録済み
Claude Code登録済みプロジェクトの設定(.claude/settings.json)に書いてある
- 絞り込み
- なし(いつも呼ぶ)
- 時間の上限
- 300 秒
python3 "$CLAUDE_PROJECT_DIR/.claude/skills/write-commit-message/scripts/hook.py" --platform claude stop
Codex登録済みプロジェクトの設定(.codex/hooks.json)に書いてある
- 絞り込み
- なし(いつも呼ぶ)
- 時間の上限
- 300 秒
python3 "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.agents/skills/write-commit-message/scripts/hook.py" --platform codex stop
StopFailure
API のエラーでターンが終わるときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。出力と終了コードは無視される。
- 絞り込み
- エラーの種類で、呼ぶ場面を絞り込める(matcher)。
TeammateIdle
エージェントチームのチームメイトが手すきになろうとするときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、チームメイトは作業を続ける。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
PreCompact
コンテキストを圧縮する前に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、圧縮されない。
- 絞り込み
- きっかけ(manual、auto)で、呼ぶ場面を絞り込める(matcher)。
PostCompact
コンテキストを圧縮した後に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。出力はユーザーにだけ見える。
- 絞り込み
- きっかけ(manual、auto)で、呼ぶ場面を絞り込める(matcher)。
SessionEnd
セッションを終えるときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。出力はユーザーにだけ見える。
- 絞り込み
- 終わり方(clear、logout など)で、呼ぶ場面を絞り込める(matcher)。
Notification
Claude Code が通知を送るときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。終了コードと出力は無視される。
- 絞り込み
- 通知の種類で、呼ぶ場面を絞り込める(matcher)。
MessageDisplay
アシスタントの文を表示している間に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。元の文がそのまま表示される。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
PreModelSwitch
モデルの切り替えを適用する前に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、モデルは切り替わらない。
- 絞り込み
- 切り替え先のモデルの名前で、呼ぶ場面を絞り込める(matcher)。
PostModelSwitch
モデルが変わった後に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。モデルはもう変わっている。
- 絞り込み
- 切り替え先のモデルの名前で、呼ぶ場面を絞り込める(matcher)。
InstructionsLoaded
CLAUDE.md や .claude/rules/*.md を読み込んだときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。終了コードは無視される。
- 絞り込み
- 読み込んだわけで、呼ぶ場面を絞り込める(matcher)。
ConfigChange
セッション中に設定ファイルが変わったときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、変更は反映されない(policy_settings を除く)。
- 絞り込み
- 設定の出どころで、呼ぶ場面を絞り込める(matcher)。
CwdChanged
作業ディレクトリが変わったとき(cd したときなど)に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。出力はユーザーにだけ見える。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
DirectoryAdded
セッションの途中でディレクトリを足したとき(/add-dir など)に呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。ディレクトリはもう足されている。
- 絞り込み
- 足し方で、呼ぶ場面を絞り込める(matcher)。
FileChanged
見張っているファイルがディスク上で変わったときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められない。出力はユーザーにだけ見える。
- 絞り込み
- 見張るファイルの名前で、呼ぶ場面を絞り込める(matcher)。
WorktreeCreate
worktree を作るときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、worktree は作られない。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
WorktreeRemove
WorktreeCreate の hooks が作った worktree を消すときに呼ばれる。
write-commit-message は、このイベントに hooks を置いていない。
このイベントの性質(公式ドキュメント)
- 止められるか
- 止められる。止めると、worktree は消されない。
- 絞り込み
- 絞り込めない。いつも呼ばれる。
収束テストの round-*/traces.json が無い。convergence.py diff が書く。それより前のラウンドには convergence.py trace で足す。
実施していない 理由: 公開作例の隔離実行で、実ユーザーとの価値の確認と独立AIの実行を行わないため
ルールと守らせ方
dev/spec.json のルール。題をクリックすると、ルールの全文と守らせる仕組みが開く。守らせ方は、ルールを何で守らせるか(色の付いたものは機械が守らせる)。決めた根拠は、ほかの答えもあり得るときに、その答えにしたわけ。点線の付いた語に重ねると説明が出る。
| ID | ルール | 守らせ方 | 決めた根拠 | 検証 | 使う手順 |
|---|---|---|---|---|---|
| IN入力・2 件 | |||||
IN-01 | ステージされた変更が無いときは書かずに中断する
守らせる仕組みscripts/collect_diff.py は、ステージされた変更が無いと終了コード4で終わる。中断の仕方は SKILL.md の手順3 機械にしない理由痕跡が残らない:中断したときは出力が無く、検査するものが無い | スクリプトが出す文書で伝える | AI の判断と覚える概念が少ない答え | — | 3 |
IN-02 | 読むのはステージ済みの差分だけにする材料は 守らせる仕組みscripts/collect_diff.py が 機械にしない理由意味の判断が要る:本文がステージ済みの差分に無い変更を書いているかは、差分と読み比べないと分からない | スクリプトが出す完了前に見直す | AI の判断と覚える概念が少ない答え | probe 1/1 | 3 |
| STEP手順・4 件 | |||||
STEP-01 | 材料集めと本文の単位はスクリプトで決める手順は 守らせる仕組みscripts/collect_diff.py が「ファイルの数」と「本文の単位」を出力する。順序は SKILL.md の手順3〜7 機械にしない理由痕跡が残らない:手順の順序とスクリプトの出力を使ったかは、出力に残らない(本文の形は STEP-02 が検査する) | スクリプトが出す文書で伝える | 機械で守らせられる答え | — | 3 |
STEP-02 | 本文の箇条書きはステージされたファイルの数で決める本文の箇条書きは次の表に従い、パスの昇順に並べる。 守らせる仕組みscripts/check_body.py が、箇条書きとステージされたファイルを突き合わせる(契約の command 検査) | 検査で止めるスクリプトが出す | 機械で守らせられる答え | probe 2/2 | 5 |
STEP-03 | git は読み取りだけに使う使う git コマンドは、 守らせる仕組みSKILL.md の手順3(読むのは collect_diff.py の出力だけ) 機械にしない理由費用が見合わない: | 文書で伝える | 道具・スクリプト・入力を増やさない答え | — | 3 |
STEP-04 | スクリプトが失敗したら中断する
守らせる仕組みSKILL.md の手順3 機械にしない理由痕跡が残らない:失敗は出力が無い状況で起き、検査するものが無い | 文書で伝える | AI の判断と覚える概念が少ない答え | — | 3 |
| OUT出力・6 件 | |||||
OUT-01 | 出力は実行記録の置き場に1ファイルだけ書くメッセージは 守らせる仕組み契約の outputs.message の path と count(1件) | 検査で止める | 機械で守らせられる答え | probe 1/1 | 5 |
OUT-02 | 1行目は「チケットID 要約」、2行目は空行にする1行目は 守らせる仕組み契約の checks(1行目の形、2行目が空、接頭辞の禁止) | 検査で止める | プロジェクトの既存の決まり | probe 2/2 | 4 |
OUT-03 | 日本語で書き、行末に句点を付けない要約と本文の変更の要約は日本語で、「<対象>を<動詞>する」の形で書き、行末に 守らせる仕組み契約の format(行末の | 自動で直す完了前に見直す | プロジェクトの既存の決まり | probe 2/2 | 4 |
OUT-04 | チケットIDは入力の値をそのまま使う1行目の先頭には、入力 守らせる仕組み契約の checks(1行目が | 検査で止める | 依頼の指定 | probe 1/1 | 4 |
OUT-05 | 1行目は50文字以内にする1行目は、チケットIDと空白を含めて50文字以内にする。 守らせる仕組み契約の checks(1行目の長さ) | 検査で止める | 出力を使う道具や形式の公式の決まり | probe 1/1 | 4 |
OUT-06 | CI を止める記法を書かないメッセージに、CI の実行を止める記法( 守らせる仕組み契約の checks(CI を止める記法の禁止) | 検査で止める | 機械で守らせられる答え | probe 1/1 | 4 |
| RPT報告・1 件 | |||||
RPT-01 | 最終の返答は finish の本文をそのまま使う最終の返答は、 守らせる仕組みscripts/run.py の finish と abort が本文を組み立て、.skill-runs/<name>/report.md にも保存する。check と finish が notes.md の形を検査する | 実行時に止める検査で止める完了前に見直す | 機械で守らせられる答え | probe 4/4 | 7 |
| CTL制御・3 件 | |||||
CTL-01 | 実行は run.py で始めて終える手順の最初に 守らせる仕組みscripts/run.py。finish は契約の検査に通らないと終了コード1で終わる | 実行時に止める検査で止める | 機械で守らせられる答え | probe 3/3 | 2 |
CTL-03 | 質問は start の前に済ませるユーザーに聞くことは 守らせる仕組みscripts/run.py の start は、聞くべき入力が無いと終了コード3で止まり、質問を出力する。wait は hooks の強制を止める | 実行時に止める文書で伝える | 機械で守らせられる答え | probe 1/1 | 1 |
CTL-04 | 検査の hooks は出力の検査と実行記録の保護だけに使い、入力とスキルの変更を止めない出力の検査の hooks は、このスキルの実行中(status: active)に、編集の後と応答を終える前に出力を検査することと、実行記録( 守らせる仕組みscripts/hook.py。install.py が Claude Code(.claude/settings.json)と Codex(.codex/hooks.json)に登録する | 実行時に止める | 機械で守らせられる答え | — | — |
出力の決まり
assets/contract.json に書いた出力。hooks と finish が、置き場・件数・検査を確かめる。
| 出力 | 置き場 | 件数 | 検査(ルールID) |
|---|---|---|---|
commit-messageコミットメッセージ | {run}/out/commit-message.txt | 1〜1 |
|
違反を見つけて止めるか
止めたわざとルールを破った違反の見本(dev/probes.json)を、ルールの検査が止めるかを probe.py が確かめた結果。ID に builtin が付くものは、スキルに組み込みの検査(start・finish などの止め方)。止められなかったものが先に並ぶ。
19 件を見る
| 結果 | ID | 内容 |
|---|---|---|
| 止めた | RPT-01-builtin | finish が報告の本文(## 結果 から ## 補足 まで)を出す |
| 止めた | OUT-01-a | check の終了コード 1、expect 一致 あり |
| 止めた | OUT-02-a | check の終了コード 1、expect 一致 あり |
| 止めた | OUT-02-b | check の終了コード 1、expect 一致 あり |
| 止めた | OUT-03-a | check の終了コード 0、expect 一致 あり、自動で直った はい |
| 止めた | OUT-04-a | check の終了コード 1、expect 一致 あり |
| 止めた | OUT-05-a | check の終了コード 1、expect 一致 あり |
| 止めた | OUT-06-a | check の終了コード 1、expect 一致 あり |
| 止めた | STEP-02-a | check の終了コード 1、expect 一致 あり |
| 止めた | STEP-02-b | check の終了コード 1、expect 一致 あり |
| 止めた | IN-02-r1 | レビューの見本が機械の検査を通る(終了コード 0。通らないなら review でなく validate にする) |
| 止めた | OUT-03-r1 | レビューの見本が機械の検査を通る(終了コード 0。通らないなら review でなく validate にする) |
| 止めた | CTL-01-builtin | 出力が無いと finish が落ちる(終了コード 1) |
| 止めた | CTL-01-builtin-edited | SKILL.md と契約を変えた後も start・check・finish が通る(終了コード start 0、check 0、finish 0) |
| 止めた | CTL-01-builtin-edited-probe | スキル自身を変えた後も、違反例 OUT-01-a は check で落ちる(終了コード 1) |
| 止めた | RPT-01-builtin-contract | 前の実行の後に契約を変えると、止めずに報告の「検証」に出す(終了コード 0) |
| 止めた | RPT-01-builtin-notes | notes.md が箇条書きでないと check が落ちる(終了コード 1) |
| 止めた | RPT-01-builtin-abort | abort が中断の本文を出し、次の start が前の中断を記録に残す |
| 止めた | CTL-03-builtin-ask | 聞くべき入力が無いと start が止まる(終了コード 3) |
hooks の動作
probe.py が、hooks が製品の設定に登録され、スキルの実行中は働き、実行していないときは何もしないかを、製品ごとに確かめた結果。
| 検査 | Claude Code | Codex |
|---|---|---|
registered | ✓ .claude/settings.json に4つの hook がある | ✓ .codex/hooks.json に4つの hook がある |
matcher | ✓ matcher が編集ツール Write に当たる | ✓ matcher が編集ツール apply_patch に当たる |
inactive | ✓ 実行していないセッションでは何もしない(CTL-04) | ✓ 実行していないセッションでは何もしない(CTL-04) |
post-tool | ✓ OUT-02-a の出力を編集した後に指摘を返す | ✓ OUT-02-a の出力を編集した後に指摘を返す |
prompt | ✓ ユーザーの発言は止めない(CTL-04) | ✓ ユーザーの発言は止めない(CTL-04) |
stop | ✓ finish の前に応答を終えようとすると差し戻す | ✓ finish の前に応答を終えようとすると差し戻す |
wait | ✓ wait 中は応答の終了を止めない(CTL-03) | ✓ wait 中は応答の終了を止めない(CTL-03) |
pre-tool-skill | ✓ スキル自身(SKILL.md)の編集の前は止めない(結果 何もしない。CTL-04) | ✓ スキル自身(SKILL.md)の編集の前は止めない(結果 何もしない。CTL-04) |
pre-tool | ✓ 実行記録(state.json)の編集の前に拒否する(結果 deny。CTL-04) | ✓ 実行記録(state.json)の編集の前に拒否する(結果 deny。CTL-04) |
feedback-prompt | ✓ 完了の後の発言を記録し、分類の方法を返す(発言は止めない) | ✓ 完了の後の発言を記録し、分類の方法を返す(発言は止めない) |
feedback-pre-tool | ✓ 利用中の指摘の記録(.skill-feedback/)の編集の前に拒否する(結果 deny) | ✓ 利用中の指摘の記録(.skill-feedback/)の編集の前に拒否する(結果 deny) |
最後の実行
結果: 完了 開始 2026-11-11T23:02:50+09:00・終了 2026-11-11T23:02:50+09:00
- start
- check0 件
- finish