第 7 章 · 复杂任务怎么选路线
本章目标:大任务执行前若出现 【多路径建议】,能读懂 契约优先 / 后端优先 / 前端优先 / 测试驱动 等标签;用 自然语言指定一条主线(无专用按钮);与 Ask、实施计划、影响面清单 配合,避免「东改西改」。
学时建议:2.5~3 小时(含 1 小时跟练)
前置:srx-v7 ch02(Ask);ch04(实施计划);ch05(影响面清单)。
只讲界面上怎么读、您怎么用文字指定,不讲内部如何生成建议。
7.1 场景说明:联调功能,AI 先改页面还是先改 API?
任务:「订单列表加按状态筛选,前后端都要动。」
执行输出出现:
【多路径建议】
- 契约优先:先定 API 字段
- 前端优先:先做下拉 UI
- 测试驱动:先写接口测试
若您不表态,SRX 可能按默认路线改——与您团队习惯不一致。没有「沿此路径执行」按钮,要靠 您用文字选一条。
7.2 学完你能
| 能力 | 验收 |
|---|---|
| 识别 | 找到【多路径建议】块 |
| 选型 | 按任务类型选一条主线 |
| 指定 | 用自然语言告诉 SRX 走哪条路 |
| 切换 | 中途改路线并说明原因 |
| 配合 | Ask 定方案 → SRX 执行 + 对照建议 |
| 边界 | 知简单任务不出现;不会同时跑多条线 |
7.3 这是什么
任务被判定为 较复杂 时,执行输出有时出现 只读 建议块:
【多路径建议】
列出 2~3 种 可行改法,请您选 一条作为本任务主线。
| 常见标签 | 适合什么情况 |
|---|---|
| 契约优先 | 先对齐接口、类型、路由、OpenAPI |
| 后端优先 | 先改服务端逻辑、数据库查询 |
| 前端优先 | 先改页面、组件、交互 |
| 测试驱动 | 先补/改测试,再实现功能 |
重要:
- 这是 建议,不是让您 同时 跑多条线
- 没有 专用面板或「沿此路径执行」按钮
- 简单小任务不会出现 —— 正常
7.4 跟练 A:读建议并文字指定(必做)
步骤 1 — 发前后端都可能涉及的叙述任务
(即使项目只有文档,也可用「设计叙述」练习)
【目标】设计「订单按状态筛选」功能:需 API query 参数 + 列表页下拉
【范围】本期只在 README 写设计(分后端/前端/契约三节),不改真实源码
【请】若出现多路径建议,我先选路线再执行
【验收】README 含 API 字段定义与 UI 行为说明
步骤 2 — 若出现【多路径建议】
阅读 2~3 条,例如:
- 契约优先:先写
?status=字段 - 后端优先:先写查询逻辑
- 前端优先:先做下拉
步骤 3 — 文字指定(复制改)
在输入框 跟进(AI 还在跑用 Enter 排队,要立刻纠正用 Ctrl+Enter,ch01):
按「契约优先」执行:先在 README 写清 API query 参数 status 的取值与响应 JSON,
再写前端如何调用;不要同时展开后端实现代码。
步骤 4 — 审阅
- 审阅条 ✓ 前看:README 结构是否符合所选路线
- 若 SRX 仍写了大量「后端实现」→ ✗ 拒绝,加强「本期仅设计文档」
你应该看到:输出结构与您指定的路线一致。
7.5 跟练 B:Ask → SRX → 对照多路径(必做)
步骤 1 — Ask(不改盘)
订单筛选功能,团队习惯先定 OpenAPI 再改 Go handler 和 Vue 页面。
应该选契约优先还是后端优先?只给建议,不要改文件。
步骤 2 — SRX 任务
【目标】(按 Ask 结论)契约优先:先更新 docs/api 说明 status 参数,再改 handler
【范围】@docs/api.md @handlers/order.go(示例路径按你项目改)
【不要】改前端目录
【验收】docs 与 handler 字段一致
步骤 3 — 若执行里仍有【多路径建议】
核对是否与您 Ask 结论 一致;不一致则 文字纠正(7.4 步骤 3)。