development-process

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