1
┌─────────────────────────────────────────────────────────────┐
2
│              Phase 1: 规划（OpenSpec 主导）                  │
3
│                                                             │
4
│  /opsx:explore        ← 需求模糊时先探索                     │
5
│       ↓                                                     │
6
│  /opsx:propose        ← 生成 proposal + specs + design + tasks│
7
│       ↓                                                     │
8
│  人工审核工件           ← 确认意图、范围、验收条件            │
9
└─────────────────────────────────────────────────────────────┘
10
                          ↓
11
┌─────────────────────────────────────────────────────────────┐
12
│              Phase 2: 执行（Superpowers 主导）               │
13
│                                                             │
14
│  git worktree 隔离    ← using-git-worktrees                 │
15
│       ↓                                                     │
16
│  brainstorming        ← 对每个 task 做需求对齐               │
17
│       ↓                                                     │
18
│  TDD 实现             ← 先写失败测试 → 写实现 → 重构          │
19
│       ↓                                                     │
20
│  验证                  ← verification-before-completion      │
21
│       ↓                                                     │
22
│  代码审查              ← requesting-code-review              │
23
└─────────────────────────────────────────────────────────────┘
24
                          ↓
25
┌─────────────────────────────────────────────────────────────┐
26
│              Phase 3: 收尾（两者协同）                       │
27
│                                                             │
28
│  /opsx:verify         ← 检查实现是否匹配 Spec                │
29
│       ↓                                                     │
30
│  finishing-a-branch   ← 测试通过 → merge/PR/keep/discard     │
31
│       ↓                                                     │
32
│  /opsx:archive        ← 归档 + 合并规范                      │
33
└─────────────────────────────────────────────────────────────┘

1
# proposal.md 要点
2
- 目标：订单导出 CSV 接口
3
- 范围内：CSV 生成、权限校验、数量限制、时间范围校验
4
- 范围外：异步导出、邮件通知、Excel 格式
5

6
# specs/ 关键场景
7
Given 用户是 tenant-A 的管理员
8
When  请求导出 tenant-A 在 2024-01-01 到 2024-01-31 的订单
9
Then  返回 CSV，字段为 order_no, amount, status, created_at
10

11
Given 用户尝试导出 tenant-B 的数据
12
When  请求导出
13
Then  返回 403，错误信息为 "无权访问该租户数据"
14

15
# tasks.md 清单
16
1.1 创建 OrderExportController
17
1.2 实现 OrderExportService（查询 + CSV 生成）
18
1.3 添加权限校验（只能导出当前租户）
19
1.4 添加数量限制（≤5000 条）
20
1.5 添加时间范围校验（≤31 天）
21
1.6 编写单元测试（覆盖 4 种边界场景）

1
🧠 brainstorming：对 task 1.1 做需求对齐
2
   → 确认 Controller 路径、请求参数格式、返回体结构
3

4
🌿 git worktree：创建隔离工作区
5
   → git worktree add ../project-order-export -b feat/order-export
6

7
🔴 TDD：先写失败测试
8
   → test: 导出正常路径返回 CSV
9
   → test: 超过 5000 条返回 400
10
   → test: 越权租户返回 403
11
   → test: 时间范围超限返回 400
12

13
🟢 实现：让测试通过
14
   → 实现 Controller、Service、权限校验
15

16
🔵 验证：verification-before-completion
17
   → 贴出 mvn test 输出
18
   → 贴出 git diff --stat
19

20
🔍 代码审查：requesting-code-review
21
   → 子代理检查权限绕过风险、SQL 注入、边界条件