| name | dev-flow |
| description | 开发组合拳总入口。根据输入形式（需求文档 / 原型项目 / 一句话）× 开发范围（前端 / 后端 / 全栈）
× 修饰符（带设计稿 / 数据库迁移 / 只联调 等）自动路由到正确的子 skill。同时覆盖 4 类非需求任务：
bugfix / 重构 / 性能优化 / 第三方接入。
Use when asked to "接需求", "开始开发", "/dev-flow", "组合拳", "dev flow", or whenever the user
hands over a development task and you need to decide which workflow skill to invoke.
Voice triggers: "接需求", "开始开发", "组合拳".
Note: 阶段切片型 skills（/dev-understand、/dev-implement、/dev-ship-retro）按阶段拆分，
与本路由按场景类型拆分的子 skill 互补；当用户明确说"只做某阶段"时优先匹配那些 skill。
|
| version | 0.1.0 |
| applies_to | ["all"] |
| priority | P1 |
| usage_frequency | weekly |
| depends_on | [] |
| related | ["dev-flow-oneliner-fe","dev-flow-oneliner-be","dev-flow-doc-fe","dev-flow-doc-be","dev-flow-doc-full","bugfix-flow","refactor-flow","perf-flow","third-party-flow"] |
dev-flow
本 skill 是开发组合拳的唯一入口路由器，自身不执行业务流程，只完成"问 → 写
dispatch-context.json → 指示主 agent 调用对应子 skill"。所有规范、卡点、文档模板
见单一事实源 _playbook.md。
适用场景
- 用户抛来一个开发任务，但你不确定该走哪个流程
- 用户口头说"接需求 / 开始开发 / 组合拳"
- 任务涉及前端、后端、全栈、bug 修复、重构、性能、第三方接入中的任意一项
前置条件
无强制前置；建议在进入路由前先确认：
~/Projects/_requirements/ 目录存在- 用户当前工作目录是项目根目录或可由
move_agent_to_root 切换
决策树（路由器视图）
flowchart TD
start[用户任务] --> intent{识别 intent}
intent -->|bug/500/崩溃| bugfix[bugfix-flow]
intent -->|重构/整理| refac[refactor-flow]
intent -->|性能/慢| perf[perf-flow]
intent -->|接入/SDK| tp[third-party-flow]
intent -->|新功能| feat{有 PRD?}
feat -->|有 PRD| docFlow{开发范围}
feat -->|没 PRD| oneliner{开发范围}
feat -->|有原型项目| protoFlow{开发范围}
docFlow -->|前端| docFE[dev-flow-doc-fe]
docFlow -->|后端| docBE[dev-flow-doc-be]
docFlow -->|全栈| docFull[dev-flow-doc-full]
oneliner -->|前端| oneFE[dev-flow-oneliner-fe]
oneliner -->|后端| oneBE[dev-flow-oneliner-be]
oneliner -->|全栈| oneFull[dev-flow-oneliner-full]
protoFlow -->|前端| protoFE[dev-flow-proto-fe]
protoFlow -->|后端| protoBE[dev-flow-proto-be]
protoFlow -->|全栈| devFull[dev-flow-full]
oneFE & oneBE & oneFull --> upgrade{触发升级?}
upgrade -->|DB schema / 鉴权 / 支付 / >8h| forceDoc[强制升级 dev-flow-doc-*]
upgrade -->|否| keep[保留一句话流程]
升级触发条件（任一命中即强制 oneliner → doc）：
| 信号 | 关键词 |
|---|
| DB schema | 数据库 / schema / 建表 / migration |
| 鉴权 / 多租户 | 鉴权 / 权限 / auth / 租户 |
| 支付 / 订单 / 钱包 | 支付 / 订单 / wallet |
| 估算 > 8h | "大改" / "跨多模块" |
注：本决策树即 harness_route_task 工具的核心逻辑；该工具会同时返回 efficiency_hints 帮你选完后立刻知道下一步该怎么省 token。
流程步骤
步骤 1 · 收集启动参数（A.1）
使用 AskQuestion 一次性收集（如用户消息已提供则对应项跳过）。
问题 1 · 任务类型
prompt: "准备开始。请帮我快速定位任务类型："
options:
- "新需求/新功能"
- "修 Bug"
- "重构/整理代码"
- "性能优化"
- "接入第三方服务"
若选了"新需求"，追问 2-1 输入形式
prompt: "PM/用户给你的输入是什么形式？"
options:
- "完整需求文档（PRD、飞书文档等）"
- "PM 给了一个可运行的参考/原型项目"
- "一句话模糊需求（比如'加个筛选'）"
若选了"新需求"，追问 2-2 范围
prompt: "本次需要开发的范围？"
options:
- "只前端"
- "只后端"
- "全栈（前后端都做）"
问题 3 · 修饰符（多选）
prompt: "是否满足以下任一条件？（可多选）"
options:
- "PM/设计师给了设计稿（Figma / 截图）"
- "有 UI 但没有设计稿"
- "这是一个全新项目（还没有代码仓库）"
- "涉及数据库迁移（新表 / 改表 / 删字段）"
- "只联调，不开发（两侧代码已存在，只需要把契约对起来）"
- "以上都不是"
allow_multiple: true
问题 4 · 需求名称
prompt: "给这次任务起个英文 kebab-case 名字（用于命名知识库目录）："
（自由输入；若用户跳过，由你根据任务摘要起，例：supplier-batch-approve）
步骤 2 · 决策表查找子 skill（A.2）
| 任务类型 | 输入形式 | 范围 | → 路由到子 skill | 代号 |
|---|
| 新需求 | 需求文档 | 前端 | /dev-flow-doc-fe | S1 |
| 新需求 | 需求文档 | 后端 | /dev-flow-doc-be | S2 |
| 新需求 | 需求文档 | 全栈 | /dev-flow-doc-full | S3 |
| 新需求 | 原型项目 | 前端 | /dev-flow-proto-fe | S4 |
| 新需求 | 原型项目 | 后端 | /dev-flow-proto-be | S5 |
| 新需求 | 原型项目 | 全栈 | /dev-flow-full（已存在） | S6 |
| 新需求 | 一句话 | 前端 | /dev-flow-oneliner-fe | S7 |
| 新需求 | 一句话 | 后端 | /dev-flow-oneliner-be | S8 |
| 新需求 | 一句话 | 全栈 | /dev-flow-oneliner-full | S9 |
| Bugfix | 任意 | 任意 | /bugfix-flow | X1 |
| 重构 | 任意 | 任意 | /refactor-flow | X2 |
| 性能优化 | 任意 | 任意 | /perf-flow | X3 |
| 第三方接入 | 任意 | 任意 | /third-party-flow | X4 |
修饰符 M1–M5 不替换路由，叠加传给子 skill：
| 多选项 | 修饰符 |
|---|
| 设计稿 | M1 |
| 有 UI 无设计稿 | M2 |
| 全新项目 | M3 |
| 数据库迁移 | M4 |
| 只联调 | M5 |
步骤 3 · 写 dispatch-context.json（A.4）
落盘到 ~/Projects/_requirements/[feature_name]/dispatch-context.json：
{
"scenario": "S3",
"child_skill": "/dev-flow-doc-full",
"modifiers": ["M1", "M4"],
"feature_name": "supplier-batch-approve",
"inputs": {
"prd_path": null,
"prototype_path": null,
"one_liner": null
},
"scope": "full-stack | frontend-only | backend-only | n/a",
"target_project": "C:/Users/Administrator/Projects/b-project"
}
如目录尚不存在，先 mkdir -p ~/Projects/_requirements/[feature_name]/。
步骤 4 · 把控制权交给子 skill
输出一段明确指示给主 agent，例如：
"已完成路由：场景 S3，子 skill 为 /dev-flow-doc-full，修饰符 M1+M4。参数已写入
~/Projects/_requirements/supplier-batch-approve/dispatch-context.json。请调用
/dev-flow-doc-full 接管后续流程，并在阶段 4 叠加 M4 的 MIGRATION_PLAN.md。"
到此父 skill 退出。
决策树（可视化）
flowchart TD
Start([任务到达]) --> A1[/dev-flow A.1 启动参数/]
A1 --> Q1{任务类型}
Q1 -->|新需求| Q2{输入形式}
Q1 -->|Bug| X1[[/bugfix-flow]]
Q1 -->|重构| X2[[/refactor-flow]]
Q1 -->|性能| X3[[/perf-flow]]
Q1 -->|第三方| X4[[/third-party-flow]]
Q2 -->|需求文档| Q3a{范围}
Q2 -->|原型项目| Q3b{范围}
Q2 -->|一句话| Q3c{范围}
Q3a -->|前端| S1[[/dev-flow-doc-fe]]
Q3a -->|后端| S2[[/dev-flow-doc-be]]
Q3a -->|全栈| S3[[/dev-flow-doc-full]]
Q3b -->|前端| S4[[/dev-flow-proto-fe]]
Q3b -->|后端| S5[[/dev-flow-proto-be]]
Q3b -->|全栈| S6[[/dev-flow-full]]
Q3c -->|前端| S7[[/dev-flow-oneliner-fe]]
Q3c -->|后端| S8[[/dev-flow-oneliner-be]]
Q3c -->|全栈| S9[[/dev-flow-oneliner-full]]
S1 & S2 & S3 & S4 & S5 & S7 & S8 & S9 --> MOD[[按 A.1 多选结果叠加 M1~M5]]
S6 --> MOD
错误处理
- 用户拒绝回答任意一个问题 → 不要假设，明确告知"无法路由，请补全信息"
feature_name 重名（目录已存在）→ 询问"继续在已有目录工作 / 改名 / 取消"- 路由表无匹配（不可能但兜底）→ 退化为
/dev-flow-doc-full，并在产出中标注"路由兜底"
产物清单
~/Projects/_requirements/[feature_name]/dispatch-context.json~/Projects/_requirements/[feature_name]/META.md（先建空骨架，子 skill 会补全）- 一段交给主 agent 的明确路由指示
支持的修饰符
不直接处理 M1–M5，仅记录到 dispatch-context.json 传给子 skill。详细 delta 见手册 Part D。
与其他 skill 的关系
- 路由后调用的 13 个子 skill：
/dev-flow-doc-fe、/dev-flow-doc-be、/dev-flow-doc-full、
/dev-flow-proto-fe、/dev-flow-proto-be、/dev-flow-full、/dev-flow-oneliner-fe、
/dev-flow-oneliner-be、/dev-flow-oneliner-full、/bugfix-flow、/refactor-flow、
/perf-flow、/third-party-flow
- 与"阶段切片型" skill 的关系：
/dev-understand、/dev-implement、/dev-ship-retro
按"阶段"切，本路由按"场景类型"切，互补；用户明确"只做某阶段"时优先匹配阶段切片型
附录
