---
name: dev-task-flow
description: 当用户要求开发功能、实现接口、完善模块时使用。按固定流程执行：需求梳理与技术文档、编码与检查、自测与自测报告检查、开发报告输出。
---

# Dev Task Flow（开发任务流程）

## Activation
- 用户要求开发/实现/完善功能或接口时应用本技能（含自 GeeLib 转入的开发段）。
- **命中词（任一）**：开发功能 / 实现接口 / 修 bug / 完善模块 / 新增接口 / 重构模块。
- **排除词（任一）**：提交代码（且无开发诉求）/ 仅自测（且无开发诉求）。
- **冲突降级**：若同条消息含 GeeLib 任务闭环语义，入口由 `workflow-hub` 先分配到 `workflow-hub`（GeeLib 闭环段），本技能作为开发子段执行。
- 激活后可在内部回执使用标记：`[SKILL:dev-task-flow]`，**不要求对用户输出首行强制标记**。

## 门禁
- **顺序执行，失败即停**：前一阶段未 PASS，不得进入下一阶段。
- **完成态闸门**：仅当「需求梳理 + 代码实现 + 编译检查」完成，方可声明实现完成；若任务或用户明确要求文档，再将文档纳入强制项。
- **自测闸门**：若未完整执行 `self-test-flow`（仅写自测文档、仅编译、或仅口头说明均不算），阶段 3 必须标记 `FAIL`，且不得进入阶段 4「开发报告」的完成结论。
- **GeeLib 联动闸门**：当任务来自 GeeLib 且含代码改动时，未通过阶段 3 自测不得回写 GeeLib 为「已完成/关闭」，除非用户明确要求跳过，并记录风险。
- **不破坏 git**；不改无关文件；不提交敏感文件。
- **Query/List/POST/上报模板、Request 基类、路由注册**：见 **reference.md**，编码不得跳步。

## 阶段（顺序执行）

| 阶段 | 内容 | 通过条件 |
|------|------|----------|
| 1 | 需求梳理（按需补设计/接口文档） | 需求边界、输入输出、验收口径已对齐并 `PASS`；若用户/任务要求文档则给出路径 |
| 2 | 编码与静态检查 | 符合模板；`go build` 等编译通过；注解注册已核对 |
| 3 | 联调自测 | 按 **self-test-flow** 的 `SKILL.md` + `reference.md` 执行并有关键步骤 PASS |
| 4 | 开发报告 | 含方案摘要、接口清单、自测结论、风险与待办 |

## 调度位置
- 与 **workflow-hub**、**self-test-flow**、**deploy-test-env** 的全局顺序：`packages/agent/skills-runtime/workflow-hub/SKILL.md`。

## 执行回执（每次进入本技能都要输出）
- `已命中技能`：dev-task-flow
- `命中关键词`：列出触发词
- `已加载文档`：`packages/agent/skills-runtime/dev-task-flow/SKILL.md`、`packages/agent/skills-runtime/dev-task-flow/reference.md`
- `联动技能`：若阶段 3 启动，补充 `packages/agent/skills-runtime/self-test-flow/SKILL.md` 与 `reference.md`
- `阶段状态`：阶段 1/2/3/4 的已完成、进行中、待执行

## 延伸阅读
- **Hard Rules 全文、Preflight 清单、Query/POST/上报代码模板、Output Contract**：同目录 **`reference.md`**。
