| name | development-process |
| description | 新建系统或模块的研发全流程:需求文档、功能清单、架构设计、竞品分析、迭代开发、自治批处理模式。适用于新建项目、需求整理、架构设计、功能拆分、任务分解、批量开发、自治模式等任务。包含标准文档模板。 |
| argument-hint | 说明当前阶段(需求整理/架构设计/迭代开发/自治模式)、项目规模、是否有竞品分析需求。 |
研发全流程
把系统做成什么样——需求文档回答;怎么实现——架构文档回答。
基础约定(文档命名、反模式)参见 development.instructions.md。
适用于新建应用系统、新增功能模块、需求整理、架构设计等研发全流程任务。
0. 功能模块编码方案
采用 字母前缀 + 数字后缀 的编码体系。
0.1 格式
{MOD}-{N}[{letter}]
| 段 | 含义 | 示例 | 说明 |
|---|
MOD | 模块字母缩写 | SYS, NET | 2~4 个大写字母,必须具有助记性 |
N | 模块内功能序号 | 1, 2 | 从 1 开始 |
letter | 子功能标识(可选) | a, b | 功能粒度不够时用小写字母细分 |
0.2 示例
SYS-1 — 系统基础-部署与守护
SYS-1a — 系统基础-部署与守护-StarAgent 守护配置
NET-3 — 网络接入-DHCP 服务
0.3 存量兼容
- 已有 Mx- 编码的项目:存量模块保留 M1/M2/M3,新增模块可用新编码
- 两种方案可在同一文档混用
- 新项目默认使用字母前缀方案
0.4 常见编码映射
| 模块 | 推荐编码 | 说明 |
|---|
| 系统基础 | SYS | System |
| 认证权限 | AUTH | Authentication |
| 网络接入 | NET | Network |
| 安全管控 | SEC | Security |
| 终端管理 | DEV | Device |
| 数据统计 | STAT | Statistics |
| 系统运维 | OPS | Operations |
1. 核心理念
一句话愿景 → 需求文档(WHAT)→ 功能清单(追踪+任务管理)→ 架构文档(HOW)→ 迭代开发 → 测试
- 需求文档 = WHAT:定义系统长什么样、有哪些模块、每个模块做什么
- 架构文档 = HOW:定义每个模块怎么实现
- 功能清单独立维护:完成状态在
功能清单.md 追踪
- 竞品分析 = WHY NOT:竞品分析是需求的第二来源
- 大需求必须拆小:功能点 > 5 / 实体 > 3 / 跨 2 层以上 → 先拆分再开发
2. 各阶段规范
2.1 需求整理(WHAT)
输出 Doc/需求文档.md,包含:背景与愿景 → 核心目标 → 功能需求 → 暂缓清单 → 不做什么。
2.2 拆分检查点(强制)
从需求文档生成功能清单前,必须对每个需求项执行拆分检查:
- 前后端拆分(涉及界面则拆)
- 平台拆分(跨平台实现不同则拆)
- 粒度上限(单个功能 ≤ 3 天工作量)
2.3 竞品分析
输出 Doc/竞品分析.md。详见 competitive-analysis skill。
2.4 架构设计(HOW)
输出 Doc/架构设计.md,包含分层架构、核心流程、关键决策、技术选型。
2.5 功能清单
输出 Doc/功能清单.md,三维状态追踪:实现/测试/注释。
2.6 迭代开发
按功能清单逐项实现。详见 development.instructions.md 和 dev-loop agent。
2.7 验收
对照需求文档逐条验收,更新功能清单状态。
3. 文档模板
需求文档结构
# {项目名}需求文档
## 1. 背景与愿景
## 2. 核心目标
## 3. 功能需求(按模块分组)
## N. 暂缓清单
## N+1. 不做什么
架构设计结构
# {项目名}架构设计
## 1. 分层架构
## 2. 核心流程(Mermaid 图)
## 3. 接口设计
## 4. 技术选型
## 5. 关键设计决策
## 6. 风险与缓解