6aspec 2.0.0-dev.7 → 2.0.0-dev.9

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.
@@ -21,21 +21,15 @@ Phase 1.5: 需求规格定义
21
21
  - `6aspecdoc/brown/<name>/requirement.md`
22
22
  - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
23
23
 
24
- 3. **提出并收集需求问题**
24
+ 3. **读取问题答案**
25
25
 
26
- 基于 understanding.md 的现状分析和"发现的疑问点",系统性地提出需求问题:
26
+ understanding.md 中读取"待明确问题清单"及用户的答案:
27
27
 
28
- **需求问题类型**:
29
- - 字段设计问题(名称、类型、必填、默认值、值域)
30
- - 业务规则问题(是否可修改、是否继承、是否同步)
31
- - 权限和统计问题(权限控制、统计报表)
32
- - 集成和兼容问题(与其他模块的集成、数据迁移)
28
+ - 检查问题清单中哪些问题已经有答案(标记为具体值而非"[待确认]")
29
+ - 如果有未回答的问题,提示用户这些问题需要明确,但不阻塞 specs 阶段
30
+ - 基于已有的答案和现状分析,开始定义需求规格
33
31
 
34
- **收集答案**:
35
- - 引导用户回答这些需求问题
36
- - 如果用户已经在对话中提供了答案,直接使用
37
- - 否则,询问用户关键问题(选择最重要的 3-5 个问题)
38
- - 在同一阶段内完成问题提出和答案收集
32
+ 注意:specs 阶段不再提出新问题,所有需求问题应该在 understand 阶段提出并收集。
39
33
 
40
34
  4. **定义功能需求**
41
35
 
@@ -64,14 +64,17 @@ Phase 1: 需求理解与现状分析
64
64
  - 识别状态机约束
65
65
  - 识别权限控制逻辑
66
66
 
67
- 5. **记录发现的疑问点**
67
+ 5. **生成待明确问题清单**
68
68
 
69
- 基于现状分析,记录在分析过程中发现的疑问点(观察性备注):
70
- - 现有实现中不清楚的地方
71
- - 可能影响需求实现的关键点
72
- - 需要在 specs 阶段明确的技术或业务细节
69
+ 基于现状分析和需求描述,生成需要用户明确的问题清单:
73
70
 
74
- 注意:这些疑问点是观察性的,不是正式的需求问题清单。正式的需求问题将在 specs 阶段提出。
71
+ **问题类型**:
72
+ - 字段设计问题(名称、类型、必填、默认值、值域)
73
+ - 业务规则问题(是否可修改、是否继承、是否同步)
74
+ - 权限和统计问题(权限控制、统计报表)
75
+ - 集成和兼容问题(与其他模块的集成、数据迁移)
76
+
77
+ 这些问题将在本阶段提出,并引导用户回答,为 specs 阶段的需求定义提供依据。
75
78
 
76
79
  6. **创建分析文档**
77
80
 
@@ -118,22 +121,27 @@ Phase 1: 需求理解与现状分析
118
121
  ### 1.5 隐性假设和约束
119
122
  <列出识别的隐性假设和约束>
120
123
 
121
- ## 2. 发现的疑问点
122
-
123
- 基于现状分析,记录以下疑问点(这些疑问点将在 specs 阶段转化为正式的需求问题):
124
+ ## 2. 待明确问题清单
124
125
 
125
- ### 技术实现相关
126
- - <现有实现中不清楚的地方>
126
+ ### 字段设计
127
+ 1. 字段名称:[待确认]
128
+ 2. 字段类型:[待确认]
129
+ 3. 是否必填:[待确认]
130
+ 4. 默认值:[待确认]
131
+ 5. 值域范围:[待确认]
127
132
 
128
- ### 业务逻辑相关
129
- - <可能影响需求实现的关键点>
133
+ ### 业务规则
134
+ 6. 是否可以修改:[待确认]
135
+ 7. 子项目是否继承:[待确认]
136
+ 8. 是否需要同步到其他表:[待确认]
130
137
 
131
- ### 数据和集成相关
132
- - <需要在 specs 阶段明确的技术或业务细节>
138
+ ### 权限和统计
139
+ 9. 是否需要权限控制:[待确认]
140
+ 10. 是否需要统计报表:[待确认]
133
141
 
134
142
  ## 3. 下一步
135
143
 
136
- 运行 `/6aspec:brown:specs` 进入需求规格定义阶段,在该阶段将提出正式的需求问题并定义系统应该具备的能力。
144
+ 请回答上述待明确问题,然后运行 `/6aspec:brown:specs` 定义需求规格。
137
145
  ```
138
146
 
139
147
  7. **更新状态**
@@ -158,7 +166,7 @@ Phase 1: 需求理解与现状分析
158
166
 
159
167
  完成后,显示:
160
168
  ```
161
- ## Phase 1 完成:现状分析
169
+ ## Phase 1 完成:需求理解与现状分析
162
170
 
163
171
  **需求**: <name>
164
172
  **进度**: 1/7 阶段完成
@@ -167,29 +175,29 @@ Phase 1: 需求理解与现状分析
167
175
  - 相关实体类:<数量>
168
176
  - 相关服务类:<数量>
169
177
  - 数据库表:<数量>
170
- - 发现的疑问点:<数量>
178
+ - 待明确问题:<数量>
171
179
 
172
180
  ### 关键发现
173
181
  <列出 2-3 个关键发现>
174
182
 
175
- ### 发现的疑问点
176
- <列出主要的疑问点>
183
+ ### 待明确问题(重要)
184
+ <列出最重要的 3-5 个问题>
177
185
 
178
186
  ### 文档位置
179
187
  6aspecdoc/brown/<name>/artifacts/01-understanding.md
180
188
 
181
189
  ### 下一步
182
- - 直接补充现状分析信息 → 我会更新本阶段文档(01-understanding.md
183
- - 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段(将提出正式的需求问题)
190
+ - 直接回答上述待明确问题 → 我会更新本阶段文档(01-understanding.md)中的问题答案
191
+ - 运行 `/6aspec:brown:specs` → 进入需求规格定义阶段
184
192
  - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
185
193
  ```
186
194
 
187
195
  **用户补充信息时的处理**
188
196
 
189
- 当用户补充现状分析信息时(未使用阶段命令):
190
- 1. 将用户的补充整合到 `01-understanding.md` 的相关章节
191
- 2. 如果补充引发新的发现或疑问点,同步更新文档
192
- 3. 展示变更摘要(更新了哪些内容、新增了哪些发现)
197
+ 当用户回答待明确问题或补充需求信息时(未使用阶段命令):
198
+ 1. 将用户的回答整合到 `01-understanding.md` 中对应的问题项(将"[待确认]"替换为实际答案)
199
+ 2. 如果回答引发新的发现或问题,同步更新文档的相关章节
200
+ 3. 展示变更摘要(更新了哪些问题的答案、新增了哪些发现)
193
201
  4. 再次提示:可以继续补充,或通过命令进入下一阶段
194
202
  5. **禁止**:不得自动进入下一阶段
195
203
 
@@ -197,4 +205,4 @@ Phase 1: 需求理解与现状分析
197
205
  - 必须先读取需求描述再开始分析
198
206
  - 如果找不到相关代码,询问用户提供更多关键词
199
207
  - 如果分析不充分,不要强行生成文档,而是询问用户
200
- - 发现的疑问点应该是观察性的,不是正式的需求问题
208
+ - 待明确问题必须具体,避免模糊问题
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "6aspec",
3
- "version": "2.0.0-dev.7",
3
+ "version": "2.0.0-dev.9",
4
4
  "description": "6Aspec - 轻量级 spec 驱动开发框架,支持 Cursor 和 Claude Code",
5
5
  "main": "lib/installer.js",
6
6
  "bin": {