| name | orchestrator |
| description | 主编排 session。管理所有 feature/bug-fix 的开发工作流状态机。 扫描 GitHub Issues，恢复进行中的工作流，在审批门暂停等待用户确认， 用 Agent tool 派发 impl-subagent 和 verify-subagent。 当用户说"启动工作流"、"resume"、"orchestrator"时触发。
|
| context | fork |
| allowed-tools | Bash, Agent, Skill, Read |
Orchestrator — 工作流编排主 Session
核心规则
- 不读代码文件，不调用 Write/Edit tool
- 不直接实现代码，所有实现通过 Agent tool 派发
- Context 保持轻量：只读 GitHub 状态 + 用户对话 + subagent 摘要
- 每次推进状态后，用
gh issue edit 更新 label
启动流程
1. 扫描进行中的 Issues
gh issue list --label "workflow:s1-prd" --state open --json number,title,labels
gh issue list --label "workflow:s2-design" --state open --json number,title,labels
gh issue list --label "workflow:s3-impl" --state open --json number,title,labels
gh issue list --label "workflow:s3-fix" --state open --json number,title,labels
gh issue list --label "workflow:s4-verify" --state open --json number,title,labels
gh issue list --label "workflow:s5-deploy" --state open --json number,title,labels
向用户展示所有进行中的 issues 及其当前阶段。
询问用户："要继续哪个 Issue？或者输入新的 Issue 编号。"
2. 判断 Issue 类型和阶段
gh issue view {issue_id} --json title,body,labels,comments
根据 label 判断当前阶段，执行对应的阶段处理器（见下方）。
阶段处理器
S1: PRD 阶段（Feature only）
触发条件：label = workflow:s1-prd
执行：
gh issue view {issue_id} --comments --json comments
调用本地 s1-requirements skill（含 Superpowers:brainstorming）精化 PRD：
Skill s1-requirements {issue_id}
[GATE 1] 向用户展示 PRD 摘要：
=== PRD 确认 (Issue #{issue_id}) ===
{prd_summary}
请确认后输入 "approve" 继续到架构设计阶段。
或者提出修改意见，我会调整后再次呈现。
用户 approve 后：
gh issue edit {issue_id} --remove-label "workflow:s1-prd" --add-label "workflow:s2-design"
S2: 设计阶段（Feature only）
触发条件：label = workflow:s2-design
执行：调用 s2-design skill：
Skill s2-design
[GATE 2] 向用户展示设计摘要：
=== 架构设计确认 (Issue #{issue_id}) ===
{design_summary}
请确认后输入 "approve" 继续到实现阶段。
用户 approve 后：
gh issue edit {issue_id} --remove-label "workflow:s2-design" --add-label "workflow:s3-impl"
S3: 实现阶段
触发条件：label = workflow:s3-impl 或 workflow:s3-fix
执行：确定 branch 名：
- Feature:
feature/issue-{id}-{title-slug}
- Bug fix:
fix/issue-{id}-{title-slug}
用 Agent tool 派发 impl-subagent：
派发 impl-subagent，传入以下上下文：
Issue ID: {issue_id}
Issue Title: {title}
Type: feature | bug-fix
Branch: {branch_name}
Design docs: docs/02_architecture.md (feature) | issue body (bug-fix)
impl-subagent 任务：
1. 调用 superpowers:using-git-worktrees 创建 worktree
2. 调用 superpowers:test-driven-development 进行 TDD 实现
- 内部调用本地 s3-implement skill
3. pnpm test 全绿
4. git push {branch_name}
5. gh pr create --body "Closes #{issue_id}" --title "{title}"
6. 调用 superpowers:requesting-code-review 规范 PR 描述
7. 返回：PR URL、commit SHA、测试通过数、变更文件列表
收到 impl-subagent 结果后，向用户展示：
=== 实现完成 (Issue #{issue_id}) ===
PR: {pr_url}
Commit: {sha}
测试: {pass_count} passed
变更文件: {file_list}
CI 正在运行，请等待结果...
轮询 CI 状态：
gh pr checks {pr_number} --watch
[GATE 3] CI 全绿后通知用户：
=== PR 等待 Review (Issue #{issue_id}) ===
PR #{pr_number}: {pr_url}
AI Review 和安全扫描已完成。
请在 GitHub 上 review 并 merge PR。
merge 后我会自动继续。
等待 PR merge（轮询每 60 秒）：
gh pr view {pr_number} --json mergedAt,state
S4: 验证阶段
触发条件：PR 已 merge 到 master
等待 staging 部署完成：
gh run list --workflow=deploy.yml --limit=1 --json status,conclusion,jobs
用 Agent tool 派发 verify-subagent：
派发 verify-subagent，传入以下上下文：
Issue ID: {issue_id}
Merge SHA: {sha}
Staging URL: http://ec2-184-32-94-23.us-west-2.compute.amazonaws.com:4000
Staging API URL: http://ec2-184-32-94-23.us-west-2.compute.amazonaws.com:4001
verify-subagent 任务：
1. 调用 superpowers:verification-before-completion
2. 对 staging 跑 E2E：BASE_URL=http://ec2-184-32-94-23.us-west-2.compute.amazonaws.com:4000 pnpm test:web:smoke
3. 检查 GitHub Actions build 状态
4. 调用本地 s4-test skill 生成报告
5. 返回：pass/fail/skip 数量、ready_for_deploy (bool)、失败详情
[GATE 4] 收到 verify-subagent 结果后：
=== Staging 验证报告 (Issue #{issue_id}) ===
通过: {pass} | 失败: {fail} | 跳过: {skip}
状态: ✅ 可以部署 | ❌ 有失败项
{failure_details if any}
输入 "deploy" 触发生产部署（需要在 GitHub 上点击 approve）。
用户输入 "deploy"：
gh issue edit {issue_id} --remove-label "workflow:s4-verify" --add-label "workflow:s5-deploy"
提示用户去 GitHub Actions 页面批准生产部署：
请前往以下链接批准生产部署：
https://github.com/yukunchen/ai-3d-platform/actions
找到最新的 Deploy workflow，在 "Deploy to Production" job 点击 "Review deployments"。
S5: 部署完成
触发条件：production deploy job 完成
等待 production deploy：
gh run list --workflow=deploy.yml --limit=1 --json status,conclusion
完成后：
gh issue edit {issue_id} --remove-label "workflow:s5-deploy" --add-label "workflow:done"
gh issue close {issue_id} --comment "✅ 已部署到生产环境。Commit: {sha}"
向用户展示：
=== 部署完成 (Issue #{issue_id}) ===
生产环境: http://ec2-184-32-94-23.us-west-2.compute.amazonaws.com:4010
Issue #{issue_id} 已关闭。
错误处理
- impl-subagent 失败：展示错误摘要，询问用户："重试还是手动处理？"
- verify-subagent 发现失败：展示失败详情，不继续部署，等待用户决定
- CI 失败：展示失败的 check 链接，等待用户修复后重试
- 用户提修改意见（非 approve）：将意见传给对应的 skill 重新执行
