ps-exec

计划执行命令

此命令用于执行 /ps-plan 创建的计划文件。目标不是“自己写代码”，而是稳定编排执行、持续写回 task.md、完成全局验证和独立 review，再做收尾。

使用方法

/ps-exec [可选：计划文件路径]

示例：

/ps-exec docs/spec/20260311-1030-user-auth.md
/ps-exec

执行铁律

1. 优先续执：先检查 docs/spec/*.task.md，有 进行中 或 已暂停 的任务时，优先继续最近更新的那个。
2. 主 Agent 只负责编排与收口：主 Agent 负责选计划、建 worktree、维护 task.md、做全局验证、发起独立 review、处理 merge/PR/暂停。
3. project-spec:implement 只做局部验证：subAgent 只能验证与当前步骤改动直接相关的 lint、typecheck、测试，不做全量验证。
4. ps-exec 必做全局验证：所有步骤完成后，主 Agent 必须运行项目级完整验证链路。
5. 失败步骤阻断后续依赖：任一步骤失败或局部验证失败时，不得解锁依赖它的后续步骤；只能重试该步骤或暂停。
6. task.md 必须实时写回：步骤状态、全局验证记录、独立 Review 记录都要立即写回；不要批量补写。
7. 已完成 只能最后写：只有全局验证通过、独立 review 结束、并且收尾动作成功或用户明确选择“标记执行完成”后，才能把 task.md 写成 已完成。
8. 原地执行模式不做自动 Git 收尾：没有 worktree / branch 信息时，可以执行实现、验证、review，但不执行自动 merge 或自动创建 PR。
9. 后台任务必须全部等待完成：启动 run_in_background: true 的 subAgent 或 Bash 后，必须对每个 task_id 调用 TaskOutput(block: true) 等待返回，禁止在所有后台任务完成前结束当前 turn。

---

标准执行主路径

1. 续执检查与计划定位

1. 搜索 docs/spec/*.task.md
2. 读取 frontmatter 中的 status、updated
3. 如果有 进行中 或 已暂停 的任务：
   • 选择最近更新的 task.md
   • 直接进入“第 4 步：批次执行步骤”
4. 如果没有未完成 task.md：
   • 如果用户传入了计划路径，直接使用
   • 否则搜索 docs/spec/*.md，并排除 *.task.md
   • 如果找到多个未开始的计划文件，使用 AskUserQuestion 让用户选择
   • 如果一个也没有，提示用户先运行 /ps-plan

2. 确定执行目录

目标：优先在隔离 worktree 中执行；无法使用 Git 时，允许降级到原地执行模式。

2.1 已有 worktree 的续执

• 如果续执的 task.md frontmatter 里已有 worktree，直接复用该 worktree
• 如果 worktree 为空，说明之前就是原地执行模式，本次继续在当前项目目录执行

2.2 新任务的 worktree 判定

1. 运行：

git rev-parse --is-inside-work-tree

1. 如果 Git 可用：
   • 记录当前分支：

git branch --show-current

• 用 git rev-parse --show-toplevel 获取项目根目录
• 分支名：feature/<计划文件名去掉 .md>
• worktree 路径：<项目根目录同级>/<项目目录名>-<计划文件名去掉 .md>
• 创建 worktree：

git worktree add "<WORKTREE_PATH>" -b "<BRANCH_NAME>"

• 如果分支已存在，重试：

git worktree add "<WORKTREE_PATH>" "<BRANCH_NAME>"

• 创建后运行：

git worktree list