forge-run
forge-goals で承認した charter に沿って、開発用のオーケストレーションスキルを claude -p で評価課題に使わせ、採点役が判定し、足りない指標の原因を分析役が調べて改善の候補を作り、人の採否を経てスキルを更新し、最後に報告を書く。「オーケストレーションスキルを評価して」「スキルの改善を回して」と言われたときに使う。
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- forge-run
- description
- forge-goals で承認した charter に沿って、開発用のオーケストレーションスキルを claude -p で評価課題に使わせ、採点役が判定し、足りない指標の原因を分析役が調べて改善の候補を作り、人の採否を経てスキルを更新し、最後に報告を書く。「オーケストレーションスキルを評価して」「スキルの改善を回して」と言われたときに使う。
- allowed-tools
- Bash(python3 .forge/forge.py *)
- argument-hint
- <target-id>
- disable-model-invocation
- true
03 SKILL.md 正文
forge-run
このスキルは、承認済みの charter(ゴール・指標・評価課題)に沿って、対象のオーケストレーションスキルを良くする作業を進める。対象は、スキルとそのサブエージェントの組(バンドル)である。作業は次の順に流れる。
- 最初の評価:評価用のリポジトリのコピーごとに、補助 CLI が
claude -pを起動して、対象のスキルを評価課題で使わせる(この起動を実行役と呼ぶ)。実行の記録から、サブエージェントの起動・編集・検査の結果を集め、採点役が判定し、指標を計算する - 改善のラウンド:must の指標が足りなければ、分析役が原因を調べて候補のバンドルを直す。候補を同じ課題で評価し、今のバンドルと比べる。採るかは人が決める
- 最後の評価:ホールドアウトの課題も含めて評価し、評価課題に合わせすぎていないかを確かめる
- 報告:指標の推移、採った変更、人に判断してほしいことをまとめる
どの段階にいて次に何をするかは、補助 CLI の status が決める。あなたは status の指示に従って、コマンドを実行するか、サブエージェントを起動するか、人に聞く。段階を自分で判断して飛ばさない。
役割
| 役 | 担い手 | 受け持つこと |
|---|---|---|
| 実行役 | 補助 CLI の execute が起動する claude -p |
評価用のコピーの中で、対象のスキルに従って評価課題を1つこなす |
| 採点役 | サブエージェント forge-grader |
1つの実行の結果を、判定項目ごとに判定して grade.json を書く |
| 分析役 | サブエージェント forge-analyst |
足りない指標の原因を調べ、候補のバンドルを直して proposal.json を書く |
メインのセッション(あなた)は、補助 CLI の実行、サブエージェントの起動、人との対話だけを受け持つ。
手順
- 引数で
target-idを受け取る。無ければpython3 .forge/forge.py targetsで作業領域の対象の一覧を出し、AskUserQuestion で選んでもらう python3 .forge/forge.py status --target <id>を実行する。段階:に(forge-goals)が付いていれば/forge-goalsで charter を決めるよう、(forge-build)が付いていれば/forge-build <id>でスキルを作るよう伝えて終える- 最初の評価がまだなら(
段階: 最初の評価の準備)、下の「人に確かめること」の評価の開始に従う statusの出力の次:の行に従う。終えたらstatusに戻る。下の「繰り返すこと」の表のとおりに進め、段階: 完了が出るまで繰り返す段階: 完了が出たら、.forge/targets/<id>/report.mdを読み、下の「報告」の形で人に伝える
繰り返すこと
| 出力の行 | すること |
|---|---|
次: python3 .forge/forge.py execute ... |
Bash で run_in_background を true にして実行し、完了の知らせを待つ(実行役の全部が終わるまで、課題の数と charter の executor.timeout_sec に応じて長くかかる)。終わったら出力を読み、その後: のコマンドを実行する。途中で止まっても、同じコマンドで続きから回せる |
次: python3 .forge/forge.py ...(execute 以外) |
そのまま Bash で実行する |
次: 下の job をすべて Agent ツールで… |
下の「サブエージェントの起動」に従い、続く job の行をすべて起動する。全員が終わったら その後: のコマンドを実行する |
次: <proposal.md> の所見を人に見せる |
所見の表を見せ、その後: のコマンドを実行する |
次: <compare.md> と <proposal.md> を人に見せ、採用するかを聞く |
下の「人に確かめること」の採否に従う |
段階: 対象スキルがバンドルの決まりを満たしていない |
続く問題の一覧を人に見せ、人がバンドルの決まりに沿って直すか、/forge-build で別の名前のスキルを作り直すかを決めてもらう。あなたはスキルを直さない |
出力に WARN の行がある |
人に見せる |
サブエージェントの起動
job の行は job <エージェント名> <ラベル> <プロンプトのパス> の形をしている。1行につき1回、Agent ツールを次の値で呼ぶ。
| Agent ツールの引数 | 値 |
|---|---|
subagent_type |
<エージェント名>(forge-grader か forge-analyst) |
description |
<ラベル> |
prompt |
次のファイルを読み、その指示に従ってください: <プロンプトのパス> |
- 同じ出力に並んだ
jobの行は、Agent ツールの呼び出しを1つのメッセージにまとめて起動する(並行に動かすため) run_in_backgroundは false にし、全員の完了を待ってから次へ進む- 返答は
完了: <パス>の1行である。中身の確認は補助 CLI が行うので、返答を読んで判断しない - 採点役・分析役が書くべきファイルを、あなたが代わりに書かない。出力が無ければ、同じ
jobをもう一度起動する
エラーのとき
補助 CLI が エラー: を出したら、内容で次のように扱う。
| エラーの内容 | すること |
|---|---|
| 「上の実行の採点役を、同じプロンプトでもう一度起動してください」 | 挙がった実行の採点役を同じ job で起動し直してから、同じコマンドをやり直す |
| 「分析役に、この問題を直すよう添えて…」 | 分析役を、prompt の末尾に 前回の問題: <問題の一覧> を足して起動し直し、propose をやり直す。2回続けて落ちたら、人に見せて判断を仰ぐ |
| 「charter が … 変わりました」「未承認」 | /forge-goals で charter を見直すよう伝えて止まる |
| 「prepare からやり直してください」 | エラーの全文を人に見せ、評価の作業領域 .forge/work/<id>/ の該当する置き場を消してよいかを AskUserQuestion で確かめる。消してよければ消してから status に戻る |
| 「準備済み」「決定済み」 | status に戻る |
人に確かめること
- 評価の開始:
.forge/targets/<id>/charter.mdの「実行役の起動(上限)」と「費用の上限の見積もり」を見せ、AskUserQuestion で「始める(推奨)/止める」を聞く。既定: 人が答えられないときは始めない - 各ラウンドの採否:
compare.mdの指標の表と推奨の理由、proposal.mdの変更の表とバンドルの差分、S6(評価の側の問題)の所見があればそれも見せる。そのうえで AskUserQuestion で「採用する/採用しない/ここで止める」を聞く。推奨が「採用」なら「採用する」を、「不採用」なら「採用しない」を先頭に置いて名前の末尾に(推奨)を付ける。採用なら採用なら:の、採用しないなら不採用なら:のコマンドを実行し、ここで止めるなら何も実行せずに終える(次に/forge-runを呼べば同じ場面から続く)。既定: 人が答えられないときは、何も実行せずに止まる - S6 の所見があり、人が charter を直すと決めたとき:採否を記録してから、
/forge-goalsで charter を見直すよう伝えて止まる。既定: 人が答えられないときは charter を変えずに続ける WARNの行(評価の間に元のリポジトリが変わった、実行役が打ち切られた)と、上の表に無いエラー:内容を人に見せ、判断を仰ぐ。既定: 人が答えられないときは止まる
報告
最後の返答に、次の項目をこの順で書く。
してはいけないこと
- 対象のスキルとサブエージェントを、自分の判断で書き換えること。バンドルを変えるのは
decide --adoptだけである - 採点・提案・比較のファイルを手で書き換えること
- charter を書き換えること。charter を変えるときは
/forge-goalsに戻る - 人の答えを待たずに
decideを実行すること - 実行役(
claude -p)を、補助 CLI のexecuteを通さずに起動すること。権限と予算の条件がそろわなくなる
04 同仓库更多 Skills
setup
このDocusaurusパターンの初期設定・設定変更を、OSSと独自設定の台帳に沿った質問とCLIで行う。site.settings.jsonとsetup/settings.catalog.jsonがある配布先で使用する。
sample
日付の表記を ISO 8601(YYYY-MM-DD)にそろえる見本のスキル。テストで使う。
skill-tune
既存の Claude Code スキルを評価データで改善する。正解データがあれば学習用・検証用・テスト用に分け、無ければ人と評価項目を決め、独立した学習と検証のラウンドを回し、最後にテスト用で測って報告する。
review
skill-tune-kit の変更をレビューする手順。差分、プルリクエスト、ブランチ、特定のファイルのレビューを頼まれたとき、また「この実装で問題ないか確認して」「ルールに沿っているか見て」と頼まれたときは必ず使う。機械の検査を先に回し、機械で拾えないルールをルールIDごとに確かめ、固定の形式で指摘と判定を返す。
impl
skill-tune-kit で実装・変更・追加・修正を行う手順。「検査の種類を足して」「サブコマンドを追加して」「プロンプトの文言を直して」「plan.json に項目を足して」「status の表示を変えて」「採否の規則を変えて」「〜の不具合を直して」「skill-tune の手順を直して」などの依頼で使う。この基盤のコードや配布物を書く・変える依頼では、依頼の大小にかかわらず必ず使う。依頼をパターンに振り分け、決められた順序で作り、`make check` と完了前チェックリストで確かめてから報告する。
sample
議事録の日付をそろえる。議事録の整形を頼まれたときに使う。