specdojo 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +40 -0
- package/README.md +2 -2
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +1 -0
- package/dist/commands/orchestrator.js +10 -1
- package/dist/devcontainer/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +4 -3
- package/dist/exec/antigravity-session.js +154 -0
- package/dist/exec/parent-validation.js +7 -0
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-generation.js +6 -2
- package/dist/exec/register-resume.js +28 -0
- package/dist/exec/run/lifecycle-commands.js +85 -16
- package/dist/exec/run/register-command.js +6 -0
- package/dist/exec/run/schedule-mode.js +22 -2
- package/dist/exec/run/schedule-prepare.js +42 -1
- package/dist/exec/run/schedule-task.js +3 -0
- package/dist/exec/worktree-ops-commit.js +1 -13
- package/dist/exec/worktree-ops-lifecycle.js +40 -36
- package/dist/register/register.js +31 -23
- package/dist/shared/git.js +7 -0
- package/dist/shared/provider-scaffold.js +2 -0
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +14 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -8
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
- package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
- package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
- package/docs/ja/specdojo/references/command-reference.md +69 -37
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +5 -2
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
|
@@ -336,6 +336,8 @@ routing:
|
|
|
336
336
|
|
|
337
337
|
`lint-mermaid`(`npm run lint:mermaid`)は、Markdown の Mermaid の図の構文エラーを統合前に検出します。markdownlint と remark は図の中身を検査しないため、図の構文エラーは `docs:build` まで分かりません。利用するリポジトリに `lint:mermaid` script と、検査に使う Mermaid の依存が必要です。
|
|
338
338
|
|
|
339
|
+
`lint-d2`(`npm run lint:d2`)は D2 の構文を検査します。利用するリポジトリに `lint:d2` script(本リポジトリの実装は `node tools/lint-d2.mjs`)、docs-site の依存、および PATH 上に D2 CLI v0.9.0 が必要です。`pipeline.parent_validations` に `lint-d2` を追加して有効にします。CLI の未導入・版違いは未検査として失敗します。
|
|
340
|
+
|
|
339
341
|
`build`(`npm run build`)と `format-check`(`npm run format:check`)は、別リポジトリ構成でプロダクトリポジトリのビルド確認とコード整形確認を親 runner で実行するために使います。agent の sandbox 内で npm を実行できない環境でも、統合前にビルドと整形の検査を自動化できます(PJR-NS8Y)。
|
|
340
342
|
|
|
341
343
|
`specdojo.config.json` の project に `repos` を宣言した別リポジトリ構成では、`pipeline.parent_validations` の要素に `{ id, repo }` を書き、検証を実行するリポジトリを割り当てられます(PJR-V96B)。ID だけの要素はプロジェクトリポジトリで実行します。`repo` には、プロジェクトリポジトリを表す `project` か、`repos` で宣言したプロダクトリポジトリの名前を書きます。
|
|
@@ -398,7 +400,7 @@ providers:
|
|
|
398
400
|
expert: { effort: high }
|
|
399
401
|
|
|
400
402
|
antigravity:
|
|
401
|
-
command_template: '
|
|
403
|
+
command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
|
|
402
404
|
# model を持たない従来の 1 段の member だけが、次の model を使う
|
|
403
405
|
command_params:
|
|
404
406
|
by_proficiency:
|
|
@@ -557,7 +559,7 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
557
559
|
- 親検証は失敗時だけ出力を保存し、成功時は要約だけを記録します。失敗ログは `parent-validation-output` として `log_refs` から参照します。同じ run の resume や統合段の再検証では attempt 番号を増やして新しいログを追加し、以前の失敗ログを上書きしません。親検証の要約は 1,000 文字以内で先頭と末尾を残すため、末尾に出る失敗ケース名と件数を evidence から確認できます。
|
|
558
560
|
- evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
|
|
559
561
|
- executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`・省略可能な `completion_status`・`handoff`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
|
|
560
|
-
- `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`lint-mermaid`(`npm run lint:mermaid`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
|
|
562
|
+
- `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`lint-mermaid`(`npm run lint:mermaid`)、`lint-d2`(`npm run lint:d2`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
|
|
561
563
|
- executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、executor evidence の validations にも含めなくてよいものとします。親 runner の結果は `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。executor が同じ検査を `not_run` または `not_applicable` として含めた場合も、同じリポジトリで実行された親 runner の結果を正とします。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行せず、executor の重複報告で run を止めません。
|
|
562
564
|
- result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md` の変更がある場合だけ適用対象とします。rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate` は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
|
|
563
565
|
- `completion_status` は作業の完了状態を示す省略可能な欄で、値は `complete` / `incomplete` です。欄のない既存の報告は `complete` として扱います。値が指定されていてこの 2 値に合わない場合は、安全側に倒して `incomplete` として保存します。executor は計画の作業を終えられなかった場合、`incomplete` とし、理由を `final_message`、残作業を `handoff` に書きます。終了コード 0 や親検証の成功では未完了の申告を上書きしません。`exec run --register` は親検証・reporter を起動する前に停止し、項目を `waiting` にして、秘匿処理・文字数制限を適用した `final_message` の要旨を `block_reason` に記録します。worktree 実行では変更と evidence を残し、統合しません。pipeline の executor は `blocked`、evidence の `stage.status` と `exit_code` は実際のプロセス結果のままとします。`--resume --resume-from executor`(または `--resume`)で再開でき、前回の理由と `handoff`、途中の変更を executor に引き継ぎます。完了を申告し直し、必要な検証を通過してから review・統合へ進みます。
|
|
@@ -572,13 +574,13 @@ agent が exec 実行時に読み込む provider 固有の設定(agent 定義
|
|
|
572
574
|
|
|
573
575
|
配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules/`、`opencode.json` → リポジトリ直下の `opencode.json`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
|
|
574
576
|
|
|
575
|
-
| provider | 配布内容
|
|
576
|
-
| ----------- |
|
|
577
|
-
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json`
|
|
578
|
-
| codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule)
|
|
579
|
-
| opencode | `agents/*.md`(permission frontmatter 込みの agent 定義)、`opencode.json`(Ollama 接続・モデル設定)
|
|
580
|
-
| copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット
|
|
581
|
-
| antigravity | `
|
|
577
|
+
| provider | 配布内容 | 配置先 |
|
|
578
|
+
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
|
|
579
|
+
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
|
|
580
|
+
| codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule) | `.codex/agents/`、`.codex/rules/` |
|
|
581
|
+
| opencode | `agents/*.md`(permission frontmatter 込みの agent 定義)、`opencode.json`(Ollama 接続・モデル設定) | `.opencode/agents/`、`opencode.json` |
|
|
582
|
+
| copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
|
|
583
|
+
| antigravity | 役割別 `settings.edit.json` / `settings.review.json` / `settings.report.json` / `settings.orchestrator.json`、orchestrator と設定スニペット。旧 `settings.global.json` は互換用途だけに使用 | `.specdojo/antigravity/` |
|
|
582
584
|
|
|
583
585
|
導入手順と手動設定(`.codex/config.toml` や接続先 URL の調整、Modelfile によるローカル派生タグの作成など)は各 `templates/<provider>/README.md` を参照します。
|
|
584
586
|
|
|
@@ -739,13 +741,13 @@ providers:
|
|
|
739
741
|
--deny-tool 'shell(git push)' --deny-tool 'shell(git reset)'
|
|
740
742
|
```
|
|
741
743
|
|
|
742
|
-
**antigravity**(Antigravity CLI `agy
|
|
744
|
+
**antigravity**(Antigravity CLI `agy`)の pipeline の役割指示は plan の共通規約を正本とし、権限は `agent launch --role {mode}` が分離します。非対話実行は `-p` ですが、プロンプトを引数に取り stdin を読まないので、runner が stdin へ書く plan を `"$(cat)"` で引数に渡します(command は `shell: true` で実行されます)。
|
|
743
745
|
|
|
744
746
|
```yaml
|
|
745
747
|
providers:
|
|
746
748
|
antigravity:
|
|
747
749
|
command_template: >-
|
|
748
|
-
|
|
750
|
+
specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"
|
|
749
751
|
command_params:
|
|
750
752
|
by_proficiency:
|
|
751
753
|
normal: { model: gemini-3.8-flash-medium }
|
|
@@ -758,7 +760,7 @@ providers:
|
|
|
758
760
|
```
|
|
759
761
|
|
|
760
762
|
- `--sandbox` は書き込み先を `~/.gemini/antigravity-cli/scratch/` へ逃がすため、`--add-dir "$(pwd)"` で作業ディレクトリ(worktree)を明示して成果物へ書けるようにします。`--add-dir` なしでは成果物が更新されません。
|
|
761
|
-
-
|
|
763
|
+
- `config scaffold --provider antigravity` で役割別の設定を配置します。`agent launch` がプロファイルと宣言済み task worktree ごとの絶対パスの保護を一つの `--settings` JSON にまとめます。通常導入はユーザー設定を書き換えず、`--global` は不要です。review / report は全ファイルの書き込みと command / MCP を拒否し、親 runner が検証します。対話型は `orchestrator launch` が専用の設定を渡します。`--dangerously-skip-permissions` は使いません。既存の command template・個別 command・npm script の移行と、未確認のグローバル/project 設定マージの実機検証は [[sysd-antigravity-agent-settings|Antigravity CLI エージェント設定]] を参照してください。
|
|
762
764
|
- モデルは `agy models` で確認します。標準モデルは `by_proficiency`、Antigravity 経由の Claude / GPT は `by_nickname` で選びます。モデル ID は推論強度を含む(`gemini-3.8-flash-medium` など)ため `--effort` は併用しません。ID と `--effort` が食い違うと `invalid model selection` で起動に失敗します。
|
|
763
765
|
- 資格情報はコンテナ内では `~/.gemini/antigravity-cli/antigravity-oauth-token` に保存されます。devcontainer では `~/.gemini` を名前付きボリュームにして永続化します。
|
|
764
766
|
- `--output-format json --json-schema <file>` は `structured_output` を含む JSON エンベロープを返します。runner の reporter は stdout の本文から JSON を読むため、現時点では既定のテキスト出力を使います。
|
|
@@ -101,6 +101,8 @@ register 実行の場所は `.specdojo/exec-defaults.yaml` の `run.register_exe
|
|
|
101
101
|
|
|
102
102
|
schedule タスクの自動実行・手動実行の具体的な手順は [Schedule実行運用ガイド](schedule-operation-guide.md)、routine の定義と実行は [routine運用ガイド](routine-operation-guide.md) を参照してください。
|
|
103
103
|
|
|
104
|
+
自動実行を 1 つの track に限る場合は、`exec run --auto --track <track>` を使います。`--parallel`・`--loop`・`--dry-run` と併用でき、失敗後もほかの track のタスクを選びません。たとえば `specdojo exec run --project prj-0001 --auto --track data-flow-uc-rewrite --parallel 3` で、その track から最大 3 件を選びます。`--track` は単一指定で、`--auto` 以外との併用と存在しない track はエラーになります。省略時は全 track が対象です。
|
|
105
|
+
|
|
104
106
|
### 1.4. project単位の実行ロック
|
|
105
107
|
|
|
106
108
|
`exec run` は、実行対象 project の `execution_path/exec/.locks/exec-run.lock` を run 全体で保持します。同じ project に対する手動実行、routine、CI の `exec run` は同時に進まず、1つの run 内の `--parallel` worker だけが並列に動きます(register の worktree 実行へ `--join` で合流する場合を除きます。後述の「実行中の register worktree 実行へ後から合流する」を参照してください)。`exec resume` も同じロックへ参加するため、再開処理と新規実行も重なりません。`exec cycle` は再開・古い track の再生成・状態再計算・`--auto` loop の一連の step をこの単一ロック内で保持し、step 間に他の実行が割り込まないことを保証します。
|
|
@@ -247,19 +249,29 @@ agent起動時はhook由来の`GIT_DIR`などを継承せず、各trialのcwdか
|
|
|
247
249
|
|
|
248
250
|
`blocked` は人の判断や外部対応が必要な障害を表します。状況に応じて次のコマンドを使います。
|
|
249
251
|
|
|
250
|
-
| 状況
|
|
251
|
-
|
|
|
252
|
-
| 中断で `doing` のまま
|
|
253
|
-
| pipeline の reporter で `blocked`
|
|
254
|
-
|
|
|
255
|
-
|
|
|
256
|
-
|
|
|
257
|
-
|
|
|
252
|
+
| 状況 | コマンド | 結果 |
|
|
253
|
+
| -------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------ |
|
|
254
|
+
| 中断で `doing` のまま | `exec resume` | 既存 worktree 上で継続 |
|
|
255
|
+
| pipeline の reporter で `blocked` | `exec resume --task <id>` | executor evidence から再開 |
|
|
256
|
+
| reporter で `blocked`、または中断で `doing` の pipeline を executor からやり直す | `exec resume --task <id> --resume-from executor` | 既存 worktree と変更を引き継ぎ、executor → reporter → 統合を再実行 |
|
|
257
|
+
| pipeline の統合段で `blocked` | `exec resume --task <id>` | agent を起動せず統合だけ再開 |
|
|
258
|
+
| 障害を解消し同じ試行を続ける | `exec unblock` | `blocked -> doing` |
|
|
259
|
+
| 試行を破棄して最初からやり直す | `exec release` | `blocked -> todo` |
|
|
260
|
+
| 着手前のタスクを恒久的に中止する | `exec cancel` | `todo -> cancelled` |
|
|
258
261
|
|
|
259
262
|
`release` は `doing` / `blocked` の試行を破棄して `todo` に戻します。`cancel` は `todo` のタスクを終端状態にする操作です。
|
|
260
263
|
|
|
261
264
|
executor / reporter pipeline では、run ごとの `exec/evidence/<task>/<run>/pipeline-state.json` に各段(executor / reporter と、runner が担う統合段 `integrate`)の状態、agent、試行回数、evidence / result 参照を保存します。executor 中断の block event は `pipeline_stage=executor`、reporter 失敗は `pipeline_stage=reporter`、統合失敗は `pipeline_stage=integrate` を持ち、いずれも `pipeline_state_ref` から同じ run を再開します。`exec resume --task <task-id>` は state に応じて未完了の段から再開し、完了済みの agent 段を重複実行しません。
|
|
262
265
|
|
|
266
|
+
成果物の不足を executor に直させる場合は `--resume-from executor` を付けます。対象は executor が `succeeded` で reporter が未完了の pipeline に限ります。既存 run の executor 試行回数を増やし、`blocked` からの再開は `unblock` イベントを記録します。統合段、executor 未成功、pipeline 以外、`executor` 以外の値は理由を表示して停止します。この指定には `--task` が必要で、`--due` とは併用できません。
|
|
267
|
+
|
|
268
|
+
停止後に plan の指示を補う場合は、次の手順で再開します。
|
|
269
|
+
|
|
270
|
+
1. `specdojo exec worktree status --project <project-id> --task <task-id>` で残っている worktree を確認する。
|
|
271
|
+
2. その worktree の `<execution_path>/exec/plans/<task-id>-plan.md` を編集し、追加の指示と、変更の理由・再開までの経緯を result の申し送りへ残す指示を書く。
|
|
272
|
+
3. `specdojo exec resume --project <project-id> --task <task-id> --resume-from executor` を実行する。root で plan を生成し直さず、worktree にある編集済み plan を executor と reporter へ渡す。既存の成果物と未コミット変更も引き継ぐ。
|
|
273
|
+
4. 再開後の result で経緯と検証結果を確認する。pipeline の executor は result を直接編集せず、報告の `handoff` に経緯を記載し、reporter と runner が result へ反映する。
|
|
274
|
+
|
|
263
275
|
stage agent を明示する場合は次のように指定します。片方を省略すると、その stage は要件と優先度から自動選択されます。
|
|
264
276
|
|
|
265
277
|
```bash
|
|
@@ -58,14 +58,16 @@ CLI を直接操作する場合の代表フローは [遂行の技活用ガイ
|
|
|
58
58
|
| `orch:qwen:work` | OpenCode / Qwen 3.8 | `../worktrees/qwen-work`(無ければ自動作成) |
|
|
59
59
|
| `orch:gemma` | OpenCode / Gemma 4 | なし |
|
|
60
60
|
| `orch:gemma:work` | OpenCode / Gemma 4 | `../worktrees/gemma-work`(無ければ自動作成) |
|
|
61
|
+
| `orch:argon` | Antigravity / `gemini-4-argon-medium` | なし |
|
|
62
|
+
| `orch:argon:work` | Antigravity / `gemini-4-argon-medium` | `../worktrees/argon-work`(無ければ自動作成) |
|
|
61
63
|
| `orch:flash` | Antigravity / `gemini-3.8-flash-high` | なし |
|
|
62
64
|
| `orch:flash:work` | Antigravity / `gemini-3.8-flash-high` | `../worktrees/agy-work`(無ければ自動作成) |
|
|
63
65
|
|
|
64
66
|
Antigravity CLI(`agy`)はファイル定義の agent を持たないため、Codex と同じく SSOT `.agents/specdojo-orchestrator.agent.md` の本文を `-i`(初期プロンプトを与えて対話を続ける)で渡します。ラッパーは不要で、`.agents/rules/*.md` の薄いラッパー経由で `.github/instructions/` の規則も読み込まれます。
|
|
65
67
|
|
|
66
|
-
Antigravity で使えるモデル ID は `agy models`
|
|
68
|
+
Antigravity で使えるモデル ID は `agy models` で確認してください。配布スクリプトは `gemini-4-argon-medium` と `gemini-3.8-flash-high` を指定します。
|
|
67
69
|
|
|
68
|
-
`specdojo init` と `config scaffold` が利用者の `package.json` へ追加するスクリプトは、Claude Code が `orch:opus`・`orch:sonnet`、Codex が `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、Antigravity が `orch:flash
|
|
70
|
+
`specdojo init` と `config scaffold` が利用者の `package.json` へ追加するスクリプトは、Claude Code が `orch:opus`・`orch:sonnet`、Codex が `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、Antigravity が `orch:argon`(`gemini-4-argon-medium`)・`orch:flash`(`gemini-3.8-flash-high`)、OpenCode が `orch:opencode` です。Codex と Antigravity のスクリプトは、名前に対応するモデルを起動コマンドで明示します。
|
|
69
71
|
|
|
70
72
|
0.4.0 以前に作った `orch:codex`・`orch:agy` は自動では削除・上書きされません。`config scaffold --provider codex` または `config scaffold --provider antigravity` を再実行して新しいスクリプトを追加し、新しい名前で起動できることを確認してから、旧スクリプトを `package.json` から削除してください。
|
|
71
73
|
|