adspecs 0.1.36 → 0.1.37
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.adspecs/templates/01-/344/270/232/345/212/241/351/234/200/346/261/202/345/210/206/346/236/220/346/250/241/346/235/277.md +50 -21
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codebuddy-plugin/plugin.json +1 -1
- package/.qoder-plugin/plugin.json +1 -1
- package/.workbuddy-plugin/plugin.json +1 -1
- package/package.json +1 -1
- package/skills/adspecs-biz-blueprint/SKILL.md +8 -7
- package/skills/adspecs-new-requirement/SKILL.md +58 -31
|
@@ -1,17 +1,18 @@
|
|
|
1
1
|
# 01-业务需求分析(BRD)
|
|
2
2
|
|
|
3
|
-
> **版本**: v2.
|
|
3
|
+
> **版本**: v2.1
|
|
4
4
|
> **创建日期**: 2026-03-16
|
|
5
|
-
> **修订日期**: 2026-07-04(结构重构:引入六步需求分析法,从"填表式 BRD"升级为"分析驱动型 BRD";模拟需求评审移至 adspecs-new-requirement skill 执行)
|
|
5
|
+
> **修订日期**: 2026-09-03(新增"五、业务对象说明"章节:业务对象分类盘点,原五~六章顺延); 2026-07-04(结构重构:引入六步需求分析法,从"填表式 BRD"升级为"分析驱动型 BRD";模拟需求评审移至 adspecs-new-requirement skill 执行)
|
|
6
6
|
> **适用人员**: 产品经理、需求分析师、业务方
|
|
7
7
|
> **目的**: 在写 PRD 之前,先完成深度需求分析——搞清楚真正的问题是什么、为谁解决、怎么解决、有哪些风险。
|
|
8
8
|
---
|
|
9
9
|
## 更变记录
|
|
10
10
|
|
|
11
|
-
| 版本 | 日期 | 说明
|
|
12
|
-
| ---- | ---------- |
|
|
13
|
-
| v2.
|
|
14
|
-
|
|
|
11
|
+
| 版本 | 日期 | 说明 |
|
|
12
|
+
| ---- | ---------- | ---------------------------------------------------------------------------------------------------------------- |
|
|
13
|
+
| v2.1 | 2026-09-03 | 新增"五、业务对象说明"章节:仅按单据类/主数据/枚举类分类列出对象名称与简述,不展开属性;原五、六章顺延为六、七章 |
|
|
14
|
+
| v2.0 | 2026-07-04 | 结构重构:引入六步需求分析法;模拟需求评审移至 adspecs-new-requirement skill |
|
|
15
|
+
| v1.0 | 2026-03-16 | 首版填写 |
|
|
15
16
|
|
|
16
17
|
---
|
|
17
18
|
## 模块信息
|
|
@@ -151,11 +152,38 @@
|
|
|
151
152
|
|
|
152
153
|
---
|
|
153
154
|
|
|
154
|
-
##
|
|
155
|
+
## 五、业务对象说明
|
|
156
|
+
|
|
157
|
+
> 本需求涉及哪些业务对象?仅列出对象名称和一句话简述,**不列出具体属性**(对象属性、OBJ 编号与对象间关联关系在 `02`-产品需求说明书第 5 部分定义)。先做分类盘点,为业务流程描述提供统一的对象口径。
|
|
158
|
+
|
|
159
|
+
### 5.1 对象分类
|
|
160
|
+
|
|
161
|
+
| 对象类型 | 判定特征 | 示例 |
|
|
162
|
+
| ---------- | ---------------------------------------------- | ---------------------- |
|
|
163
|
+
| 单据类对象 | 伴随业务事件产生、有生命周期状态流转的业务单据 | 如:入库单、付款申请单 |
|
|
164
|
+
| 主数据对象 | 相对稳定、被多个单据/流程引用的基础资料 | 如:客户、物料、供应商 |
|
|
165
|
+
| 枚举类对象 | 取值范围固定的分类/状态标识 | 如:单据状态、单据类型 |
|
|
166
|
+
|
|
167
|
+
### 5.2 业务对象清单
|
|
168
|
+
|
|
169
|
+
> 按实际涉及的对象增删行。一个枚举类对象对应一类取值集合(如"单据状态"),具体取值项放 `02` 中定义。
|
|
170
|
+
|
|
171
|
+
| 编号 | 对象名称 | 对象类型 | 简述 |
|
|
172
|
+
| ------ | ------------ | ---------- | ---------------------------------------- |
|
|
173
|
+
| OBJ-01 | 【对象名称】 | 单据类对象 | 【该对象代表什么业务事件、大致状态流转】 |
|
|
174
|
+
| OBJ-02 | 【对象名称】 | 单据类对象 | 【一句话简述】 |
|
|
175
|
+
| OBJ-03 | 【对象名称】 | 主数据对象 | 【一句话简述】 |
|
|
176
|
+
| OBJ-04 | 【对象名称】 | 主数据对象 | 【一句话简述】 |
|
|
177
|
+
| OBJ-05 | 【对象名称】 | 枚举类对象 | 【一句话简述】 |
|
|
178
|
+
| OBJ-06 | 【对象名称】 | 枚举类对象 | 【一句话简述】 |
|
|
179
|
+
|
|
180
|
+
---
|
|
181
|
+
|
|
182
|
+
## 六、异常和边界场景
|
|
155
183
|
|
|
156
184
|
> 从多个角度穷举可能遗漏的异常场景。不要只考虑"正常操作"。
|
|
157
185
|
|
|
158
|
-
###
|
|
186
|
+
### 6.1 异常场景清单
|
|
159
187
|
|
|
160
188
|
| 编号 | 类别 | 异常场景 | 触发条件 | 预期系统行为 | 影响范围 |
|
|
161
189
|
| ----- | -------- | ---------------------------- | ------------ | ----------------- | ---------------- |
|
|
@@ -168,7 +196,7 @@
|
|
|
168
196
|
| EX-07 | 历史数据 | 【如:旧数据不兼容新规则】 | 【触发条件】 | 【迁移/兼容方案】 | 【影响】 |
|
|
169
197
|
| EX-08 | 后台处理 | 【如:异步任务超时/失败】 | 【触发条件】 | 【重试/告警策略】 | 【影响】 |
|
|
170
198
|
|
|
171
|
-
###
|
|
199
|
+
### 6.2 边界值检查
|
|
172
200
|
|
|
173
201
|
> 列出关键输入字段的边界值。
|
|
174
202
|
|
|
@@ -179,11 +207,11 @@
|
|
|
179
207
|
|
|
180
208
|
---
|
|
181
209
|
|
|
182
|
-
##
|
|
210
|
+
## 七、最终输出与决策
|
|
183
211
|
|
|
184
212
|
> 基于以上分析,给出需求成熟度判断和下一步建议。
|
|
185
213
|
|
|
186
|
-
###
|
|
214
|
+
### 7.1 需求成熟度评估
|
|
187
215
|
|
|
188
216
|
| 评估维度 | 状态 | 说明 |
|
|
189
217
|
| ------------ | ----- | ---------------------------- |
|
|
@@ -193,7 +221,7 @@
|
|
|
193
221
|
| 流程无歧义 | ✅/⚠️/❌ | 【主流程和状态机是否已梳理】 |
|
|
194
222
|
| 异常已考虑 | ✅/⚠️/❌ | 【边界和异常场景是否已覆盖】 |
|
|
195
223
|
|
|
196
|
-
###
|
|
224
|
+
### 7.2 风险与待补充
|
|
197
225
|
|
|
198
226
|
| 最大风险 | 影响 | 应对 |
|
|
199
227
|
| ---------- | -------- | ------------ |
|
|
@@ -204,7 +232,7 @@
|
|
|
204
232
|
- 【待补充项 1】
|
|
205
233
|
- 【待补充项 2】
|
|
206
234
|
|
|
207
|
-
###
|
|
235
|
+
### 7.3 决策
|
|
208
236
|
|
|
209
237
|
- [ ] ✅ 需求清晰,建议进入 `02`-产品需求说明书(PRD)阶段
|
|
210
238
|
- [ ] ⚠️ 需求基本清晰,补充 【X】 项后可进入 PRD 阶段
|
|
@@ -216,13 +244,14 @@
|
|
|
216
244
|
|
|
217
245
|
> **01 做深度需求分析,02 做产品设计和用户故事。** 本文的分析结果将直接作为 `02` 的输入。
|
|
218
246
|
|
|
219
|
-
| 本文(BRD 分析) | 作用
|
|
220
|
-
| ------------------ |
|
|
221
|
-
| 一、真实问题分析 | 锁定问题域,避免做错方向
|
|
222
|
-
| 二、用户角色分析 | 明确为谁做、权限边界
|
|
223
|
-
| 三、使用场景拆解 | 确定功能优先级
|
|
224
|
-
| 四、业务流程梳理 | 定义操作动线和状态机
|
|
225
|
-
|
|
|
226
|
-
|
|
|
247
|
+
| 本文(BRD 分析) | 作用 | 02 中落地 |
|
|
248
|
+
| ------------------ | -------------------------------------- | ------------------------------------------------ |
|
|
249
|
+
| 一、真实问题分析 | 锁定问题域,避免做错方向 | → 02 §1 背景与目标 |
|
|
250
|
+
| 二、用户角色分析 | 明确为谁做、权限边界 | → 02 §2 目标用户 + 权限设计 |
|
|
251
|
+
| 三、使用场景拆解 | 确定功能优先级 | → 02 §3 功能清单 + 用户故事 |
|
|
252
|
+
| 四、业务流程梳理 | 定义操作动线和状态机 | → 02 §4 详细设计 + 交互流程 |
|
|
253
|
+
| 五、业务对象说明 | 厘清对象类型与口径,衔接流程与数据建模 | → 02 第5部分 业务对象说明(OBJ 编号 + 属性展开) |
|
|
254
|
+
| 六、异常和边界场景 | 预防遗漏和线上事故 | → 02 §5 产品规则 + 异常处理 |
|
|
255
|
+
| 七、最终输出与决策 | 判断是否具备进入 PRD 的条件 | → 02 启动的前置检查 |
|
|
227
256
|
|
|
228
257
|
---
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "adspecs",
|
|
3
3
|
"displayName": "adspecs AI 工程规范驱动开发插件",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.37",
|
|
5
5
|
"description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
|
|
6
6
|
"descriptionZh": "AI优先的工程规范驱动开发插件,覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
|
|
7
7
|
"author": {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "adspecs",
|
|
3
3
|
"displayName": "adspecs AI 工程规范驱动开发插件",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.37",
|
|
5
5
|
"description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
|
|
6
6
|
"descriptionZh": "AI优先的工程规范驱动开发插件,覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
|
|
7
7
|
"author": {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "adspecs",
|
|
3
3
|
"displayName": "adspecs AI 工程规范驱动开发插件",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.37",
|
|
5
5
|
"description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
|
|
6
6
|
"descriptionZh": "AI优先的工程规范驱动开发插件,覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
|
|
7
7
|
"author": {
|
package/package.json
CHANGED
|
@@ -155,8 +155,9 @@ $ARGUMENTS
|
|
|
155
155
|
| 用户角色分析 | 二 | → F6 业务角色与权限 |
|
|
156
156
|
| 使用场景拆解 | 三 | → F2 流程架构 + F3 流程详述 |
|
|
157
157
|
| 业务流程梳理 | 四 | → F1/F3/F3附录/F4/F5 |
|
|
158
|
-
|
|
|
159
|
-
|
|
|
158
|
+
| 业务对象说明 | 五 | → F4 业务字段清单(对象分类与命名口径) |
|
|
159
|
+
| 异常和边界 | 六 | → F5 业务规则清单 |
|
|
160
|
+
| 最终输出与决策 | 七 | → §1 概览 + §8 风险与待确认 |
|
|
160
161
|
|
|
161
162
|
**如果缺失必填章节**:列出缺失章节,使用 AskUserQuestion 询问用户是否继续(部分章节可生成占位内容,标注 `[待确认:需求分析缺失 {章节名},待补充]`)。
|
|
162
163
|
|
|
@@ -480,15 +481,15 @@ OUTPUT_FILE = "{OUTPUT_DIR}/{short-name}_业务方案.md"
|
|
|
480
481
|
|
|
481
482
|
| 章节 | 状态 | 来源需求分析章节 |
|
|
482
483
|
| ---------------------- | --------- | ----------------------- |
|
|
483
|
-
| §1 概览 | ✅ 已生成 | 一·真实问题 +
|
|
484
|
+
| §1 概览 | ✅ 已生成 | 一·真实问题 + 七·决策 |
|
|
484
485
|
| §2 业务核心逻辑 (F1) | ✅ 已生成 | 一 + 四·4.1/4.2 |
|
|
485
486
|
| §3 业务流程架构 (F2) | ✅ 已生成 | 三·场景清单 + 四·主流程 |
|
|
486
|
-
| §4 业务流程文件 (F3) | ✅ 已生成 | 三 + 四·4.1/4.3 +
|
|
487
|
+
| §4 业务流程文件 (F3) | ✅ 已生成 | 三 + 四·4.1/4.3 + 六·异常 |
|
|
487
488
|
| F3 附录 状态流转 | ✅ 已生成 | 四·4.2 状态机 |
|
|
488
|
-
| §5 业务字段清单 (F4) | ✅ 已生成 | 四·4.1 输入/输出
|
|
489
|
-
| §6 业务规则清单 (F5) | ✅ 已生成 | 四·4.1 判断 +
|
|
489
|
+
| §5 业务字段清单 (F4) | ✅ 已生成 | 四·4.1 输入/输出 + 五·5.2 对象清单 |
|
|
490
|
+
| §6 业务规则清单 (F5) | ✅ 已生成 | 四·4.1 判断 + 六·异常 |
|
|
490
491
|
| §7 业务角色与权限 (F6) | ✅ 已生成 | 二·角色 + 权限矩阵 |
|
|
491
|
-
| §8 风险与待确认问题 | ✅ 已生成 |
|
|
492
|
+
| §8 风险与待确认问题 | ✅ 已生成 | 七·风险与待补充 |
|
|
492
493
|
| §9 确认签 | ✅ 已生成 | 模板固定文本 |
|
|
493
494
|
|
|
494
495
|
## 质量验证
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: "adspecs-new-requirement"
|
|
3
|
-
description: "基于业务需求描述,结合 01
|
|
3
|
+
description: "基于业务需求描述,结合 01-业务需求分析模板(七章结构),完成深度需求分析并输出业务需求分析文档。Skill 内部执行模拟需求评审(多角色尖锐提问),评审结论融入最终决策。在写 PRD 之前,先搞清楚真正的问题是什么、为谁解决、怎么解决、有哪些风险。"
|
|
4
4
|
agent_created: true
|
|
5
5
|
argument-hint: "描述你要分析的业务需求,或指定已有需求文档路径"
|
|
6
6
|
compatibility: "需要 docs/ 目录体系,含 01-业务需求分析模板.md"
|
|
@@ -37,7 +37,7 @@ $ARGUMENTS
|
|
|
37
37
|
|
|
38
38
|
## 定位
|
|
39
39
|
|
|
40
|
-
本 skill 专注于 **业务需求深度分析**,是产品交付流水线的第一步——在写 PRD(`02
|
|
40
|
+
本 skill 专注于 **业务需求深度分析**,是产品交付流水线的第一步——在写 PRD(`02`-产品需求说明书)之前,先完成七步需求分析 + 模拟需求评审,确保方向正确。
|
|
41
41
|
|
|
42
42
|
| 对比项 | adspecs-new-requirement(本 skill) | adspecs-prd | adspecs-front-spec | adspecs-plan |
|
|
43
43
|
| -------- | ------------------------------------------------------------ | -------------------------------------- | ---------------------------- | ----------------------------- |
|
|
@@ -45,7 +45,7 @@ $ARGUMENTS
|
|
|
45
45
|
| 模板 | `01-业务需求分析模板.md` | `02-产品需求说明书模板.md` | `04-前端功能设计模板.md` | `03-系统设计模板.md` |
|
|
46
46
|
| 目标读者 | 产品经理、业务方、技术负责人 | 产品经理、业务方 | 产品经理、前端开发、UX | 开发架构师、后端工程师 |
|
|
47
47
|
| 核心问题 | **为什么要做 & 问题本质是什么** | **做什么 & 为什么** | **怎么用** | **怎么建** |
|
|
48
|
-
| 关注点 |
|
|
48
|
+
| 关注点 | 真实问题、解法空间、角色权限、流程状态、业务对象、异常边界、需求成熟度 | 业务场景、用户故事、功能描述、验收标准 | 页面路由、界面布局、交互行为 | DO/DTO/VO、数据模型、接口设计 |
|
|
49
49
|
|
|
50
50
|
**典型工作流**:
|
|
51
51
|
|
|
@@ -65,7 +65,7 @@ $ARGUMENTS
|
|
|
65
65
|
|
|
66
66
|
## 任务
|
|
67
67
|
|
|
68
|
-
|
|
68
|
+
读取用户提供的业务需求描述(或已有需求文档),按照八步分析法(七步写入文档 + 模拟评审内部执行)完成深度需求分析,输出业务需求分析文档。
|
|
69
69
|
|
|
70
70
|
## 输入
|
|
71
71
|
|
|
@@ -73,7 +73,7 @@ $ARGUMENTS
|
|
|
73
73
|
- 可以是自然语言描述(如"我们需要一个客户管理模块")
|
|
74
74
|
- 也可以是文件路径(如 `docs/00-customer-requirements/crm/客户需求.md`)
|
|
75
75
|
- 如果输入为空,提示用户输入需求描述
|
|
76
|
-
- **模板文件**: `.adspecs/templates/01-业务需求分析模板.md` —
|
|
76
|
+
- **模板文件**: `.adspecs/templates/01-业务需求分析模板.md` — 业务需求分析输出模板(七章结构)
|
|
77
77
|
- **业务功能架构文档**: `{ARCH_DIR}/01-*_business_scenarios.md` 或 `{ARCH_DIR}/01-*_business_architecture.md` — 用于识别需求所属的二级模块(子模块)
|
|
78
78
|
- **项目上下文**(可选):
|
|
79
79
|
- `CLAUDE.md` — 项目技术架构、模块结构
|
|
@@ -126,8 +126,8 @@ $ARGUMENTS
|
|
|
126
126
|
- 如果 `$ARGUMENTS` 为空 → 使用 **AskUserQuestion** 工具提示用户输入需求描述
|
|
127
127
|
|
|
128
128
|
2. **加载模板**:
|
|
129
|
-
- 读取 `.adspecs/templates/01-业务需求分析模板.md
|
|
130
|
-
- 如果模板不存在,使用内置的分析结构(见下方"
|
|
129
|
+
- 读取 `.adspecs/templates/01-业务需求分析模板.md`,获取模板七章结构的完整骨架
|
|
130
|
+
- 如果模板不存在,使用内置的分析结构(见下方"八步分析法",其中第七步为 skill 内部模拟评审,不写入模板)
|
|
131
131
|
|
|
132
132
|
3. **加载项目上下文**(可选):
|
|
133
133
|
- 如果 `CLAUDE.md` 存在,读取以了解项目背景
|
|
@@ -191,9 +191,9 @@ $ARGUMENTS
|
|
|
191
191
|
|
|
192
192
|
**注意**: 不要在功能目录下创建 `feature.json` 文件——所有功能追踪统一在 `.adspecs/feature.json` 中管理。
|
|
193
193
|
|
|
194
|
-
##
|
|
194
|
+
## 八步分析法
|
|
195
195
|
|
|
196
|
-
> **注意**:模板 `01-业务需求分析模板.md`
|
|
196
|
+
> **注意**:模板 `01-业务需求分析模板.md` 包含七章结构(一~七),其中"五、业务对象说明"仅按单据类/主数据/枚举类分类列出对象名称与一句话简述,不展开属性(属性与 OBJ 编号在 `02` 第 5 部分定义)。本 skill 在七章基础上额外执行**第七步·模拟需求评审**(skill 内部分析),评审结论融入第八步最终决策。输出文档按模板的七章结构组织,评审发现体现在「最终输出与决策」的风险和成熟度评估中。
|
|
197
197
|
|
|
198
198
|
### 一、真实问题分析
|
|
199
199
|
|
|
@@ -291,7 +291,28 @@ $ARGUMENTS
|
|
|
291
291
|
- 状态机至少包含 3 个状态
|
|
292
292
|
- 如果流程涉及多角色协作(如提交→审批),必须明确交接点
|
|
293
293
|
|
|
294
|
-
###
|
|
294
|
+
### 五、业务对象说明
|
|
295
|
+
|
|
296
|
+
**目标**:厘清本需求涉及的业务对象全景,为流程描述和后续 PRD 提供统一的对象口径;本步只做对象清单,不展开属性。
|
|
297
|
+
|
|
298
|
+
**分析步骤**:
|
|
299
|
+
|
|
300
|
+
1. **对象识别**:从需求描述、场景清单和业务流程中提取所有涉及的业务对象
|
|
301
|
+
|
|
302
|
+
2. **对象分类**(与 `02`-产品需求说明书第 5 部分口径一致):
|
|
303
|
+
- 单据类对象:伴随业务事件产生、有生命周期状态流转的业务单据
|
|
304
|
+
- 主数据对象:相对稳定、被多个单据/流程引用的基础资料
|
|
305
|
+
- 枚举类对象:取值范围固定的分类/状态标识(一个枚举类对象对应一类取值集合,如"单据状态")
|
|
306
|
+
|
|
307
|
+
3. **清单输出**:每个对象一行,按模板 5.2 清单格式输出对象名称、对象类型和一句话简述
|
|
308
|
+
|
|
309
|
+
**输出要求**:
|
|
310
|
+
|
|
311
|
+
- 覆盖需求涉及的全部核心业务对象(单据 + 其引用的主数据 + 状态/类型枚举)
|
|
312
|
+
- **不列出**对象的具体属性、字段与关联关系(在 `02`-产品需求说明书第 5 部分定义)
|
|
313
|
+
- 分类拿不准的对象标注 `[待确认:对象分类]`
|
|
314
|
+
|
|
315
|
+
### 六、异常和边界场景
|
|
295
316
|
|
|
296
317
|
**目标**:穷举可能遗漏的异常场景,防止上线后出问题。
|
|
297
318
|
|
|
@@ -318,7 +339,7 @@ $ARGUMENTS
|
|
|
318
339
|
- 每个异常场景给出预期系统行为
|
|
319
340
|
- 不确定的异常处理标注 `[待确认:异常处理策略]`
|
|
320
341
|
|
|
321
|
-
###
|
|
342
|
+
### 七、需求评审
|
|
322
343
|
|
|
323
344
|
**目标**:提前暴露需求盲点,减少后续返工。
|
|
324
345
|
|
|
@@ -349,7 +370,7 @@ $ARGUMENTS
|
|
|
349
370
|
- 问题必须基于当前需求分析的具体内容,不能是泛泛的模板问题
|
|
350
371
|
- 评审结论表汇总所有问题的解决状态
|
|
351
372
|
|
|
352
|
-
###
|
|
373
|
+
### 八、最终输出与决策
|
|
353
374
|
|
|
354
375
|
**目标**:通过 10 项质量检查验证分析完整性,给出需求成熟度判断和下一步建议。
|
|
355
376
|
|
|
@@ -366,9 +387,9 @@ $ARGUMENTS
|
|
|
366
387
|
| 5 | 用户在什么场景下使用? | ✅/⚠️/❌ | 三·3.1 | 【高频+低频场景是否已拆解,触发条件是否明确】 |
|
|
367
388
|
| 6 | 完整业务流程是什么? | ✅/⚠️/❌ | 四·4.1 | 【主流程每一步的操作者、动作、输入输出是否清晰】 |
|
|
368
389
|
| 7 | 每一步涉及哪些状态变化? | ✅/⚠️/❌ | 四·4.2 | 【状态机是否已梳理,流转条件和约束是否明确】 |
|
|
369
|
-
| 8 | 有哪些异常和边界场景? | ✅/⚠️/❌ |
|
|
370
|
-
| 9 | 研发、测试可能会质疑什么? | ✅/⚠️/❌ |
|
|
371
|
-
| 10 | 上线后用什么指标判断有效? | ✅/⚠️/❌ |
|
|
390
|
+
| 8 | 有哪些异常和边界场景? | ✅/⚠️/❌ | 六·6.1 | 【是否从操作/系统/数据/权限/网络/并发等多角度覆盖】 |
|
|
391
|
+
| 9 | 研发、测试可能会质疑什么? | ✅/⚠️/❌ | 七(评审) | 【模拟评审是否提出了有针对性的尖锐问题】 |
|
|
392
|
+
| 10 | 上线后用什么指标判断有效? | ✅/⚠️/❌ | 七·7.2 | 【是否定义了可度量的成功标准(业务指标/性能指标)】 |
|
|
372
393
|
|
|
373
394
|
2. **通过规则**:
|
|
374
395
|
- **✅ 全部通过**:10 项均为 ✅ → 建议进入 PRD 阶段
|
|
@@ -400,9 +421,9 @@ $ARGUMENTS
|
|
|
400
421
|
- 如果找到,读取并按"执行前检查 · 步骤 4"的规则匹配二级模块编号 `MODULE_ID`
|
|
401
422
|
- 如果未找到或无法自动匹配,按规则处理(用户选择或留空)
|
|
402
423
|
|
|
403
|
-
### 步骤 2
|
|
424
|
+
### 步骤 2:执行八步分析
|
|
404
425
|
|
|
405
|
-
按"
|
|
426
|
+
按"八步分析法"逐节完成分析。其中第一~六步和第八步写入输出文档,第七步(需求评审)为 skill 内部分析,评审结论融入第八步的决策。每一节的执行要求:
|
|
406
427
|
|
|
407
428
|
1. **先读模板对应章节**:了解该节需要的输出格式和字段
|
|
408
429
|
2. **分析需求描述**:从用户输入中提取相关信息
|
|
@@ -415,7 +436,7 @@ $ARGUMENTS
|
|
|
415
436
|
- 不要急着给方案,先分析问题本质
|
|
416
437
|
- 每一步的分析结论必须有依据(来自用户输入、项目上下文或合理推断)
|
|
417
438
|
- 如果用户输入信息不足以完成某一节,基于合理推断填写并标注 `[待确认]`
|
|
418
|
-
-
|
|
439
|
+
- 模拟需求评审(第七步)的问题必须基于前 6 步的分析结果(含业务对象与异常),提出有针对性的尖锐问题
|
|
419
440
|
|
|
420
441
|
### 步骤 3:写入分析文档
|
|
421
442
|
|
|
@@ -439,7 +460,7 @@ $ARGUMENTS
|
|
|
439
460
|
|
|
440
461
|
2. **写入文件**:使用 Write 工具将完整的分析文档写入 `OUTPUT_FILE`
|
|
441
462
|
- 文档头部填写模块编号(`MODULE_ID`)、主模块编号(`PARENT_MODULE`)、模块名称、日期等元信息
|
|
442
|
-
-
|
|
463
|
+
- 按模板结构输出七章分析结果(模拟需求评审的发现融入「七、最终输出与决策」的风险评估与成熟度判断)
|
|
443
464
|
- 保留模板中的表格格式和章节结构
|
|
444
465
|
|
|
445
466
|
3. **输出确认信息**:
|
|
@@ -453,7 +474,7 @@ $ARGUMENTS
|
|
|
453
474
|
|
|
454
475
|
### 步骤 4:质量检查输出
|
|
455
476
|
|
|
456
|
-
执行 10 项需求分析质量检查(定义在"
|
|
477
|
+
执行 10 项需求分析质量检查(定义在"八、最终输出与决策"中):
|
|
457
478
|
|
|
458
479
|
1. **逐项验证**:对照 10 项检查清单,逐项标注 ✅/⚠️/❌,并填写补充说明
|
|
459
480
|
2. **关联回溯**:每项检查必须关联到输出文档中对应章节的具体内容,确认不是空占位符
|
|
@@ -528,7 +549,7 @@ $ARGUMENTS
|
|
|
528
549
|
|
|
529
550
|
## 输出文件结构
|
|
530
551
|
|
|
531
|
-
>
|
|
552
|
+
> 输出文档按模板的**七章结构**组织。模拟需求评审(skill 内部第七步)的发现融入「七、最终输出与决策」的风险评估和成熟度判断中,不单独成节。
|
|
532
553
|
|
|
533
554
|
```markdown
|
|
534
555
|
# 01-业务需求分析:{模块名称}
|
|
@@ -578,19 +599,25 @@ $ARGUMENTS
|
|
|
578
599
|
|
|
579
600
|
### 4.3 其他场景流程
|
|
580
601
|
|
|
581
|
-
##
|
|
602
|
+
## 五、业务对象说明
|
|
603
|
+
|
|
604
|
+
### 5.1 对象分类
|
|
605
|
+
|
|
606
|
+
### 5.2 业务对象清单
|
|
607
|
+
|
|
608
|
+
## 六、异常和边界场景
|
|
582
609
|
|
|
583
|
-
###
|
|
610
|
+
### 6.1 异常场景清单
|
|
584
611
|
|
|
585
|
-
###
|
|
612
|
+
### 6.2 边界值检查
|
|
586
613
|
|
|
587
|
-
##
|
|
614
|
+
## 七、最终输出与决策
|
|
588
615
|
|
|
589
|
-
###
|
|
616
|
+
### 7.1 需求分析质量检查(10 项)
|
|
590
617
|
|
|
591
|
-
###
|
|
618
|
+
### 7.2 风险与待补充(含评审发现)
|
|
592
619
|
|
|
593
|
-
###
|
|
620
|
+
### 7.3 决策
|
|
594
621
|
|
|
595
622
|
## 附录:与 02 产品需求说明书的关系
|
|
596
623
|
```
|
|
@@ -600,10 +627,10 @@ $ARGUMENTS
|
|
|
600
627
|
- [ ] 已解析用户输入(需求描述或文档路径)
|
|
601
628
|
- [ ] 已加载 01-业务需求分析模板
|
|
602
629
|
- [ ] 已扫描 `{ARCH_DIR}/` 并识别匹配的二级模块编号 `MODULE_ID`(或确认为空/用户手动选择)
|
|
603
|
-
- [ ]
|
|
630
|
+
- [ ] 八步分析全部完成(真实问题、角色、场景、流程、业务对象、异常、模拟评审、决策)
|
|
604
631
|
- [ ] 模拟需求评审已在 skill 内部执行(研发/测试/业务三角色提问)
|
|
605
|
-
- [ ]
|
|
632
|
+
- [ ] 评审发现已融入「七、最终输出与决策」的风险评估中
|
|
606
633
|
- [ ] 10 项质量检查已逐项验证(真实问题 / 问题vs方案 / 核心角色 / 相关角色 / 使用场景 / 业务流程 / 状态变化 / 异常边界 / 研发测试质疑 / 上线指标)
|
|
607
|
-
- [ ]
|
|
634
|
+
- [ ] 分析文档已按模板七章结构写入 `{OUTPUT_DIR}/{MODULE_ID}/{MODULE_ID}_{name}_业务需求分析.md`(无模块时写入 `{OUTPUT_DIR}/{name}_业务需求分析.md`)
|
|
608
635
|
- [ ] 质量检查结果(N/10)和下一步建议已输出
|
|
609
636
|
- [ ] 扩展钩子已根据上述必选执行后钩子规则分发或跳过
|