specdojo 0.4.0 → 0.4.2
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 +61 -2
- package/CHANGELOG.md +65 -0
- package/README.md +8 -7
- package/dist/commands/init.js +88 -15
- package/dist/commands/night-orchestrator.js +287 -0
- package/dist/commands/orchestrator.js +10 -3
- package/dist/dashboard/timeline-build.js +4 -151
- package/dist/devcontainer/command.js +3 -1
- package/dist/devcontainer/scaffold.js +166 -5
- package/dist/exec/agent-config.js +60 -2
- package/dist/exec/events.js +17 -6
- package/dist/exec/parent-validation.js +14 -0
- package/dist/exec/pipeline-state.js +13 -0
- package/dist/exec/plans-core.js +16 -5
- package/dist/exec/plans-storage.js +11 -3
- package/dist/exec/register.js +23 -1
- package/dist/exec/repo-integration.js +1 -1
- package/dist/exec/reporter.js +113 -13
- package/dist/exec/results.js +36 -14
- package/dist/exec/run/agent-pipeline.js +3 -0
- package/dist/exec/run/agent.js +40 -5
- package/dist/exec/run/job.js +2 -2
- package/dist/exec/run/lifecycle-commands.js +2 -2
- package/dist/exec/run/register-command.js +23 -4
- package/dist/exec/run/register-core.js +17 -0
- package/dist/exec/run/register-mode.js +39 -16
- package/dist/exec/run/register-post-review.js +420 -0
- package/dist/exec/run/register-resume.js +27 -11
- package/dist/exec/run/register-worktree.js +66 -2
- package/dist/exec/run/run.js +1 -1
- package/dist/exec/run/shared.js +22 -24
- package/dist/exec/task-repos.js +102 -15
- package/dist/kata/kata.js +1 -1
- package/dist/register/core.js +17 -4
- package/dist/register/create-commands.js +62 -6
- package/dist/register/cross-project.js +134 -0
- package/dist/register/derivation.js +28 -7
- package/dist/register/event-merge.js +13 -1
- package/dist/register/events.js +4 -0
- package/dist/register/item.js +35 -5
- package/dist/register/migration.js +1 -0
- package/dist/register/register.js +47 -30
- package/dist/schedule/strategy-generate-scope.js +2 -1
- package/dist/shared/catalog-files.js +31 -0
- package/dist/shared/git.js +45 -15
- package/dist/shared/lefthook-scaffold.js +177 -0
- package/dist/shared/provider-scaffold.js +3 -2
- package/dist/shared/specdojo-config.js +87 -17
- package/dist/shared/text.js +4 -1
- package/dist/shared/timeline-index.js +125 -0
- package/dist/shared/workspace-scaffold.js +69 -0
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +2 -1
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xrp-register-post-run-template.md +46 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +34 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +79 -11
- package/docs/ja/specdojo/guides/exec-operation-guide.md +39 -1
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +9 -3
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +4 -2
- package/docs/ja/specdojo/guides/quick-start-guide.md +31 -6
- package/docs/ja/specdojo/guides/register-operation-guide.md +54 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +52 -6
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +1 -1
- package/docs/ja/specdojo/guides/waza-guide.md +1 -1
- package/docs/ja/specdojo/references/command-reference.md +138 -64
- package/docs/ja/specdojo/references/specdojo-config-reference.md +41 -12
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +5 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +92 -18
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +6 -1
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +12 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +21 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +40 -0
- package/package.json +17 -17
- package/templates/antigravity/README.md +1 -1
- package/templates/antigravity/orchestrator.md +61 -2
- package/templates/claude/agents/specdojo-orchestrator.md +61 -2
- package/templates/codex/README.md +17 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +61 -2
- package/templates/codex/orchestrator.md +61 -2
- package/templates/devcontainer/devcontainer.json +3 -0
- package/templates/devcontainer/post-create.sh +15 -7
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +38 -5
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -0
- package/templates/devcontainer/vim/vimrc +37 -0
- package/templates/init-agent-members.yaml +6 -6
- package/templates/init-exec-defaults.yaml +20 -1
- package/templates/lefthook/tools/install-lefthook.mjs +46 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +207 -0
- package/templates/opencode/README.md +6 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +62 -3
- /package/dist/{shared → kata}/yaml-schema-modeline.js +0 -0
|
@@ -54,11 +54,13 @@ SpecDojo は自律実行を前提とします。次の 2 つが作業端末の
|
|
|
54
54
|
利用リポジトリに `.devcontainer/` がない場合は、指定した provider の CLI を含む最小構成を生成できます。まず dry-run で対象を確認します。
|
|
55
55
|
|
|
56
56
|
```bash
|
|
57
|
-
npx specdojo devcontainer scaffold --provider claude,codex --dry-run
|
|
58
|
-
npx specdojo devcontainer scaffold --provider claude,codex
|
|
57
|
+
npx specdojo devcontainer scaffold --provider claude,codex --preset recommended --dry-run
|
|
58
|
+
npx specdojo devcontainer scaffold --provider claude,codex --preset recommended
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
`recommended` preset は、端末版 Emacs と Vim(既存設定を上書きしない雛形)、tmux、SpecDojo の文書作業向け VS Code 拡張をまとめて追加します。拡張は Git Graph、markdownlint、YAML、Prettier、remark、Markdown All in One、Code Spell Checker、EditorConfig、Error Lens、Even Better TOML で、選択した provider の拡張もその provider の分だけ追加します。Markdown と YAML は保存時に Prettier で整形し、主要な SpecDojo YAML を `docs/specdojo/schemas/v1/` の schema へ関連付けます。同じ拡張は `.vscode/extensions.json` の recommendation にも追加されます。
|
|
62
|
+
|
|
63
|
+
既存の `.devcontainer/` は通常実行では上書きしません。置き換える場合だけ `--force` を指定します。生成設定は provider の設定ディレクトリを名前付きボリュームへ保存し、ホストの認証情報・秘密鍵・`.env` は既定でマウントしません。preset を使わない場合、Ollama 接続、コンテナ内の cron、コンテナ内の tmux が必要なときだけ `--ollama`、`--cron`、`--tmux` を追加します。本書の構成図のようにホスト側の tmux でコンテナ自体を包む場合、tmux を含めない個別指定も選べます。
|
|
62
64
|
|
|
63
65
|
生成する `devcontainer.json` は、利用リポジトリ単体ではなく、その親ディレクトリをホスト側と同じ名前の `/workspaces/<親名>` へマウントします。例えば `app1-workspace/app1-specdojo` の作業ディレクトリは `/workspaces/app1-workspace/app1-specdojo` です。別リポジトリ構成では `repos` の参照先(例: `../app1`)と `worktree_base`(例: `../app1-specdojo-worktrees`)が利用リポジトリの外にあるためです。これらの Git リポジトリと worktree は `safe.directory` の対象になります。一方、同じ親ディレクトリに置いたその他のファイルもコンテナから見えるため、秘密情報などコンテナへ公開しないファイルは別の場所へ置いてください。
|
|
64
66
|
|
|
@@ -75,10 +77,34 @@ npx specdojo devcontainer scaffold --provider claude,codex --editor emacs
|
|
|
75
77
|
scaffold は、常時稼働ホストへの接続と tmux セッションの維持に使えるサンプルを `.devcontainer/remote-host/` に生成します。
|
|
76
78
|
|
|
77
79
|
- `specdojo-tmux.sh.sample`: 常時稼働ホストの `~/bin/specdojo-tmux.sh` などへコピーし、実行権限(`chmod +x`)を付与して使います。devcontainer が停止していれば `devcontainer up` で起動し、コンテナ内の tmux セッション(`specdojo`)へ接続します。ホスト名や作業パスはプレースホルダーになっているため、ホストの環境に合わせて調整してください。
|
|
78
|
-
- `ssh-config.sample`: 接続元端末の `~/.ssh/config` へ追加して使います。ホストへの通常接続エイリアスと、`RemoteCommand` と `RequestTTY force` で `specdojo-tmux.sh` を直接呼び出すエイリアス(`Host <host>-tmux
|
|
80
|
+
- `ssh-config.sample`: 接続元端末の `~/.ssh/config` へ追加して使います。ホストへの通常接続エイリアスと、`RemoteCommand` と `RequestTTY force` で `specdojo-tmux.sh` を直接呼び出すエイリアス(`Host <host>-tmux`)を含みます。`RemoteCommand` では端末の `PATH` の設定が読み込まれないため、接続元から `ssh <host> 'command -v devcontainer'` を実行して Dev Container CLI が見つかるか確かめられます。
|
|
79
81
|
|
|
80
82
|
`devcontainer.json` の `appPort` や `forwardPorts` で開発サーバなどの公開ポートを設定している場合は、接続用エイリアスに `LocalForward` の行が含まれます。開発サーバのポートを増やしたときは、`~/.ssh/config` の tmux 接続用エイリアスにも `LocalForward <ポート> 127.0.0.1:<ポート>` を追加してください。
|
|
81
83
|
|
|
84
|
+
生成される `devcontainer.json` は `remoteEnv` で `/home/node/.local/bin`(利用者が別の場合は `/home/<remoteUser>/.local/bin`)を `PATH` の先頭に追加するため、コンテナ作成後に開く端末や VS Code のターミナルでも `~/.local/bin` に入った Claude Code などの CLI がそのまま利用できます。
|
|
85
|
+
|
|
86
|
+
### 2.2. 生成した Dev Container をホストで実地確認する
|
|
87
|
+
|
|
88
|
+
SpecDojo 本体の開発者は、Docker daemon と Dev Container CLI を利用できる Mac のホストで、次の E2E を実行できます。ホストとコンテナで `node_modules` を共有しているため `tsx` は使えません。スクリプトは Node の標準ライブラリだけを使っており、Node 22.18 以上(型を外して直接動かせる版)が必要です。
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
node tools/e2e/devcontainer-host-e2e.ts
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
このスクリプトは、手元のソースを npm tarball にし、新しい一時リポジトリで `specdojo init --yes --provider claude --devcontainer` と `devcontainer up` を実行します。作成したコンテナでは、利用者、`~/.local/bin` の所有者、tmux、Vim、Emacs、Claude Code CLI の配置を項目ごとに検査します。また、agent にホストの権限を渡さない前提を守るため、開発用コンテナに Docker CLI がないことも検査します。
|
|
95
|
+
|
|
96
|
+
通常は、検査の成否にかかわらず一時ディレクトリ、コンテナ、テスト用の名前付き volume、テストで新しく作られた container image を最後に削除します。失敗状態を調べる場合は `--keep` を付けて残し、表示された一時ディレクトリと Docker resource を調査後に手動で削除してください。
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
node tools/e2e/devcontainer-host-e2e.ts --keep
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Docker または Dev Container CLI を利用できない場合、スクリプトは確認コマンドと Dev Container CLI の導入方法を表示し、終了コード 1 で終了します。Dev Container CLI は次のコマンドで導入できます。
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
npm install --global @devcontainers/cli
|
|
106
|
+
```
|
|
107
|
+
|
|
82
108
|
## 3. 構成例
|
|
83
109
|
|
|
84
110
|
```text
|
|
@@ -165,12 +191,32 @@ Host <ホスト名>
|
|
|
165
191
|
|
|
166
192
|
### 6.2. 実行環境の起動に失敗する
|
|
167
193
|
|
|
168
|
-
SSH
|
|
194
|
+
SSH 経由の非対話シェル(`RemoteCommand` など)では、ログインシェルや対話端末で読み込まれる `~/.zshrc` などの `PATH` の設定が読み込まれないため、コンテナ起動用のコマンドが見つからない場合があります。接続元から次を実行して確認します。
|
|
195
|
+
|
|
196
|
+
```bash
|
|
197
|
+
ssh <ホスト名> 'command -v devcontainer'
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
`devcontainer` が見つからない場合は、ホスト側の通常端末で `dirname "$(command -v devcontainer)"` を実行して場所を確認し、`specdojo-tmux.sh` の `node_bin_dir` に設定してください。詳細な `PATH` を確認する場合は次を実行します。
|
|
169
201
|
|
|
170
202
|
```bash
|
|
171
|
-
ssh <ホスト名> 'printf "PATH=%s\n" "$PATH"; command -v node || true'
|
|
203
|
+
ssh <ホスト名> 'printf "PATH=%s\n" "$PATH"; command -v node || true; command -v devcontainer || true'
|
|
172
204
|
```
|
|
173
205
|
|
|
206
|
+
### 6.3. コンテナ内の端末で ~/.local/bin の CLI が見つからない
|
|
207
|
+
|
|
208
|
+
v0.4.0 などで生成した Dev Container 環境では、`devcontainer.json` に `remoteEnv` がないため、コンテナ作成後に開く端末や VS Code のターミナルで `~/.local/bin` が `PATH` に入らず、Claude Code などの CLI が見つからない場合があります。
|
|
209
|
+
|
|
210
|
+
既存の環境を修正するには、`.devcontainer/devcontainer.json` に `remoteEnv` を追加(または既存の `remoteEnv` に `PATH` を追加)し、コンテナをリビルドしてください。
|
|
211
|
+
|
|
212
|
+
```json
|
|
213
|
+
"remoteEnv": {
|
|
214
|
+
"PATH": "/home/node/.local/bin:${containerEnv:PATH}"
|
|
215
|
+
}
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
コンテナ内の利用者が `node` 以外の場合は、`/home/<remoteUser>/.local/bin` に合わせてください。
|
|
219
|
+
|
|
174
220
|
## 7. 運用上のセキュリティ
|
|
175
221
|
|
|
176
222
|
この構成は、常時稼働ホストを外部から到達可能にします。次を守ります。
|
|
@@ -43,7 +43,7 @@ SpecDojo は道場のメタファーとして、`specdojo` CLI のコマンド
|
|
|
43
43
|
|
|
44
44
|
### 1.1. 技の名前
|
|
45
45
|
|
|
46
|
-
主要な CLI
|
|
46
|
+
主要な CLI 機能には、Spec道(仕様道)の道場で使う技の名前を付けています。
|
|
47
47
|
|
|
48
48
|
| 技の名前 | CLI の機能 | 役割 |
|
|
49
49
|
| -------- | ---------- | ---------------------------------------------------------------------------------- |
|
|
@@ -38,16 +38,16 @@ project の解決順序と設定は [遂行の技活用ガイド](../guides/waza
|
|
|
38
38
|
|
|
39
39
|
## 2. init / config / project
|
|
40
40
|
|
|
41
|
-
| コマンド | 用途
|
|
42
|
-
| ------------------------ |
|
|
43
|
-
| `init` | project から agent 実行までを質問式で初期設定する
|
|
44
|
-
| `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する
|
|
45
|
-
| `config migrate-members` | agent 定義を保護設定へ移す
|
|
46
|
-
| `config scaffold` | provider
|
|
47
|
-
| `project list` | 登録済み project を表示する
|
|
41
|
+
| コマンド | 用途 | 例 |
|
|
42
|
+
| ------------------------ | ----------------------------------------------------------- | ------------------------------------------- |
|
|
43
|
+
| `init` | project から agent 実行までを質問式で初期設定する | `specdojo init` |
|
|
44
|
+
| `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する | `specdojo config init` |
|
|
45
|
+
| `config migrate-members` | agent 定義を保護設定へ移す | `specdojo config migrate-members --dry-run` |
|
|
46
|
+
| `config scaffold` | provider、VS Code ワークスペース、Git hook を個別に配置する | `specdojo config scaffold --lefthook` |
|
|
47
|
+
| `project list` | 登録済み project を表示する | `specdojo project list` |
|
|
48
48
|
|
|
49
49
|
`init` は対話できる端末で、project ID と名前、register、人の nickname と表示名、複数指定可能な
|
|
50
|
-
provider、exec、Dev Container
|
|
50
|
+
provider、exec、Dev Container、Git hook の順に質問します。Dev Container を選んだ場合だけ、続けて推奨 preset を入れるかを質問します(既定は「入れる」)。Git hook は既定では作りません。成果物カタログは対話では質問せず、`--catalog <size>` を
|
|
51
51
|
明示した場合にだけ作成します。既存ファイルは上書きせず、スキップしたパスを表示します。`--dry-run` は
|
|
52
52
|
予定だけを表示し、ファイルや `package.json` を変更しません。各回答は質問の直後に検証され、誤りの理由を
|
|
53
53
|
表示して同じ質問だけをやり直します。それまでの回答は保持されます。`--exec` を選んだのに provider が
|
|
@@ -56,20 +56,22 @@ provider、exec、Dev Container の順に質問します。成果物カタログ
|
|
|
56
56
|
|
|
57
57
|
非対話環境では質問せず、次の主要オプションと既定値を使います。
|
|
58
58
|
|
|
59
|
-
| オプション
|
|
60
|
-
|
|
|
61
|
-
| `--yes`
|
|
62
|
-
| `--project <id>`
|
|
63
|
-
| `--name <name>`
|
|
64
|
-
| `--no-register`
|
|
65
|
-
| `--nickname <nickname>`
|
|
66
|
-
| `--display-name <name>`
|
|
67
|
-
| `--provider <names>`
|
|
68
|
-
| `--exec`
|
|
69
|
-
| `--catalog <size>`
|
|
70
|
-
| `--devcontainer`
|
|
71
|
-
| `--
|
|
72
|
-
| `--
|
|
59
|
+
| オプション | 用途 | 既定値 |
|
|
60
|
+
| ------------------------------ | ------------------------------------------------------------------------- | --------------- |
|
|
61
|
+
| `--yes` | 質問せず既定値と指定済みオプションで実行する | - |
|
|
62
|
+
| `--project <id>` | project ID | `prj-0001` |
|
|
63
|
+
| `--name <name>` | project の表示名 | `My Project` |
|
|
64
|
+
| `--no-register` | register を作らない | register を作る |
|
|
65
|
+
| `--nickname <nickname>` | 人の名簿に書く nickname | `owner` |
|
|
66
|
+
| `--display-name <name>` | 人の名簿に書く表示名 | `Project Owner` |
|
|
67
|
+
| `--provider <names>` | provider をカンマ区切りで指定する | `codex` |
|
|
68
|
+
| `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
|
|
69
|
+
| `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない |
|
|
70
|
+
| `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
|
|
71
|
+
| `--lefthook` | commit 前の文書・SpecDojo 検査を行う Git hook を作る | 作らない |
|
|
72
|
+
| `--devcontainer-preset <name>` | Dev Container の preset(`recommended` / `none`)を選ぶ | `recommended` |
|
|
73
|
+
| `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名 | ホスト側の親名 |
|
|
74
|
+
| `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
|
|
73
75
|
|
|
74
76
|
`init` が作る `.specdojo/agent-members.yaml` と `.specdojo/exec-defaults.yaml` は、選択した
|
|
75
77
|
provider だけを含みます。親 runner の検証は、対応する `package.json` の npm script が存在する
|
|
@@ -91,6 +93,8 @@ provider 設定、登録簿作成の順に次のコマンドを案内します
|
|
|
91
93
|
書き込まず、予定の内容だけを表示します。`config scaffold` の `--provider` には
|
|
92
94
|
`antigravity`、`claude`、`codex`、`copilot`、`opencode` を指定でき、`--dry-run` と `--force` も利用できます。
|
|
93
95
|
|
|
96
|
+
`package.json` がある場合、provider ごとのオーケストレーター起動スクリプトも追加します。Claude Code は `orch:opus`・`orch:sonnet`、Codex は `orch:sol`(`gpt-5.6-sol`)・`orch:terra`(`gpt-5.6-terra`)、Antigravity は `orch:flash`(`gemini-3.8-flash-high`)、OpenCode は `orch:opencode` です。既存のスクリプトは `--force` を付けても上書きしません。
|
|
97
|
+
|
|
94
98
|
`antigravity` に限り `--global` を指定すると、`~/.gemini/antigravity-cli/settings.json` へ SpecDojo 用の permission rule を追記します。既存キー・既存 rule は保持し、実書き込み前に timestamp 付きバックアップを作ります。`--global` を省略した通常実行はユーザーディレクトリへ触れません。適用前は次の dry-run で追加 rule を確認してください。
|
|
95
99
|
|
|
96
100
|
```bash
|
|
@@ -100,6 +104,40 @@ specdojo config scaffold --provider antigravity --global
|
|
|
100
104
|
|
|
101
105
|
`--force` はリポジトリ内の scaffold ファイルだけを上書きし、グローバル設定の既存項目は上書きしません。従来の `exec scaffold --provider antigravity` でも同じ `--global` / `--dry-run` の挙動を利用できます。
|
|
102
106
|
|
|
107
|
+
`config scaffold --lefthook` は、利用リポジトリに `lefthook.yml`、`.markdownlint.jsonc`、
|
|
108
|
+
`.markdownlintignore`、依存なしで起動できる `tools/install-lefthook.mjs` と
|
|
109
|
+
`tools/specdojo-pre-commit.mjs` を生成します。pre-commit では staged の Markdown と YAML だけを
|
|
110
|
+
Prettier で整形し、staged の Markdown だけを markdownlint で検査します。
|
|
111
|
+
また、`.specdojo/specdojo.config.json` の `project_register_path` 配下に staged の変更がある project では
|
|
112
|
+
`specdojo register build`、`catalog_path` 配下に変更がある project では `specdojo catalog validate` を
|
|
113
|
+
実行します。`catalog_path` がない構成には catalog の command を生成せず、テストは hook に含めません。
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
specdojo config scaffold --lefthook --dry-run
|
|
117
|
+
specdojo config scaffold --lefthook
|
|
118
|
+
npm install
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
生成する markdownlint 設定は SpecDojo の文書向けに行長などの規則を調整し、ignore は Claude Code、
|
|
122
|
+
GitHub Copilot、OpenCode の agent 定義を検査対象から外します。既存の markdownlint 設定と ignore は
|
|
123
|
+
`--force` を付けても上書きしません。既存の `lefthook.yml` と `tools/` のファイルは `--force` なしでは
|
|
124
|
+
上書きしません。必要な
|
|
125
|
+
`lefthook`・`prettier`・`markdownlint-cli` の devDependencies と `prepare`・`pre-commit` npm script は、
|
|
126
|
+
不足している項目を `package.json` の変更前に表示してから追加します。同名の script、dependencies、
|
|
127
|
+
devDependencies は `--force` を指定しても保持します。`package.json` がない場合は必要な JSON を表示する
|
|
128
|
+
だけで、ファイルを新規作成しません。installer は linked worktree と `node_modules/lefthook` がない環境を
|
|
129
|
+
成功扱いで skip します。primary worktree で `npm install`、または既存の `prepare` を保持した場合は
|
|
130
|
+
`node tools/install-lefthook.mjs` を実行してください。hook 内から Git を呼ぶ入口は `GIT_DIR` などの
|
|
131
|
+
repository-local 環境変数を除いてから staged files を調べます。
|
|
132
|
+
|
|
133
|
+
`config scaffold --workspace` は、`.specdojo/specdojo.config.json` の `repos` 宣言から VS Code のマルチルートワークスペース(`<project-id>.code-workspace`)をリポジトリルートに生成します。`folders` にはプロジェクトリポジトリ(`.`)と各プロダクトリポジトリ(`repos[].path`)を宣言順に並べ、別リポジトリ構成でも 1 つの VS Code ウィンドウでプロジェクトとプロダクトを同時に開けます。`--project <id>` で対象 project を指定でき、省略時は `current_project` を使います。既存のファイルは `--force` を指定しない限り上書きしません。`repos` が宣言されていない project ではエラーになります。`--dry-run` は書き込まず予定の内容だけを表示します。
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
specdojo config scaffold --workspace
|
|
137
|
+
specdojo config scaffold --workspace --project prj-0002 --dry-run
|
|
138
|
+
specdojo config scaffold --workspace --force
|
|
139
|
+
```
|
|
140
|
+
|
|
103
141
|
`config migrate-members` は、各 project の `pm-members.yaml` から `type: agent` の member を取り出し、トップレベルの `agent_members_path`(既定 `.specdojo/agent-members.yaml`)へ統合します。通常実行前に `--dry-run` で対象と件数を確認してください。`--project <id>` を指定すると 1 project だけを対象にします。
|
|
104
142
|
|
|
105
143
|
`current_project` を設定しておくと、多くのコマンドで `--project` を省略できます。
|
|
@@ -338,7 +376,7 @@ specdojo schedule strategy generate \
|
|
|
338
376
|
| `register history` | 追記型 event と旧 Git 履歴から変更を再構成する | `specdojo register history --project prj-0001 --since 2026-08-01` |
|
|
339
377
|
| `register migrate` | 旧形式の登録簿データを現行形式へ移行する | `specdojo register migrate --project prj-0001 --dry-run` |
|
|
340
378
|
|
|
341
|
-
`register add` は ID
|
|
379
|
+
`register add` は ID を省略すると自動採番し、現在の project では現在の作業ツリーに type 別の個票を作成します。別 project を `--project` で指定して `--commit` を付けると、対象 project の統合ブランチを開いている worktree、または CLI が作る一時 worktree で起票・再生成・commit を完了します。ID は乱数部分を持ち、曖昧文字(`I` / `L` / `O` / `U`)を除いた英大文字+数字の 32 文字セットによる 4 桁(例: `PJR-4B7K`)です。個票 Frontmatter が分類、処理状態、優先度、担当、日付、結論の正本であり、`register build` は個票から一覧と派生ビューを生成します。`register` 系コマンドはすべて、成功時の通常出力を標準出力へ、エラーメッセージを標準エラー出力へ書きます。
|
|
342
380
|
|
|
343
381
|
主要オプション:
|
|
344
382
|
|
|
@@ -347,7 +385,7 @@ specdojo schedule strategy generate \
|
|
|
347
385
|
| `--to <PJR-ID>` | 移動先の PJR-ID を指定する | `renumber` |
|
|
348
386
|
| `--registered <datetime>` | 起票日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `add` |
|
|
349
387
|
| `--completed <datetime>` | 完了・却下日時(タイムゾーン付き RFC 3339)。省略時は実行時刻 | `close` / `reject` |
|
|
350
|
-
| `--by <actor>` |
|
|
388
|
+
| `--by <actor>` | 名簿または予約一覧の actor を追記型 event に記録する | `add` / 更新 / 遷移コマンド |
|
|
351
389
|
| `--reason <text>` | event の理由を記録(`wait` では `block_reason` も更新) | `add` / 更新 / 遷移コマンド |
|
|
352
390
|
| `--conclusion <text>` | 終端時の結論を記録・更新(`update` では `-` で削除) | `add` / `update` / 終端コマンド |
|
|
353
391
|
| `--block-reason <text>` | `waiting` の理由を更新(`-` で削除) | `update` |
|
|
@@ -366,6 +404,8 @@ specdojo schedule strategy generate \
|
|
|
366
404
|
|
|
367
405
|
`register add` は個票 Frontmatter の `registered_at`(起票日時)を、`register close` / `register reject` は `completed_at`(完了・却下日時)を自動記入します。値は UTC の RFC 3339・秒精度(例: `2026-08-09T14:08:51Z`)で、OS / コンテナの `TZ` 環境変数には依存しません。`register reopen` は `completed_at` を削除します。
|
|
368
406
|
|
|
407
|
+
`register` の `--by` は、project の `pm-members.yaml` にある人の nickname、`.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` だけを受け付けます。agent alias は実体名で event に記録し、未知の値は書き込み前に拒否します。省略時は `SpecDojo` です。決定・承認では `PO` などの Role code や予約 actor ではなく、本人の nickname を指定します。
|
|
408
|
+
|
|
369
409
|
`--approach` を指定する場合、`--target` は 1 件だけ必須です。成果物を作成・修正する approach の対象は成果物カタログの doc id で解決するため、まだ文書がない成果物も指定できます。kata maintenance の対象は文書索引で解決し、approach に対応する kata 種別との一致も書き込み前に検証します。
|
|
370
410
|
|
|
371
411
|
`item_type: note` は `open` のまま更新する記録です。`register close` / `register reject` / `register defer` は終了コード 1 で拒否し、対応・回答・判断が必要な場合は `todo` / `question` / `decision` など目的に合う別の `item_type` で起票するよう案内します。本文の追記や修正には `register update` を使用できます。
|
|
@@ -374,12 +414,14 @@ specdojo schedule strategy generate \
|
|
|
374
414
|
|
|
375
415
|
`register update --topic <slug>` は個票のファイル名と Frontmatter の文書 ID を同時に変更し、`docs/ja` 配下の旧文書 ID 参照を更新してから生成ビューを再生成します。変更は `action: update` の event に文書 ID の変更として記録されます。形式は英小文字・数字・単一ハイフン区切りに限り、変更先ファイルが存在する場合は書き込み前に停止します。
|
|
376
416
|
|
|
377
|
-
`register add --from <ID>` は、起票の元になった登録項目を個票 Frontmatter の `derived_from` へ記録します。`--from` は複数回指定でき、同じ project の項目は `PJR-XXXX`、別 project の項目は `<project-id>:PJR-XXXX`
|
|
417
|
+
`register add --from <ID>` は、起票の元になった登録項目を個票 Frontmatter の `derived_from` へ記録します。`--from` は複数回指定でき、同じ project の項目は `PJR-XXXX`、別 project の項目は `<project-id>:PJR-XXXX` を使います。自己参照、未設定の project、存在しない項目は書き込み前に拒否します。別 project の項目は、その project の `integration_branch`(省略時は `project/<project-id>/develop`)の Git tree を読んで存在を確認します。`register update --from <ID>` は一覧を置換し、`--from -` で削除します。`register build` は `generated/pjr-derived-items.md` を生成し、元の項目から派生先を逆引きできるようにします。decision から todo を起票するときも、この関係を追跡先として使います。
|
|
378
418
|
|
|
379
419
|
`register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。`approach` を指定すると対象は 1 件だけ必須です。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にします。文書索引で解決できない ID、対象種別の不一致、複数対象との組み合わせは書き込み前に拒否します。`approach` を指定しない `--target` は複数回指定でき、従来どおり変更網羅検証の対象宣言として使えます。`register update` でも同じ検証を行います。
|
|
380
420
|
|
|
381
421
|
記帳系コマンドの `--commit` は、register の worktree 実行と同じ project の `register lifecycle` 枠を取得してから、記帳、`register build` 相当の検証・派生ビュー再生成、pathspec を限定した commit を行います。commit 対象はコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの変更を含めません。対象個票・event・参照文書に開始前の未 commit 変更がある場合は、既存差分との混在を避けるため記帳前に停止します。既定件名は `docs(register PJR-XXXX): <command> <title>` で、`-m` / `--message` により上書きできます。`--dry-run --commit` は変更予定だけを表示し、枠の取得と commit は行いません。
|
|
382
422
|
|
|
423
|
+
別 project への `register add` は `--commit` が必須です。対象 project の登録簿に未 commit 変更がある場合、または統合ブランチがローカルに存在しない場合は、何も書き込まず終了コード 1 で停止します。元の worktree とブランチは変更しません。`close`、`reject` など別 project の状態遷移は受け付けず、対象 project の worktree での実行を案内します。
|
|
424
|
+
|
|
383
425
|
一覧・派生ビューの「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。
|
|
384
426
|
|
|
385
427
|
`register migrate` は旧形式の登録簿データを現行形式へ移す一度限りの移行コマンドです。追跡対象だった `pjr-index.md` の表を個票 Frontmatter へ移し、旧日時を UTC へ変換し、個票内の `register_events` を `events/pjr-XXXX.yaml` へ分離します。イベントがまだない項目は、利用可能な Git 履歴を項目別イベントファイルへ変換します。event ID は commit・項目 ID・変更内容から決定的に生成するため、再実行で重複しません。
|
|
@@ -436,37 +478,41 @@ specdojo schedule strategy generate \
|
|
|
436
478
|
|
|
437
479
|
主要オプション:
|
|
438
480
|
|
|
439
|
-
| オプション
|
|
440
|
-
|
|
|
441
|
-
| `--task <task-id>`
|
|
442
|
-
| `--by <actor>`
|
|
443
|
-
| `--edit-by <nickname>`
|
|
444
|
-
| `--review-by <nickname>`
|
|
445
|
-
| `--strategy <name>`
|
|
446
|
-
| `--auto` / `--loop`
|
|
447
|
-
| `--parallel <n>`
|
|
448
|
-
| `--worktree`
|
|
449
|
-
| `--in-place`
|
|
450
|
-
| `--track-state`
|
|
451
|
-
| `--register <PJR-ID>`
|
|
452
|
-
| `--register-filter`
|
|
453
|
-
| `--register-commit`
|
|
454
|
-
| `--
|
|
455
|
-
| `--
|
|
456
|
-
| `--
|
|
457
|
-
| `--
|
|
458
|
-
| `--
|
|
459
|
-
| `--
|
|
460
|
-
| `--
|
|
461
|
-
| `--
|
|
462
|
-
| `--
|
|
463
|
-
| `--
|
|
464
|
-
| `--
|
|
481
|
+
| オプション | 用途 | 対象 |
|
|
482
|
+
| -------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
|
|
483
|
+
| `--task <task-id>` | 対象タスクを指定する | 状態遷移系 / `run` / `plan` |
|
|
484
|
+
| `--by <actor>` | 実行 actor / agent の nickname を指定する(手動ターゲットの agent 選択も兼ねる) | 状態遷移系 / `run` / `resume` / `worktree agent` |
|
|
485
|
+
| `--edit-by <nickname>` | `--auto` バッチで edit タスクに使う agent nickname | `run --auto` / `resume` |
|
|
486
|
+
| `--review-by <nickname>` | `--auto` の review タスク、または register の統合後 review に使う agent nickname | `run --auto` / `run --register --post-review` / `resume` |
|
|
487
|
+
| `--strategy <name>` | 選択戦略を切り替える(`critical-first` 既定 / `fifo`) | `scheduler` / `run --auto` |
|
|
488
|
+
| `--auto` / `--loop` | Ready タスクを自動選択する / Ready がなくなるまで繰り返す | `run` |
|
|
489
|
+
| `--parallel <n>` | 同時に走らせる agent 数の上限を指定する | `run --auto` / register の worktree モード |
|
|
490
|
+
| `--worktree` | worktree に隔離して実行する | `run --task` / `run --register` |
|
|
491
|
+
| `--in-place` | register 項目を現在の作業ツリーで実行する(`run.register_execution` を上書き) | `run --register` |
|
|
492
|
+
| `--track-state` | claim / complete の状態イベントを記録する | `run --task` |
|
|
493
|
+
| `--register <PJR-ID>` | 登録簿の項目を実行する(空白・カンマ区切りで複数可。場所の既定は `run.register_execution`) | `run` / `plan` |
|
|
494
|
+
| `--register-filter` | 登録簿項目を type / priority / status / limit の条件で決定論的に選ぶ | `run` |
|
|
495
|
+
| `--register-commit` | 成功したIDごとに、その実行で生じた変更を1コミットにまとめる(worktree モードでは常に commit のため無視) | `run --register` |
|
|
496
|
+
| `--post-review` | worktree 統合後に完了 review を行い、todo / issue を verdict に応じて close または waiting にする | `run --register --worktree` |
|
|
497
|
+
| `--on-failure <stop\|continue>` | 途中失敗時に残りのIDを停止するか継続するか(既定は `stop`) | `run --register` |
|
|
498
|
+
| `--integration-branch <repo>=<branch>` | run ごとのプロダクトリポジトリの統合先(繰り返し可)を指定する | register の worktree モード |
|
|
499
|
+
| `--resume` | run が止まった段(executor / reporter / 統合)を既存 worktree と checkpoint で再開する | register の worktree モード |
|
|
500
|
+
| `--resume-from executor` | reporter 段から再開可能な run を、既存成果を保持したまま executor 段から再開する | register の worktree モード(`--resume` と併用) |
|
|
501
|
+
| `--force-restart` | 再開可能な run の成果があっても、worktree を破棄して項目全体を再実行する | register の worktree モード |
|
|
502
|
+
| `--join` | 実行中の register worktree 実行の終了を待たずに合流して並行実行する(上限は `run.max_concurrent_runs`) | register の worktree モード |
|
|
503
|
+
| `--executor-by <nickname>` | executor 段の agent。register では `PJR-ID=nickname,...` による項目別指定も可能 | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
|
|
504
|
+
| `--reporter-by <nickname>` | executor/reporter パイプラインの reporter 段に使う agent nickname | `run --auto` / `resume` / `run --register` / `run --plan` / `run --deliverable` |
|
|
505
|
+
| `--on-rate-limit <action>` | 指名した agent の上限時の扱い。`stop` / `wait` / `fallback` | `run` / `resume` |
|
|
506
|
+
| `--fallback-executor-by <name>` | rate limit の `fallback` または接続不能時に executor 段を1回だけ引き継ぐ agent | `run` / `resume` |
|
|
507
|
+
| `--fallback-reporter-by <name>` | rate limit の `fallback` または接続不能時に reporter 段を1回だけ引き継ぐ agent | `run` / `resume` |
|
|
508
|
+
| `--due` | 再開時刻を迎えた利用制限延期 task を対象にする | `resume` |
|
|
465
509
|
|
|
466
510
|
`--plan` と `--deliverable` も Schedule のパイプライン宣言を持たないため、`--executor-by` / `--reporter-by` の少なくとも一方を指定したときだけ executor/reporter 2段階で実行します。指定しなかった段は `stage_role` による自動選択で決まります。`--plan` では reporter が scaffold 済みの result を記入するため、frontmatter に `task_id` を持つ plan が必要です。`--by` との併用はエラーです。`--by` に `stage_role` を持つ pipeline 用 agent を指定すると、result 未記入の blocked にはせず、`--executor-by` / `--reporter-by` を使うよう案内するエラーで実行前に拒否します。
|
|
467
511
|
|
|
468
512
|
指名した agent の rate limit は既定では `stop` です。`wait` は provider の reset / retry-after、次に `rate_limit_policy.cooldown_seconds` を使い、`rate_limit_policy.pinned.max_wait_seconds`(既定8時間)以内なら同じ段を同じ agent で再開します。`fallback` は対応する fallback flag または `rate_limit_policy.pinned.fallback_executor_by` / `fallback_reporter_by` の agent へ1回だけ切り替えます。fallback 未指定時と fallback agent も上限になった場合は停止します。CLI が `exec-defaults.yaml` より優先します。待機中は project の実行ロックを保持します。
|
|
469
513
|
|
|
514
|
+
`connection_error_detection` に一致する接続不能は `--on-rate-limit` の値とは独立して扱い、対応する fallback flag または設定上の fallback agent があれば1回だけ切り替えます。fallback 未指定時は通常の失敗として停止し、同じ agent の再開待ちは行いません。切替元・切替先・時刻・原因は rate limit の切替と同じ pipeline state、evidence、result の経路へ記録します。
|
|
515
|
+
|
|
470
516
|
agent の指定は repository 共通 roster nickname(`.specdojo/agent-members.yaml`)へ一本化します。手動ターゲット(`--task` / `--register` など)では `--by <nickname>`、`--auto` バッチでは mode 別に `--edit-by` / `--review-by` を使い、バッチ起動は `--auto` に一本化します。解決の優先順位は「単体指定(`--by`)> mode 別指定(`--edit-by` / `--review-by`)> 自動選択」です。
|
|
471
517
|
|
|
472
518
|
Schedule タスクの `agent_pipeline`(`sch-strategy-<track>.yaml` の phase 設定)と同じ executor/reporter 2段階(`stage_role: executor` が成果物を編集・検証し、`stage_role: reporter` が evidence から result を描画する)は、`--register` の既定の実行方式です。register 項目は Schedule のような per-item のパイプライン宣言を持たないため、owner・role からの agent 選択は行いません。`--executor-by <nickname>` と `--reporter-by <nickname>` を **両方セットで** 指定すると、その agent で実行します。`--by` と `--executor-by` / `--reporter-by` をいずれも指定しない場合は、`stage_role: executor`(`mode: edit` または `mode` 未指定)と `stage_role: reporter` の agent から `priority` 順に自動で選びます。`stage_role` を持たない agent(翻訳専用など)は自動選択の候補に入りません。どちらかの段に該当する agent がいない場合は、`--executor-by` / `--reporter-by` の指定を求めるエラーで実行前に止まります。複数項目では `--executor-by PJR-0001=exec-a,PJR-0002=exec-b` のような項目別指定も使用できます。項目別指定は選択した全項目を含む必要があり、対象外 ID と指定漏れは実行前にエラーになります。片方だけの指定もエラーになります。
|
|
@@ -506,6 +552,12 @@ specdojo exec run --project prj-0001 --register-filter --register-types todo --r
|
|
|
506
552
|
# 成果物を worktree に隔離して実行し、統合ブランチへ merge back する
|
|
507
553
|
specdojo exec run --project prj-0001 --register PJR-0012 --worktree
|
|
508
554
|
|
|
555
|
+
# app1 の統合先を、この run だけローカルの feature/login にする
|
|
556
|
+
specdojo exec run --project prj-0001 --register PJR-0012 --worktree --integration-branch app1=feature/login
|
|
557
|
+
|
|
558
|
+
# 統合後に読み取り専用 review を行い、完了した todo / issue を自動 close する
|
|
559
|
+
specdojo exec run --project prj-0001 --register PJR-0012 --worktree --post-review
|
|
560
|
+
|
|
509
561
|
# 保護設定で block された提案差分を表示し、確認後に統合先へ commit する
|
|
510
562
|
specdojo exec handoff apply --project prj-0001 --register PJR-0012
|
|
511
563
|
|
|
@@ -528,7 +580,11 @@ specdojo exec run --project prj-0001 --register PJR-0012 --worktree --resume --r
|
|
|
528
580
|
specdojo exec run --project prj-0001 --job job-weekly-report --input period=2026-W32
|
|
529
581
|
```
|
|
530
582
|
|
|
531
|
-
`--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`decision` / `note` は対象外です。実行場所の既定は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選び、未設定時は互換性のため in-place です。`--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。worktree モードは成果物の変更を隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--parallel <n>` は worktree モードでのみ指定できます。
|
|
583
|
+
`--register` は指定した個票の項目を実行します。`--register-filter` は `--register-types` / `--register-priorities` / `--register-statuses` のカンマ区切り条件と、正の整数の `--register-limit` で項目を選びます。条件省略時は open かつ実行可能な type が対象です。いずれも実行対象になる type は `todo` / `issue` / `change-request` / `question` / `risk` で、`decision` / `note` は対象外です。実行場所の既定は `.specdojo/exec-defaults.yaml` の `run.register_execution`(`worktree` / `in-place`)で選び、未設定時は互換性のため in-place です。`--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。worktree モードは成果物の変更を隔離し、状態遷移(`start` / `review` / `waiting`)を直列化したうえで、成功時に merge back します。`--post-review` または `run.register_post_review: true` を指定すると、merge back の後に完了判定を行い、todo / issue を自動 close できます。`--parallel <n>` は worktree モードでのみ指定できます。
|
|
584
|
+
|
|
585
|
+
`--integration-branch <repo>=<branch>` は、register の worktree モードで、その run に限ってプロダクトリポジトリ `<repo>` の統合先を上書きします。複数リポジトリにはオプションを繰り返します。`<repo>` は `repos[].name` に宣言済みで、`<branch>` はそのリポジトリに存在する有効なローカルブランチでなければならず、リモートブランチの取得やローカルブランチの作成は行いません。同じ `<repo>` の重複、宣言にないリポジトリ、空の値は register の状態を変える前に拒否します。統合先の優先順位は「run の指定 → `repos[].integration_branch` → そのリポジトリの現在のブランチ」です。指定しない run の挙動は従来と変わりません。
|
|
586
|
+
|
|
587
|
+
複数項目を `--parallel` で実行する場合、指定は選択された各 item run に同じように適用されます。中断した run を `--resume` するときは、開始時の指定を `pipeline-state.json` から再利用するため、オプションを繰り返す必要はありません。再開時に値を再指定する場合、その値は開始時の指定と一致する必要があり、run の途中で統合先を変更・追加する指定は拒否します。result の複数リポジトリ trace には、実際に使った統合先ブランチと統合後の commit snapshot が記録されます。
|
|
532
588
|
|
|
533
589
|
`exec handoff apply --register <PJR-ID>` は、worktree 実行が `agent-config-write` で waiting になった項目の最新 result から提案差分を読み、統合先へ適用して commit します。コマンドは差分を必ず表示し、対話では `y` / `yes`、非対話実行では `--yes` による明示確認がなければ何も変更しません。提案差分がない、切り詰められている、申し送りの対象パスと一致しない、保護対象外のパスを含む、統合先へ適用できない、対象パスに既存変更がある場合は commit 前に停止します。複数リポジトリでは `# repo: <name>` で区切られた差分を、宣言済みの各統合先へ限定 commit します。`package.json` を適用した場合は、依存定義を変更したか確認して対応する lock ファイルを再生成・commit し、その後に表示された `exec run --register ... --worktree --resume` を実行します。
|
|
534
590
|
|
|
@@ -577,7 +633,7 @@ specdojo exec trial adopt --project prj-0001 --comparison <comparison-id> --tria
|
|
|
577
633
|
|
|
578
634
|
`--agent`と任意の`--reporter-by`を使うと、reporterなしまたは全trial共通reporterの従来方式になります。`--pair <executor>=<reporter>...`は2組以上を指定し、executorとreporterを一組として比較します。`--pair`は`--agent` / `--reporter-by`と併用できません。比較記録の`reporter_mode`には`none` / `shared` / `paired`のいずれかを保存します。各reporterについて構造化出力の成否、形式試行回数、形式再試行回数、`evidence_blocked` / `invalid_output` / `invocation_failure` / `rate_limit`の失敗分類も保存します。`evidence_blocked` は reporter の申告ではなく、executor evidence から runner が機械判定した blocked を表します。
|
|
579
635
|
|
|
580
|
-
`pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
|
|
636
|
+
`pipeline.parent_validations`に指定できるIDは`validate-schema`、`typecheck`、`test-unit`、`test-integration`、`lint-ts`、`lint-fm`、`lint-md`、`build`、`format-check`です(各IDは組み込み許可リストの固定argvへ解決されます)。`pipeline.parent_validations`はtrialにも適用され、executor成功後・reporter起動前に各worktreeで実行されます。親検証結果は`source: runner`付きでevidenceへ保存し、失敗時はtrialを`failed`にします。比較記録と`trial status`はexecutor・親検証・全体の時間を分け、executorの検証報告総数と`passed` / `failed` / `not_run` / `requires_human`、親検証の状態と件数を別々に表示します。採用前に親検証の成功、executorの未実施・未報告、sandbox 外で人が行う確認を確認してください。
|
|
581
637
|
|
|
582
638
|
記録先は`execution_path/exec/trials/<comparison-id>/`です。agent選定への反映は自動化せず、人が複数比較を確認して `.specdojo/agent-members.yaml` を更新します。
|
|
583
639
|
|
|
@@ -899,6 +955,16 @@ provider CLI の実行中、起動元は `SIGINT` と `SIGQUIT` を無視して
|
|
|
899
955
|
|
|
900
956
|
Claude Code、Codex、Antigravity、GitHub Copilot には exec と同じ追加ルート引数を渡します。OpenCode は、起動時の `OPENCODE_CONFIG_CONTENT` に選択 agent の `permission.external_directory` を注入し、全外部ディレクトリを拒否したうえで宣言済みのリポジトリだけを許可します。外部パスへ既存の `permission.edit` が一致しないため、同じ宣言済みルートの編集許可も注入します。既存の inline config の他項目は保持します。未宣言のリポジトリは、どの provider でも許可対象になりません。
|
|
901
957
|
|
|
958
|
+
`orchestrator night` は `autopilot: approved` の付いた `open` todo・issue だけを夜間 queue として実行します。
|
|
959
|
+
|
|
960
|
+
```bash
|
|
961
|
+
specdojo orchestrator night --project prj-0001 \
|
|
962
|
+
--max-items 10 --parallel 2 --max-consecutive-failures 2 \
|
|
963
|
+
--on-rate-limit fallback --fallback-executor-by codex-executor
|
|
964
|
+
```
|
|
965
|
+
|
|
966
|
+
各 wave は worktree と post-review を必須にし、成功は close、未完了は `waiting` にします。`--max-items` は一晩の件数、`--parallel` は wave の同時数、`--max-consecutive-failures` は次の wave を止める閾値です。`--on-rate-limit fallback` では fallback executor の指定が必須です。失敗を含む朝報告を保存できた場合は部分成功を表す終了コード 2、コマンド自体の異常は 1 を返します。
|
|
967
|
+
|
|
902
968
|
## 16. devcontainer
|
|
903
969
|
|
|
904
970
|
`devcontainer` は、利用リポジトリの `.devcontainer/` 環境を構築するためのサブコマンドです。VS Code Dev Container などで、オーケストレーターを起動するための分離されたコンテナ環境を生成します。
|
|
@@ -907,25 +973,29 @@ Claude Code、Codex、Antigravity、GitHub Copilot には exec と同じ追加
|
|
|
907
973
|
| ----------------------- | ------------------------------------------- |
|
|
908
974
|
| `devcontainer scaffold` | `.devcontainer/` の設定ファイル群を生成する |
|
|
909
975
|
|
|
910
|
-
`devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。あわせて、常時稼働ホストへの接続と tmux セッション維持のためのサンプルスクリプト(`.devcontainer/remote-host/specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`.devcontainer/remote-host/ssh-config.sample`)も生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs`
|
|
976
|
+
`devcontainer scaffold` は、指定された provider の CLI と、要求された追加機能を組み込んだ `devcontainer.json` と `post-create.sh` を生成します。あわせて、常時稼働ホストへの接続と tmux セッション維持のためのサンプルスクリプト(`.devcontainer/remote-host/specdojo-tmux.sh.sample`)と接続元 SSH 設定サンプル(`.devcontainer/remote-host/ssh-config.sample`)も生成します。provider は `antigravity`、`claude`、`codex`、`opencode` を指定できます。`--editor emacs` / `--editor vim` を指定した場合は、それぞれ Emacs 用の `emacs/init.el` / Vim 用の `vim/vimrc` も生成します。Dev Container は任意の実行環境であり、既存の Node.js 環境を置き換える必須手順ではありません。
|
|
911
977
|
|
|
912
978
|
主要オプション:
|
|
913
979
|
|
|
914
|
-
| オプション | 用途
|
|
915
|
-
| ------------------------- |
|
|
916
|
-
| `--
|
|
917
|
-
| `--
|
|
918
|
-
| `--
|
|
919
|
-
| `--
|
|
920
|
-
| `--
|
|
921
|
-
| `--
|
|
922
|
-
| `--
|
|
923
|
-
| `--
|
|
980
|
+
| オプション | 用途 |
|
|
981
|
+
| ------------------------- | ------------------------------------------------------------ |
|
|
982
|
+
| `--preset recommended` | 推奨のエディタ・tmux・VS Code 拡張と設定をまとめて追加する。 |
|
|
983
|
+
| `--provider <names>` | `claude,codex` のようにカンマ区切りで provider を指定する。 |
|
|
984
|
+
| `--editor <names>` | `emacs,vim` のようにエディタと初期設定を追加する。 |
|
|
985
|
+
| `--ollama` | Ollama への接続設定(環境変数)を追加する。 |
|
|
986
|
+
| `--cron` | cron をインストールし、起動時にサービスを開始する。 |
|
|
987
|
+
| `--tmux` | tmux をインストールする。 |
|
|
988
|
+
| `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名を上書きする。 |
|
|
989
|
+
| `--force` | `.devcontainer/` が既に存在する場合に上書きする。 |
|
|
990
|
+
| `--dry-run` | 実際にファイルを作成せず、作成予定のファイルを表示する。 |
|
|
924
991
|
|
|
925
992
|
```bash
|
|
926
993
|
# claude と codex 用の CLI を含む Dev Container を生成する
|
|
927
994
|
npx specdojo devcontainer scaffold --provider claude,codex
|
|
928
995
|
|
|
996
|
+
# SpecDojo の文書作業向けの推奨設定をまとめて追加する
|
|
997
|
+
npx specdojo devcontainer scaffold --provider claude,codex --preset recommended
|
|
998
|
+
|
|
929
999
|
# 追加オプションを指定する
|
|
930
1000
|
npx specdojo devcontainer scaffold --provider claude --ollama --tmux
|
|
931
1001
|
|
|
@@ -970,6 +1040,10 @@ OpenCode の API key は `/home/node/.local/share/opencode/auth.json` に入り
|
|
|
970
1040
|
|
|
971
1041
|
post-create は `~/.emacs`、`~/.emacs.el`、`~/.emacs.d/init.el`、`~/.config/emacs/init.el` のいずれも無い場合だけ、生成したテンプレートを配置します。`~/.emacs.d` ディレクトリがあれば `~/.emacs.d/init.el` へ、なければ `~/.config/emacs/init.el` へコピーし、配置先を出力します。dotfiles が設定を先に配置した場合は上書きしません。初回のコンテナ作成前に既定値を変える場合は `.devcontainer/emacs/init.el` を編集してください。作成後は出力されたコピー先を編集します。コピー先を削除しない限り、再度 post-create を実行してもテンプレートの変更は反映されません。
|
|
972
1042
|
|
|
1043
|
+
`--preset recommended` は、`--editor emacs,vim --tmux` 相当のツールに加え、Git Graph、markdownlint、YAML、Prettier、remark、Markdown All in One、Code Spell Checker、EditorConfig、Error Lens、Even Better TOML の VS Code 拡張を追加します。選択した provider が Claude Code、Codex、GitHub Copilot の場合は、その provider の拡張だけも追加します。Markdown と YAML は保存時に Prettier で整形し、`docs/specdojo/schemas/v1/` の主要な schema を SpecDojo の YAML へ関連付けます。同じ拡張は `.vscode/extensions.json` の `recommendations` にも入り、既存の recommendation は保持されます。個別の `--editor`・`--tmux` と一緒に指定した場合は両方を重複なく適用します。
|
|
1044
|
+
|
|
1045
|
+
Vim の雛形は `.devcontainer/vim/vimrc` に生成され、`~/.vimrc` と `~/.vim/vimrc` のどちらも無い場合だけ `~/.vimrc` へコピーされます。既存の Vim 設定は上書きしません。Emacs の雛形も上記と同じ上書き防止を維持します。
|
|
1046
|
+
|
|
973
1047
|
## 17. 関連ガイド
|
|
974
1048
|
|
|
975
1049
|
| 詳細 | 参照先 |
|