specdojo 0.5.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/.github/agents/specdojo-orchestrator.md +2 -0
- package/CHANGELOG.md +100 -0
- package/README.md +2 -2
- package/dist/catalog/generate.js +144 -13
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +2 -0
- package/dist/commands/orchestrator.js +10 -1
- package/dist/deliverable/deliverable.js +77 -4
- 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/core.js +1 -0
- package/dist/exec/parent-validation.js +14 -0
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-core.js +46 -1
- package/dist/exec/plans-generation.js +45 -5
- package/dist/exec/plans-planning.js +1 -1
- package/dist/exec/plans-storage.js +1 -0
- package/dist/exec/product-branch-records.js +105 -0
- package/dist/exec/product-branches.js +52 -0
- package/dist/exec/register-product-message.js +50 -0
- package/dist/exec/register-resume.js +28 -0
- package/dist/exec/register.js +6 -0
- package/dist/exec/repo-integration-sync.js +4 -2
- package/dist/exec/repo-integration.js +41 -4
- package/dist/exec/repo-trace.js +2 -0
- package/dist/exec/results.js +9 -5
- package/dist/exec/run/lifecycle-commands.js +85 -16
- package/dist/exec/run/register-command.js +22 -0
- package/dist/exec/run/register-resume.js +11 -1
- package/dist/exec/run/register-worktree.js +29 -8
- package/dist/exec/run/schedule-mode.js +22 -2
- package/dist/exec/run/schedule-prepare.js +49 -4
- package/dist/exec/run/schedule-task.js +3 -0
- package/dist/exec/strategy.js +2 -1
- package/dist/exec/task-repos.js +78 -16
- package/dist/exec/worktree-command.js +2 -2
- package/dist/exec/worktree-ops-commit.js +1 -13
- package/dist/exec/worktree-ops-lifecycle.js +40 -36
- package/dist/exec/worktree.js +3 -3
- package/dist/register/core.js +5 -0
- package/dist/register/create-commands.js +54 -2
- package/dist/register/deliverable-target.js +24 -17
- package/dist/register/event-merge.js +4 -0
- package/dist/register/events.js +6 -0
- package/dist/register/external-project.js +2 -0
- package/dist/register/input.js +168 -0
- package/dist/register/item.js +61 -0
- package/dist/register/register.js +33 -25
- package/dist/register/renumber.js +4 -0
- package/dist/register/update.js +6 -0
- package/dist/schedule/approach.js +9 -0
- package/dist/schedule/strategy-profiles.js +22 -2
- package/dist/shared/agent-types.js +4 -1
- package/dist/shared/branch-template.js +26 -0
- package/dist/shared/commit-message-template.js +38 -0
- package/dist/shared/commit-types.js +15 -0
- package/dist/shared/git.js +7 -0
- package/dist/shared/provider-scaffold.js +2 -0
- package/dist/shared/specdojo-config.js +35 -4
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
- package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +16 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +116 -10
- 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 +16 -1
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
- package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
- package/docs/ja/specdojo/guides/schedule-design-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/recipes/exec-human-finalize-recipe.md +1 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +20 -12
- package/docs/ja/specdojo/references/command-reference.md +111 -46
- package/docs/ja/specdojo/references/specdojo-config-reference.md +69 -8
- 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/rulebooks/dct-rulebook.md +8 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +3 -1
- 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/samples/dct-sample.yaml +5 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +16 -0
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -1
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
- package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
- package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
- package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +41 -2
- package/package.json +6 -2
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +2 -0
- 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/claude/agents/specdojo-orchestrator.md +2 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
- package/templates/codex/orchestrator.md +2 -0
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -90
- 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
- package/templates/opencode/agents/specdojo-orchestrator.md +2 -0
|
@@ -10,6 +10,9 @@ _PHASE_DESCRIPTION_
|
|
|
10
10
|
|
|
11
11
|
- `name`: _DELIVERABLE_NAME_
|
|
12
12
|
- `depends_on`: _DELIVERABLE_DEPENDS_ON_
|
|
13
|
+
- `based_on`(対象成果物の frontmatter): _DELIVERABLE_BASED_ON_
|
|
14
|
+
- 個票の `入力`: _REGISTER_INPUT_
|
|
15
|
+
- カタログの `brief`: _DELIVERABLE_BRIEF_
|
|
13
16
|
- `overview`: _DELIVERABLE_OVERVIEW_
|
|
14
17
|
- `path`: `_DELIVERABLE_PATH_`
|
|
15
18
|
- `rulebook`: `_RULEBOOK_REF_`(`_MISSING_` は `undecided`、`not-needed`、または未整備)
|
|
@@ -43,20 +46,20 @@ _DONE_CRITERIA_ROWS_
|
|
|
43
46
|
|
|
44
47
|
## 5. 進め方
|
|
45
48
|
|
|
46
|
-
fully-guided
|
|
49
|
+
fully-guided のタスクは、宣言された文書だけを参照し、rulebook / recipe / sample に沿って既存成果物を磨き込むことを求めた。下書きや調査による新しい値の選定は draft の役割である。磨き込みでは template を読み込まない。rulebook の必須要素・禁止事項、recipe の問い、sample の形式との整合は grade が評価済みである。review はこれらを照合し直さず、評価結果の finding として扱う。
|
|
47
50
|
|
|
48
51
|
参照ファイル(rulebook frontmatter から解決。`_MISSING_` の項目は未宣言・未整備):
|
|
49
52
|
|
|
50
53
|
- rulebook: `_RULEBOOK_REF_`
|
|
51
54
|
- recipe: `_RECIPE_REF_`
|
|
52
55
|
- sample: `_SAMPLE_REF_`
|
|
53
|
-
-
|
|
56
|
+
- 併せて適用する rulebook(記法など): _RULEBOOK_INCLUDES_
|
|
54
57
|
|
|
55
|
-
1.
|
|
58
|
+
1. フェーズ説明と完了条件が求めた磨き込みが、対象成果物に行われたかを確認する。
|
|
56
59
|
2. 実践の型の欠落(`_MISSING_`)や内容の薄さがある場合は、実行記録にその扱いが残っているかを確認する。実践の型そのものの整備が必要な場合は、改善指示に残す。
|
|
57
60
|
3. finding が残っている場合は、このタスクの完了を妨げるかを判断する。rulebook の必須要素の欠落や禁止事項への抵触など、完了条件に直結する finding は完了を妨げる。
|
|
58
61
|
|
|
59
|
-
|
|
62
|
+
確認に用いてよい文書は、宣言された文書だけに限る。具体的には、評価結果、対象成果物、本セクションの参照ファイル、`depends_on` 成果物、対象成果物の frontmatter の `based_on`、プロジェクトコンテキスト(`project_context`)、個票の `入力`、カタログの `brief`、実行記録である。`入力` と `brief` は値が無いときは載せない。これらに宣言されていない他のプロジェクト文書や外部の情報を独自に探索・参照しない。
|
|
60
63
|
|
|
61
64
|
本タスクの実行に必要な fully-guided の確認方針は、このセクションで完結する。approach 全体の定義(他 approach との対比や edit への適用)を確認したい場合のみ、参考として [[specdojo:ryu-guide]] を参照する。
|
|
62
65
|
|
|
@@ -346,6 +346,7 @@ Mermaid SVG の生成だけを行う場合は `npx specdojo-docs-site mermaid .`
|
|
|
346
346
|
/.vitepress/dist/
|
|
347
347
|
/.vitepress/cache/
|
|
348
348
|
/.vitepress/mermaid/
|
|
349
|
+
/.vitepress/d2/
|
|
349
350
|
/.vitepress/kata-staging/
|
|
350
351
|
```
|
|
351
352
|
|
|
@@ -390,3 +391,38 @@ block
|
|
|
390
391
|
- ローカル検索は登録簿一覧 `pjr-index` を入口にし、個票、状態別などの派生ビュー、管理ログ、実行記録を検索インデックスから除外します。個票本文を探す場合は `pjr-index` から対象個票へ移動します。
|
|
391
392
|
|
|
392
393
|
ステージングの参照元、Mermaid SVG だけを生成するコマンドなど、package 固有の設定は `packages/docs-site/README.md` を参照してください。
|
|
394
|
+
|
|
395
|
+
### 6.2. 図の道具を選ぶ
|
|
396
|
+
|
|
397
|
+
図の目的と複雑さで道具を選びます。agent もこの基準に従って作成・修正してください。
|
|
398
|
+
|
|
399
|
+
| 道具 | 選ぶ目安 | 正本 |
|
|
400
|
+
| ------- | -------------------------------------------------------------------------------- | ------------------------------------ |
|
|
401
|
+
| Mermaid | 単純な図、状態遷移図、シーケンス図など。ノードと辺がそれぞれおおむね 20 程度まで | Markdown の `mermaid` コードブロック |
|
|
402
|
+
| D2 | ノード・辺が多い構成図、入れ子が多い図、Mermaid で配置が読みづらくなる図 | Markdown の `d2` コードブロック |
|
|
403
|
+
| draw.io | さらに複雑で、人が配置を決めたい図や発表用の図 | 圧縮しない `.drawio` |
|
|
404
|
+
|
|
405
|
+
20 は切り替えの目安です。図を読む目的が分かれる場合は、道具の変更とともに図の分割も検討します。draw.io の自動書き出しは別途整備するため、現時点では表示用の SVG を手動で用意してください。
|
|
406
|
+
|
|
407
|
+
### 6.3. D2 図を書く・検査する
|
|
408
|
+
|
|
409
|
+
`d2` のコードブロックは `build` と `dev` で SVG に書き出します。D2 CLI v0.9.0 を PATH に配置してください。このリポジトリの Dev Container はコンテナの再ビルドで導入されます。Linux で手動導入する場合は、版と SHA-256 を固定した `sh .devcontainer/install-d2.sh "$HOME/.local/bin"` を使えます。
|
|
410
|
+
|
|
411
|
+
````markdown
|
|
412
|
+
```d2
|
|
413
|
+
direction: right
|
|
414
|
+
client: 利用者
|
|
415
|
+
system: システム {
|
|
416
|
+
api: API
|
|
417
|
+
db: データベース {shape: cylinder}
|
|
418
|
+
api -> db: 読み書き
|
|
419
|
+
}
|
|
420
|
+
client -> system.api: リクエスト
|
|
421
|
+
```
|
|
422
|
+
````
|
|
423
|
+
|
|
424
|
+
配置の既定は ELK です。図はコードブロック内で完結させ、外部ファイルの import は使いません。1 つのブロックにつきルートの図を 1 枚の SVG にします。layers・scenarios・steps の追加ページは書き出しません。生成 SVG は `.vitepress/d2/`、公開 URL はサイトの base に続く `/d2/<hash>.svg` です。SVG は生成物なので直接編集しません。
|
|
425
|
+
|
|
426
|
+
生成だけを行う場合は `npx specdojo-docs-site d2 .` を使います。本リポジトリの構文検査は `node tools/lint-d2.mjs`、対象を絞る場合は `node tools/lint-d2.mjs '<Markdown のパスまたは glob>'` です。開始 fence の行番号とエラーを報告し、不正な図は終了コード 1 になります。D2 を含む文書がある場合、CLI が未導入・版違いでも失敗します。ブラウザは不要です。
|
|
427
|
+
|
|
428
|
+
GitHub の Markdown 表示では D2 は図に変換されないため、文書サイトで確認します。npm の `lint:d2`・`check`、commit hook とこのリポジトリの親検証設定への登録、および CI の導入設定は、保護された設定の承認・反映後に有効になります。
|
|
@@ -334,6 +334,10 @@ routing:
|
|
|
334
334
|
|
|
335
335
|
`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)は、executor が残した ESLint・frontmatter・Markdown の lint エラーを agent の段階で検出します。指定しない場合、これらのエラーは統合後の `npm run check` まで持ち越されます(PJR-K1Z5)。
|
|
336
336
|
|
|
337
|
+
`lint-mermaid`(`npm run lint:mermaid`)は、Markdown の Mermaid の図の構文エラーを統合前に検出します。markdownlint と remark は図の中身を検査しないため、図の構文エラーは `docs:build` まで分かりません。利用するリポジトリに `lint:mermaid` script と、検査に使う Mermaid の依存が必要です。
|
|
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
|
+
|
|
337
341
|
`build`(`npm run build`)と `format-check`(`npm run format:check`)は、別リポジトリ構成でプロダクトリポジトリのビルド確認とコード整形確認を親 runner で実行するために使います。agent の sandbox 内で npm を実行できない環境でも、統合前にビルドと整形の検査を自動化できます(PJR-NS8Y)。
|
|
338
342
|
|
|
339
343
|
`specdojo.config.json` の project に `repos` を宣言した別リポジトリ構成では、`pipeline.parent_validations` の要素に `{ id, repo }` を書き、検証を実行するリポジトリを割り当てられます(PJR-V96B)。ID だけの要素はプロジェクトリポジトリで実行します。`repo` には、プロジェクトリポジトリを表す `project` か、`repos` で宣言したプロダクトリポジトリの名前を書きます。
|
|
@@ -396,7 +400,7 @@ providers:
|
|
|
396
400
|
expert: { effort: high }
|
|
397
401
|
|
|
398
402
|
antigravity:
|
|
399
|
-
command_template: '
|
|
403
|
+
command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
|
|
400
404
|
# model を持たない従来の 1 段の member だけが、次の model を使う
|
|
401
405
|
command_params:
|
|
402
406
|
by_proficiency:
|
|
@@ -555,7 +559,7 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
555
559
|
- 親検証は失敗時だけ出力を保存し、成功時は要約だけを記録します。失敗ログは `parent-validation-output` として `log_refs` から参照します。同じ run の resume や統合段の再検証では attempt 番号を増やして新しいログを追加し、以前の失敗ログを上書きしません。親検証の要約は 1,000 文字以内で先頭と末尾を残すため、末尾に出る失敗ケース名と件数を evidence から確認できます。
|
|
556
560
|
- evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
|
|
557
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` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
|
|
558
|
-
- `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`)、`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 の検証を実行します。
|
|
559
563
|
- executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、executor evidence の validations にも含めなくてよいものとします。親 runner の結果は `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。executor が同じ検査を `not_run` または `not_applicable` として含めた場合も、同じリポジトリで実行された親 runner の結果を正とします。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行せず、executor の重複報告で run を止めません。
|
|
560
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 します。
|
|
561
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・統合へ進みます。
|
|
@@ -570,13 +574,13 @@ agent が exec 実行時に読み込む provider 固有の設定(agent 定義
|
|
|
570
574
|
|
|
571
575
|
配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules/`、`opencode.json` → リポジトリ直下の `opencode.json`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
|
|
572
576
|
|
|
573
|
-
| provider | 配布内容
|
|
574
|
-
| ----------- |
|
|
575
|
-
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json`
|
|
576
|
-
| codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule)
|
|
577
|
-
| opencode | `agents/*.md`(permission frontmatter 込みの agent 定義)、`opencode.json`(Ollama 接続・モデル設定)
|
|
578
|
-
| copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット
|
|
579
|
-
| 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/` |
|
|
580
584
|
|
|
581
585
|
導入手順と手動設定(`.codex/config.toml` や接続先 URL の調整、Modelfile によるローカル派生タグの作成など)は各 `templates/<provider>/README.md` を参照します。
|
|
582
586
|
|
|
@@ -737,13 +741,13 @@ providers:
|
|
|
737
741
|
--deny-tool 'shell(git push)' --deny-tool 'shell(git reset)'
|
|
738
742
|
```
|
|
739
743
|
|
|
740
|
-
**antigravity**(Antigravity CLI `agy
|
|
744
|
+
**antigravity**(Antigravity CLI `agy`)の pipeline の役割指示は plan の共通規約を正本とし、権限は `agent launch --role {mode}` が分離します。非対話実行は `-p` ですが、プロンプトを引数に取り stdin を読まないので、runner が stdin へ書く plan を `"$(cat)"` で引数に渡します(command は `shell: true` で実行されます)。
|
|
741
745
|
|
|
742
746
|
```yaml
|
|
743
747
|
providers:
|
|
744
748
|
antigravity:
|
|
745
749
|
command_template: >-
|
|
746
|
-
|
|
750
|
+
specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"
|
|
747
751
|
command_params:
|
|
748
752
|
by_proficiency:
|
|
749
753
|
normal: { model: gemini-3.8-flash-medium }
|
|
@@ -756,7 +760,7 @@ providers:
|
|
|
756
760
|
```
|
|
757
761
|
|
|
758
762
|
- `--sandbox` は書き込み先を `~/.gemini/antigravity-cli/scratch/` へ逃がすため、`--add-dir "$(pwd)"` で作業ディレクトリ(worktree)を明示して成果物へ書けるようにします。`--add-dir` なしでは成果物が更新されません。
|
|
759
|
-
-
|
|
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 エージェント設定]] を参照してください。
|
|
760
764
|
- モデルは `agy models` で確認します。標準モデルは `by_proficiency`、Antigravity 経由の Claude / GPT は `by_nickname` で選びます。モデル ID は推論強度を含む(`gemini-3.8-flash-medium` など)ため `--effort` は併用しません。ID と `--effort` が食い違うと `invalid model selection` で起動に失敗します。
|
|
761
765
|
- 資格情報はコンテナ内では `~/.gemini/antigravity-cli/antigravity-oauth-token` に保存されます。devcontainer では `~/.gemini` を名前付きボリュームにして永続化します。
|
|
762
766
|
- `--output-format json --json-schema <file>` は `structured_output` を含む JSON エンベロープを返します。runner の reporter は stdout の本文から JSON を読むため、現時点では既定のテキスト出力を使います。
|
|
@@ -17,7 +17,7 @@ Exec Operation Guide
|
|
|
17
17
|
|
|
18
18
|
**この文書で分かること**
|
|
19
19
|
|
|
20
|
-
- 実行経路の選び方、状態遷移、blocked 復帰、再実行、human タスクの扱い、register から approach を使って成果物・kata
|
|
20
|
+
- 実行経路の選び方、状態遷移、blocked 復帰、再実行、human タスクの扱い、register から approach を使って成果物・kata を作る・直す手順、文脈を渡して段階的に作成する流れ
|
|
21
21
|
|
|
22
22
|
**次に読む文書**
|
|
23
23
|
|
|
@@ -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
|
|
@@ -653,7 +665,7 @@ specdojo:
|
|
|
653
665
|
#### 4.3.1. 成果物を対象にする場合
|
|
654
666
|
|
|
655
667
|
- **対象(`targets`)**: 成果物カタログ(DCT)に定義されている成果物の文書 ID(doc id)を指定します(例: `prj-0001:cxd-specdojo`、`specdojo:exec-config-guide`)。プロダクト成果物の場合は `local_id` の canonical 形式(`<project-id>:<local_id>`)も受け付けます。まだ文書ファイルが作成されていない成果物であっても、カタログに定義されていればカタログで解決され、起票・実行できます。
|
|
656
|
-
- **進め方(`approach`)**: 成果物を作成・修正する進め方(`fully-guided
|
|
668
|
+
- **進め方(`approach`)**: 成果物を作成・修正する進め方(`draft`(文脈を調べて下書き)、`fully-guided`(既存成果物の磨き込み)、`recipe-guided`、`freeform`、`bootstrap`、`retrofit`、`cross-deliverable-dedup` など)から目的に応じて選びます。
|
|
657
669
|
|
|
658
670
|
#### 4.3.2. kata(実践の型)を対象にする場合
|
|
659
671
|
|
|
@@ -711,3 +723,97 @@ specdojo register close \
|
|
|
711
723
|
--id <PJR-ID> \
|
|
712
724
|
--conclusion "設定ガイドを改訂し検証を通過"
|
|
713
725
|
```
|
|
726
|
+
|
|
727
|
+
### 4.7. 文脈を渡して段階的に作成する手順
|
|
728
|
+
|
|
729
|
+
成果物をゼロから作成する場合や、技術スタックの選定などの調査を伴う場合は、成果物の雛形作成から文脈の記入、下書き(`draft`)、磨き込み(`fully-guided`)、人間の確定(`finalize`)へと段階的に個票を分けて進めます。
|
|
730
|
+
|
|
731
|
+
#### 4.7.1. 5つの段階と役割分担
|
|
732
|
+
|
|
733
|
+
成果物作成の流れは、次の 5 段階で役割を分担します。
|
|
734
|
+
|
|
735
|
+
| 段階 | 実行主体 | approach | 役割と進め方 |
|
|
736
|
+
| ----------------------- | -------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
737
|
+
| 1. 雛形作成(scaffold) | CLI / 人 | - | `deliverable scaffold` で成果物のファイル雛形を生成する |
|
|
738
|
+
| 2. 文脈の記入 | 人 | - | 成果物内に `_CONTEXT_:` を記入、または個票の `入力`(`--input`)で前提・制約・調査委任の指示を渡す |
|
|
739
|
+
| 3. 下書き(draft) | agent | `draft` | 文脈で任された範囲を調査・選定して下書きする。選定値を提案として示し、出典と選定理由を result に記録する。反映した `_CONTEXT_:` は削除して result に写す |
|
|
740
|
+
| 4. 磨き込み(refine) | agent | `fully-guided` | 既存成果物を実践の型(rulebook / recipe / sample)に照らして構造・用語・整合性を磨き込む(磨き込み専用)。新たな調査や外部情報の追加は行わない |
|
|
741
|
+
| 5. 確定(finalize) | 人 | `finalize` | `done_criteria` や未反映の文脈指示(`_CONTEXT_:` の残り)がないことを確認し、成果物の `status` を `ready` へ昇格する |
|
|
742
|
+
|
|
743
|
+
#### 4.7.2. 個票の分割と `depends_on` による連携
|
|
744
|
+
|
|
745
|
+
この流れをプロジェクト登録簿(register)で進める場合は、`draft`、`fully-guided`、`finalize` の各段階を個票(`todo`)として起票し、`depends_on` で先行タスクに依存させて順に実行します。
|
|
746
|
+
|
|
747
|
+
たとえば、フロントエンドの技術スタック詳細定義(TSD)を「静的サイトで主流の技術スタックで書く」と指示して段階的に作成する場合の手順は次のとおりです。
|
|
748
|
+
|
|
749
|
+
```bash
|
|
750
|
+
# 1. 雛形を作成する
|
|
751
|
+
# カタログにある成果物を 1 件だけ指定して作成する場合:
|
|
752
|
+
specdojo deliverable scaffold \
|
|
753
|
+
--project prj-0001 \
|
|
754
|
+
--target prj-0001:tsd-frontend-site
|
|
755
|
+
|
|
756
|
+
# カタログにない成果物を雛形にする場合は --target-path と --target-rulebook を指定する:
|
|
757
|
+
specdojo deliverable scaffold \
|
|
758
|
+
--project prj-0001 \
|
|
759
|
+
--target prj-0001:tsd-custom-tool \
|
|
760
|
+
--target-path docs/ja/projects/prj-0001/architecture/tsd-custom-tool.md \
|
|
761
|
+
--target-rulebook specdojo:tsd-rulebook
|
|
762
|
+
```
|
|
763
|
+
|
|
764
|
+
`deliverable scaffold` は `--target <doc-id>` で成果物を 1 つだけ指定して雛形を作成できます。カタログにない成果物は、`--target-path` と `--target-rulebook` を添えて作成します(PJR-S23T)。また、`specdojo:tsd-rulebook` のように template を持たない(`template: not-needed` と宣言された)rulebook であっても、最小構成の雛形(frontmatter、見出し、本文の `_TODO_`)が生成されます。その際、雛形 frontmatter の `type` は rulebook の `deliverable_type`(TSD の場合は `architecture`)が自動設定されるため(未宣言なら `project`)、`docs-lint` の `frontmatter-deliverable-type` 検証をそのまま通過できます(PJR-YKYK)。
|
|
765
|
+
|
|
766
|
+
```bash
|
|
767
|
+
# 2. 成果物に文脈を記入する(または個票の --input で渡す)
|
|
768
|
+
# 生成された docs/.../tsd-frontend-site.md の先頭章などに次のように記入する:
|
|
769
|
+
# _CONTEXT_: 静的サイトで主流の技術スタック(Astro 等)を調査し、採用理由・全体構成・導入手順を下書きしてください。
|
|
770
|
+
|
|
771
|
+
# 3. 下書き(draft)の個票を起票する(対話から得た前提は --input でも渡せる)
|
|
772
|
+
specdojo register add \
|
|
773
|
+
--project prj-0001 \
|
|
774
|
+
--type todo \
|
|
775
|
+
--title "フロントエンドTSDの下書き(draft)" \
|
|
776
|
+
--topic tsd-frontend-draft \
|
|
777
|
+
--difficulty medium \
|
|
778
|
+
--approach draft \
|
|
779
|
+
--target prj-0001:tsd-frontend-site \
|
|
780
|
+
--input "静的サイトで主流の技術スタック(Astro 等)を調査して選定する" \
|
|
781
|
+
--owner DEV
|
|
782
|
+
|
|
783
|
+
# 4. 磨き込み(fully-guided)の個票を起票し、draft 個票に依存させる
|
|
784
|
+
specdojo register add \
|
|
785
|
+
--project prj-0001 \
|
|
786
|
+
--type todo \
|
|
787
|
+
--title "フロントエンドTSDの磨き込み(fully-guided)" \
|
|
788
|
+
--topic tsd-frontend-refine \
|
|
789
|
+
--difficulty medium \
|
|
790
|
+
--approach fully-guided \
|
|
791
|
+
--target prj-0001:tsd-frontend-site \
|
|
792
|
+
--depends-on <DRAFT-PJR-ID> \
|
|
793
|
+
--owner DEV
|
|
794
|
+
|
|
795
|
+
# 5. 確定(finalize)の個票を起票し、fully-guided 個票に依存させる
|
|
796
|
+
specdojo register add \
|
|
797
|
+
--project prj-0001 \
|
|
798
|
+
--type todo \
|
|
799
|
+
--title "フロントエンドTSDの確定(finalize)" \
|
|
800
|
+
--topic tsd-frontend-finalize \
|
|
801
|
+
--difficulty easy \
|
|
802
|
+
--approach finalize \
|
|
803
|
+
--target prj-0001:tsd-frontend-site \
|
|
804
|
+
--depends-on <REFINE-PJR-ID> \
|
|
805
|
+
--owner PO
|
|
806
|
+
```
|
|
807
|
+
|
|
808
|
+
#### 4.7.3. 順次実行と引き継ぎ
|
|
809
|
+
|
|
810
|
+
起票した個票は、`depends_on` の順序に従って実行します。
|
|
811
|
+
|
|
812
|
+
1. **下書き(draft)の実行**:
|
|
813
|
+
`exec run --register <DRAFT-PJR-ID> --worktree` を実行します。agent は成果物内の `_CONTEXT_:` や個票の `入力` を読み取り、技術スタックを調べて下書きします。反映した `_CONTEXT_:` は削除され、元の指示と選定理由は draft の result に記録されます。実行完了後に内容を確認し、`register close` します。
|
|
814
|
+
2. **磨き込み(fully-guided)の実行**:
|
|
815
|
+
draft が完了したら、後続の `exec run --register <REFINE-PJR-ID> --worktree` を実行します。agent は draft で作成された草案を rulebook や recipe に適合するように磨き込みます。この段では外部調査を行わず、既存の草案の構造・記述を整理します。実行完了後に内容を確認し、`register close` します。
|
|
816
|
+
3. **人間による確定(finalize)**:
|
|
817
|
+
人が成果物を確認し、`done_criteria` を満たしていること、未反映の `_CONTEXT_:` が残っていないことをチェックします。問題がなければ `status` を `ready` へ昇格し、個票を close します。
|
|
818
|
+
|
|
819
|
+
夜間や自動でまとめて実行する場合は、本ガイドの「2. 実行の列の組み方」と同様に、これらを 1 本の列に並べて順に流します。先行タスクが成功して統合されることで、後続タスクがその成果物を引き継いで実行されます。
|
|
@@ -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
|
|