Skip to content
frontmatter
キー値
specdojo.idprj-0001:pjr-0162-exec-agent-flag-removal
specdojo.typeproject
specdojo.statusready
specdojo.rulebookspecdojo:pjr-rulebook
specdojo.part_ofprj-0001:pjr-index
specdojo.item_typetodo
specdojo.item_statusdone
specdojo.prioritymedium
specdojo.ownerARC
specdojo.completed_at2026-08-08T12:00:00Z
specdojo.conclusion旧agent指定フラグ(--cmd/--agent-cmd/--edit-agent/--review-agent)を物理撤去。exec run/resume/worktree agentをnickname(--by/--edit-by/--review-by/--auto)一本化。全878テスト成功を確認。

PJR-0162 旧agent指定フラグの撤去(--cmd/--agent-cmd/--edit-agent/--review-agent) ​

1. 概要 ​

PJR-0159で導入したdeprecated aliasを、deprecation期間(1〜2リリース)後に物理撤去する。exec run/resumeの--cmd/--agent-cmd/--edit-agent/--review-agent、exec worktree agentの--agent-cmd、生コマンド受理経路(resolveAgentOverrideのagentCmdOverride分岐・auto-agentフォールバック)、--cmdによるバッチ起動判定を除去し、worktree agentのcommand供給を--by nickname解決へ付け替える。関連テストとdocsを更新する。

PJR-0159 で agent 指定フラグを --by 系(--by / --edit-by / --review-by)+ --auto へ統一し、旧フラグ --cmd / --agent-cmd / --edit-agent / --review-agent(および exec worktree agent の --agent-cmd)は deprecated alias(動作維持+警告)として残した。本項目は、その deprecation 期間(1〜2 リリース)経過後に旧フラグと生コマンド受理経路を物理撤去する後続タスクである。

2. 完了条件 ​

  • exec run / exec resume から --cmd / --agent-cmd / --edit-agent / --review-agent を削除し、RunOpts の該当フィールドを除去している。
  • exec worktree agent から --agent-cmd を削除し、command 供給を --by nickname 解決(roster / exec-defaults)へ付け替えている。
  • 生コマンド受理経路(resolveAgentOverride の raw command 分岐、resolveInPlaceCommand / resolveRegisterCommand の auto-agent フォールバック)を除去し、agent 指定を nickname のみに限定している。
  • --cmd によるバッチ起動判定を除去し、バッチ起動は --auto のみに限定している。
  • normalizeAgentFlags から deprecated 処理を除去(または関数を撤去)している。
  • 旧フラグ・生コマンドに依存する既存テスト(exec-run-inplace / exec-run-resolve-command / exec-run-resolve-claiming-actor / exec-register / exec-run)を nickname 前提へ移行または削除している。
  • ドキュメント(command-reference の非推奨移行表、exec-operation-guide / exec-config-guide / exec-worktree-guide、sysd-*-agent-settings)から旧フラグ記述を除去・更新している。
  • npm run build / npm run lint:ts / npm run lint:md と関連テストが通る。

3. 作業内容 ​

No作業担当状態メモ
1exec run / exec resume の旧フラグ定義と RunOpts フィールドを削除ARCdone--cmd / --agent-cmd / --edit-agent / --review-agent
2生コマンド受理経路とバッチ起動判定を除去し nickname 一本化ARCdoneresolveAgentOverride ほか解決系
3exec worktree agent の command 供給を --by nickname 解決へ付け替えARCdone--agent-cmd 撤去
4旧フラグ・生コマンド依存テストの移行または削除ARCdone5 テストファイル
5ドキュメントから旧フラグ記述を除去・更新ARCdonecommand-reference / guides / sysd
6build / lint / テストによる検証ARCdonets/md/関連テスト

4. 対応結果 ​

  • exec run / exec resume / exec worktree agent から旧 agent 指定フラグを削除し、RunOpts と正規化処理も撤去した。
  • 単体指定を --by、mode 別指定を --edit-by / --review-by、バッチ起動を --auto に限定し、agent command は roster / exec-defaults の nickname 解決だけで取得するようにした。
  • in-place / register / claiming actor の raw command フォールバックを削除し、関連 unit・integration・E2E fixture を登録済み nickname 前提へ移行した。
  • command reference、exec guides、agent system design と package script を現行フラグへ更新した。
  • build、TypeScript / Markdown lint、関連テストを実施した。全体テストのうち Git subprocess を使わない 835 件は成功し、Git を spawn する 21 件は実行環境の制約(spawnSync git EPERM)で開始できなかった。

5. 関連ドキュメント ​