adspecs 0.1.35 → 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.
Files changed (11) hide show
  1. 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
  2. package/.adspecs/templates/02-/344/272/247/345/223/201/351/234/200/346/261/202/350/257/264/346/230/216/344/271/246/346/250/241/346/235/277.md +784 -626
  3. package/.claude-plugin/marketplace.json +1 -1
  4. package/.claude-plugin/plugin.json +1 -1
  5. package/.codebuddy-plugin/plugin.json +1 -1
  6. package/.qoder-plugin/plugin.json +1 -1
  7. package/.workbuddy-plugin/plugin.json +1 -1
  8. package/package.json +1 -1
  9. package/skills/adspecs-biz-blueprint/SKILL.md +8 -7
  10. package/skills/adspecs-new-requirement/SKILL.md +58 -31
  11. package/skills/adspecs-prd/SKILL.md +98 -19
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 CHANGED
@@ -1,17 +1,18 @@
1
1
  # 01-业务需求分析（BRD）
2
2
 
3
- > **版本**: v2.0
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.0 | 2026-07-04 | 结构重构：引入六步需求分析法；模拟需求评审移至 adspecs-new-requirement skill |
14
- | v1.0 | 2026-03-16 | 首版填写 |
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
- ### 5.1 异常场景清单
186
+ ### 6.1 异常场景清单
159
187
 
160
188
  | 编号 | 类别 | 异常场景 | 触发条件 | 预期系统行为 | 影响范围 |
161
189
  | ----- | -------- | ---------------------------- | ------------ | ----------------- | ---------------- |
@@ -168,7 +196,7 @@
168
196
  | EX-07 | 历史数据 | 【如：旧数据不兼容新规则】 | 【触发条件】 | 【迁移/兼容方案】 | 【影响】 |
169
197
  | EX-08 | 后台处理 | 【如：异步任务超时/失败】 | 【触发条件】 | 【重试/告警策略】 | 【影响】 |
170
198
 
171
- ### 5.2 边界值检查
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
- ### 6.1 需求成熟度评估
214
+ ### 7.1 需求成熟度评估
187
215
 
188
216
  | 评估维度 | 状态 | 说明 |
189
217
  | ------------ | ----- | ---------------------------- |
@@ -193,7 +221,7 @@
193
221
  | 流程无歧义 | ✅/⚠️/❌ | 【主流程和状态机是否已梳理】 |
194
222
  | 异常已考虑 | ✅/⚠️/❌ | 【边界和异常场景是否已覆盖】 |
195
223
 
196
- ### 6.2 风险与待补充
224
+ ### 7.2 风险与待补充
197
225
 
198
226
  | 最大风险 | 影响 | 应对 |
199
227
  | ---------- | -------- | ------------ |
@@ -204,7 +232,7 @@
204
232
  - 【待补充项 1】
205
233
  - 【待补充项 2】
206
234
 
207
- ### 6.3 决策
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 分析） | 作用 | 02 中落地 |
220
- | ------------------ | --------------------------- | --------------------------- |
221
- | 一、真实问题分析 | 锁定问题域，避免做错方向 | → 02 §1 背景与目标 |
222
- | 二、用户角色分析 | 明确为谁做、权限边界 | → 02 §2 目标用户 + 权限设计 |
223
- | 三、使用场景拆解 | 确定功能优先级 | → 02 §3 功能清单 + 用户故事 |
224
- | 四、业务流程梳理 | 定义操作动线和状态机 | → 02 §4 详细设计 + 交互流程 |
225
- | 五、异常和边界场景 | 预防遗漏和线上事故 | → 02 §5 产品规则 + 异常处理 |
226
- | 六、最终输出与决策 | 判断是否具备进入 PRD 的条件 | → 02 启动的前置检查 |
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
  ---