| 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. 风险与缓解
