goal

ユーザーが与えた目標を、複数サイクル回して達成する。

disable-model-invocation: true を付けている。このスキルは commit まで自律的に行うので、ユーザーが /goal と打ったときだけ動かす。Codex 向けには agents/openai.yaml の allow_implicit_invocation: false が同じ役割をする。

原則

完了の単位はユーザーの目標。コミットは通過点。

1 ステップ終わった、1 コミットできた、テストが通った — どれも止まる理由にならない。各通過点で「目標に対してまだ足りないものは何か」を問い直し、次の小さな目標を選ぶ。止まるのは目標を達成して検証したときか、ユーザー入力なしに解けないブロッカーに当たったときだけ。

引数

• <goal>: 達成したい目標。曖昧なら最も妥当な解釈を採り、解釈を作業ノートに書いて進める。解釈次第で有害・不可逆な作業になるときだけ聞く

作業ノート

解釈・完了条件・次の数手・試した実験を書き留める場所。応答の中に短く書くのが既定。セッションをまたぐ見込みのある長い目標では、リポジトリ管理外のファイル(${TMPDIR} など)に置き、最終報告にパスを書く。リポジトリ内には作らない — 差分に混ざり、commit されうる。

Step 0: 現状を把握する

編集する前に、目標の達成に要る範囲で把握する:

• プロジェクトの目的と構成、既存の規約(AGENTS.md / CLAUDE.md / rules)
• テスト・lint・ビルド・実行コマンド(ドキュメントと設定ファイルから拾い、実行して確かめる)
• 直近のコミットメッセージの流儀(git log --oneline -20)
• 作業ツリーの状態(git status --short)。既に差分があるなら、目標と無関係なものは触らない

Step 1: 目標を完了条件に翻訳する

目標を、観測できる完了条件に言い換えて作業ノートに書く:

• 望む結果(何ができるようになるか)
• 完了の証拠(テストが通る / 挙動を実演できる / 再現したバグが直る / 結果が記録される / 無関係な差分が残っていない)
• 検証に使うコマンド
• 既知のリスク・不明点

計画は次の数手だけ。先まで書いた計画は最初の検証で古くなる。

Step 2: ループを回す

目標を達成するまで繰り返す。

2-1. 次の小目標を選ぶ

目標に直結し、1 つの論理的なコミットに収まる大きさのものを 1 つ選ぶ。無関係な変更を同時に始めない。

2-2. 変更する

既存の設計・命名・構成に合わせる。最小で一貫した変更を、広い書き換えより優先する。

2-3. 検証する

もっとも関係の深い検査を先に走らせる(対象のテスト、型検査、lint、再現コマンド)。広い検査(全テスト、ビルド)は節目で。失敗は情報として扱う — 原因を診断し、直し、再度検証する。失敗を隠さない。

根拠にするのは最後の変更より後に走らせた結果だけ。直前の編集のあとに走らせていない検査は、通ったことにせず走らせ直す。

2-4. 差分を見直す

commit の前に差分そのものを読む:

• 小目標の範囲に収まっているか。無関係な編集は戻すか分ける
• 一時ファイル・デバッグ出力・secrets が混ざっていないか
• 挙動が小目標どおりか

2-5. commit する

差分が意味のある 1 単位になっていれば commit する。目標全体の完了を待たない。壊れた状態を commit しない(チェックポイントとして明示的に有用な場合を除き、その場合はメッセージにそう書く)。

コミットメッセージ:

• 日本語で、端的に。prefix は git log の慣習に合わせる(Conventional Commits を使っていなければ付けない)
• AI ツールの署名を入れない(Co-Authored-By: trailer、🤖 Generated with ...、noreply@anthropic.com)
• commit スキルが入っていればその規約に従う

2-6. 再計画して続ける

目標に照らして残りを見直し、2-1 に戻る。計画の項目が尽きたが目標が未達なら、新しい短い計画を立てて続ける。

止まらない理由・止まる条件

次の理由だけでは止まらない:

• 1 ステップが終わった / 1 コミットを作った / 一部のテストが通った
• 中間の節目に達した / 計画の項目が尽きた
• 残りが整理・検証・ドキュメント・計画だけになった

止まるのは次のどれか:

• 目標を達成し、完了条件を検証した
• ユーザー入力なしに解けないブロッカーがある
• 認証情報・課金・破壊的操作・外部への送信・権限が要る
• リポジトリが安全に進められない状態にある
• ユーザーが作業量の上限を指示していた

止まるときの片付け

ブロッカーで止まるときも、達成して止まるときも、作業ツリーを再開しやすい状態にしてから止まる:

• 塊になっている変更は commit する。途中の変更は「チェックポイント」とメッセージに明記して commit する
• stash は使わない(ユーザーの無関係な変更まで巻き込む)
• 実験の残骸は消す。元からあった無関係な差分には触らない
• 自分が作った未コミットの変更を残したまま最終回答しない(Stop hook が 1 回だけ差し戻す)

実験するとき

• 実験的な変更は分離する。試したことをノートに残す
• 有用な結果だけを残し、死んだ実験は commit 前に消す(意図的に記録する場合を除く)
• 実験の基盤と本番の挙動変更は、可能なら別コミットにする

最終回答の前に

• 目標は本当に達成されたか。完了条件を 1 つずつ確認したか
• 既知の検証をすべて走らせたか。飛ばしたなら理由があるか
• 残っている明らかな実装・検証・整理・ドキュメントの作業は無いか
• ユーザー入力なしに進められる次の行動がまだあるか — あるなら最終回答せず、ループに戻る

強制されること(hook)

指示だけでは守られない 3 つを hook にしてある。いずれも Claude Code でのみ効く。Codex では上の規約を指示として守る。

完了時に返すもの

• 目標を達成したか(達成 / ブロッカーで停止)。解釈を置いた場合はその内容
• 作成したコミットの一覧(git log --oneline の該当分)
• 実行した検証コマンドと結果。飛ばしたものとその理由
• 残っているブロッカー・後続作業