6aspec 2.0.0-dev.14 → 2.0.0-dev.15

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.
@@ -47,8 +47,7 @@
47
47
  "originalPath": "6aspecdoc/brown/<name>",
48
48
  "archivePath": "6aspecdoc/brown/.archived/<timestamp>-<name>",
49
49
  "completedPhases": 7,
50
- "totalTasks": 8,
51
- "priority": "P0/P1/P2"
50
+ "totalTasks": 8
52
51
  }
53
52
  ```
54
53
 
@@ -59,7 +58,6 @@
59
58
  # 归档摘要:<name>
60
59
 
61
60
  > **归档时间**: <timestamp>
62
- > **优先级**: P0/P1/P2
63
61
  > **完成阶段**: 7/7
64
62
  > **总任务数**: 8
65
63
  > **总工时**: <工时>
@@ -83,7 +81,7 @@
83
81
  - 04-tasks-overview.md - 任务拆解
84
82
  - 05-verification-report.md - 验证报告
85
83
  - 06-post-implementation-review.md - 实施后评估
86
- - ADR-<name>.md - 架构决策记录(P0)
84
+ - ADR-<name>.md - 架构决策记录(如有)
87
85
 
88
86
  ## 经验教训
89
87
 
@@ -107,7 +105,6 @@
107
105
  **归档位置**: 6aspecdoc/brown/.archived/<timestamp>-<name>/
108
106
 
109
107
  ### 需求统计
110
- - 优先级:P0/P1/P2
111
108
  - 完成阶段:7/7
112
109
  - 总任务数:8
113
110
  - 总工时:<工时>
@@ -1,6 +1,6 @@
1
1
  # 棕地需求 - Design SOP
2
2
 
3
- Phase 3: 技术方案设计
3
+ 技术方案设计 - 适用于所有流程级别
4
4
 
5
5
  **输入**:`/6aspec:brown:design` 后可选需求名称。
6
6
 
@@ -9,15 +9,23 @@ Phase 3: 技术方案设计
9
9
  1. **选择需求并检查状态**
10
10
 
11
11
  - 读取 `6aspecdoc/brown/<name>/status.json`
12
- - 确认 `phases.impact` 为 "done"
13
- - 如果未完成 Phase 2,提示先运行 `/6aspec:brown:impact`
12
+ - 根据 `flowDepth` 检查前置阶段:
13
+ - **轻量级**:确认 `phases.proposal` "done",如果未完成提示先运行 `/6aspec:brown:proposal`
14
+ - **标准级/完整级**:确认 `phases.impact` 为 "done",如果未完成提示先运行 `/6aspec:brown:impact`
14
15
 
15
16
  2. **读取前置文档**
16
17
 
18
+ 根据 `flowDepth` 读取不同的前置文档:
19
+
20
+ **轻量级流程**:
21
+ - `6aspecdoc/brown/<name>/requirement.md`
22
+ - `6aspecdoc/brown/<name>/artifacts/proposal.md`
23
+
24
+ **标准级/完整级流程**:
17
25
  - `6aspecdoc/brown/<name>/requirement.md`
18
- - `6aspecdoc/brown/<name>/artifacts/01-understanding.md`
19
- - `6aspecdoc/brown/<name>/artifacts/01.5-specs.md`(标准级/完整级)
20
- - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md`
26
+ - `6aspecdoc/brown/<name>/artifacts/understanding.md`
27
+ - `6aspecdoc/brown/<name>/artifacts/specs.md`
28
+ - `6aspecdoc/brown/<name>/artifacts/impact-analysis.md`
21
29
 
22
30
  3. **设计数据库变更方案**
23
31
 
@@ -46,9 +54,9 @@ Phase 3: 技术方案设计
46
54
  - 集成测试(流程级别)
47
55
  - 数据一致性验证(SQL 验证)
48
56
 
49
- 7. **架构决策记录(P0 需求必须)**
57
+ 7. **架构决策记录(涉及架构决策时创建)**
50
58
 
51
- 如果是 P0 级需求,创建 ADR:
59
+ 如果需求涉及重要的架构决策(如技术选型、数据模型设计、集成方案等),创建 ADR:
52
60
 
53
61
  创建 `6aspecdoc/brown/<name>/artifacts/ADR-<name>.md`:
54
62
  ```markdown
@@ -92,31 +100,109 @@ Phase 3: 技术方案设计
92
100
 
93
101
  9. **创建技术方案文档**
94
102
 
95
- 创建 `6aspecdoc/brown/<name>/artifacts/03-technical-design.md`
103
+ 创建 `6aspecdoc/brown/<name>/artifacts/design.md`
96
104
 
97
105
  10. **更新状态**
98
106
 
99
107
  更新 `6aspecdoc/brown/<name>/status.json`:
108
+
109
+ **轻量级流程**:
110
+ ```json
111
+ {
112
+ "status": "tasks_pending",
113
+ "flowDepth": "lightweight",
114
+ "phases": {
115
+ "proposal": "done",
116
+ "design": "done",
117
+ "tasks": "pending",
118
+ "implement": "blocked"
119
+ },
120
+ "artifacts": ["proposal.md", "design.md"]
121
+ }
122
+ ```
123
+
124
+ **标准级/完整级流程**:
100
125
  ```json
101
126
  {
102
127
  "status": "tasks_pending",
128
+ "flowDepth": "standard",
103
129
  "phases": {
104
130
  "understand": "done",
131
+ "specs": "done",
105
132
  "impact": "done",
106
133
  "design": "done",
107
134
  "tasks": "pending",
108
- ...
109
- }
135
+ "implement": "blocked"
136
+ },
137
+ "artifacts": ["understanding.md", "specs.md", "impact-analysis.md", "design.md"]
110
138
  }
111
139
  ```
112
140
 
113
141
  **输出**
114
142
 
143
+ 根据 `flowDepth` 显示不同的输出信息:
144
+
145
+ **轻量级流程**:
146
+ ```
147
+ ## Design 完成:<name>
148
+
149
+ **流程**: 轻量级
150
+ **进度**: 2/4 阶段完成
151
+
152
+ ### 方案概要
153
+ - 数据库变更:<数量> 个表
154
+ - 代码变更:<数量> 个类
155
+ - 前端变更:<数量> 个页面
156
+ - 测试用例:<数量> 个
157
+
158
+ ### 关键设计决策
159
+ <列出 2-3 个关键决策>
160
+
161
+ ### 文档位置
162
+ - 6aspecdoc/brown/<name>/artifacts/design.md
163
+ - 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (如涉及架构决策)
164
+
165
+ ### 下一步
166
+ - 直接回复修正设计方案或补充细节 → 我会更新本阶段文档(design.md)
167
+ - 运行 `/6aspec:brown:tasks` → 进入任务拆解阶段
168
+ - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
169
+ ```
170
+
171
+ **标准级流程**:
172
+ ```
173
+ ## Design 完成:<name>
174
+
175
+ **流程**: 标准级
176
+ **进度**: 4/6 阶段完成
177
+
178
+ ### 方案概要
179
+ - 数据库变更:<数量> 个表
180
+ - 代码变更:<数量> 个类
181
+ - 前端变更:<数量> 个页面
182
+ - 测试用例:<数量> 个
183
+
184
+ ### 关键设计决策
185
+ <列出 2-3 个关键决策>
186
+
187
+ ### 技术债务
188
+ <列出识别的技术债务>
189
+
190
+ ### 文档位置
191
+ - 6aspecdoc/brown/<name>/artifacts/design.md
192
+ - 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (如涉及架构决策)
193
+
194
+ ### 下一步
195
+ - 直接回复修正设计方案或补充细节 → 我会更新本阶段文档(design.md)
196
+ - 运行 `/6aspec:brown:tasks` → 进入任务拆解阶段
197
+ - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
198
+ ```
199
+
200
+ **完整级流程**:
115
201
  ```
116
- ## Phase 3 完成:技术方案设计
202
+ ## Design 完成:<name>
117
203
 
118
- **需求**: <name>
119
- **进度**: 4/5 阶段完成(标准级)或 4/6 阶段完成(完整级)
204
+ **流程**: 完整级
205
+ **进度**: 4/8 阶段完成
120
206
 
121
207
  ### 方案概要
122
208
  - 数据库变更:<数量> 个表
@@ -131,11 +217,11 @@ Phase 3: 技术方案设计
131
217
  <列出识别的技术债务>
132
218
 
133
219
  ### 文档位置
134
- - 6aspecdoc/brown/<name>/artifacts/03-technical-design.md
135
- - 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (P0)
220
+ - 6aspecdoc/brown/<name>/artifacts/design.md
221
+ - 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (如涉及架构决策)
136
222
 
137
223
  ### 下一步
138
- - 直接回复修正设计方案或补充细节 → 我会更新本阶段文档(03-technical-design.md)
224
+ - 直接回复修正设计方案或补充细节 → 我会更新本阶段文档(design.md)
139
225
  - 运行 `/6aspec:brown:tasks` → 进入任务拆解阶段
140
226
  - 运行 `/6aspec:brown:continue` → 自动进入下一阶段
141
227
  ```
@@ -143,13 +229,15 @@ Phase 3: 技术方案设计
143
229
  **用户补充信息时的处理**
144
230
 
145
231
  当用户修正设计方案、补充技术细节、或对设计决策提出异议时(未使用阶段命令):
146
- 1. 将用户的修正/补充整合到 `03-technical-design.md` 的对应章节
232
+ 1. 将用户的修正/补充整合到 `design.md` 的对应章节
147
233
  2. 展示变更摘要
148
234
  3. 再次提示:可以继续补充,或通过命令进入下一阶段
149
235
  4. **禁止**:不得自动进入下一阶段
150
236
 
151
237
  **防护措施**
152
- - 必须先完成 Phase 2
153
- - P0 需求必须创建 ADR
238
+ - 根据 `flowDepth` 检查前置阶段:
239
+ - **轻量级**:必须先完成 proposal 阶段
240
+ - **标准级/完整级**:必须先完成 impact 阶段
241
+ - 涉及架构决策时必须创建 ADR(如技术选型、数据模型设计、集成方案等)
154
242
  - 代码示例必须完整可用
155
- - 技术债务必须明确标注
243
+ - 技术债务必须明确标注(标准级/完整级)
@@ -30,24 +30,24 @@
30
30
 
31
31
  ### 进行中 (2)
32
32
 
33
- | 需求 | 优先级 | 当前阶段 | 进度 | 最后修改 |
34
- |------|--------|----------|------|----------|
35
- | add-user-auth | P0 | Phase 3: 技术方案设计 | 3/7 | 2小时前 |
36
- | fix-login-bug | P1 | Phase 2: 影响面分析 | 2/7 | 1天前 |
33
+ | 需求 | 当前阶段 | 进度 | 最后修改 |
34
+ |------|----------|------|----------|
35
+ | add-user-auth | Phase 3: 技术方案设计 | 3/7 | 2小时前 |
36
+ | fix-login-bug | Phase 2: 影响面分析 | 2/7 | 1天前 |
37
37
 
38
38
  ### 已完成 (1)
39
39
 
40
- | 需求 | 优先级 | 完成时间 | 任务完成率 |
41
- |------|--------|----------|-----------|
42
- | add-export-feature | P1 | 3天前 | 8/8 (100%) |
40
+ | 需求 | 完成时间 | 任务完成率 |
41
+ |------|----------|-----------|
42
+ | add-export-feature | 3天前 | 8/8 (100%) |
43
43
 
44
44
  ### 已归档 (3)
45
45
 
46
- | 需求 | 优先级 | 归档时间 |
47
- |------|--------|----------|
48
- | refactor-api | P0 | 1周前 |
49
- | update-ui | P1 | 2周前 |
50
- | fix-typo | P2 | 1个月前 |
46
+ | 需求 | 归档时间 |
47
+ |------|----------|
48
+ | refactor-api | 1周前 |
49
+ | update-ui | 2周前 |
50
+ | fix-typo | 1个月前 |
51
51
 
52
52
  ### 统计
53
53
 
@@ -1,6 +1,6 @@
1
1
  # 棕地需求 - Quick SOP
2
2
 
3
- P2 需求快速通道 - 适用于简单修复和小改动。
3
+ 快速通道 - 适用于简单修复和小改动。
4
4
 
5
5
  **输入**:`/6aspec:brown:quick` 后的参数是需求名称(kebab-case)或需求描述。
6
6
 
@@ -33,7 +33,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
33
33
  ```json
34
34
  {
35
35
  "name": "<name>",
36
- "priority": "P2",
37
36
  "status": "quick_track",
38
37
  "createdAt": "<timestamp>",
39
38
  "lastModified": "<timestamp>",
@@ -46,7 +45,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
46
45
  # <需求标题>
47
46
 
48
47
  > **需求ID**: <name>
49
- > **优先级**: P2(快速通道)
50
48
  > **状态**: 🚀 快速处理中
51
49
  > **创建时间**: <timestamp>
52
50
 
@@ -105,7 +103,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
105
103
  ```
106
104
  ## 快速处理完成:<name>
107
105
 
108
- **优先级**: P2(快速通道)
109
106
  **处理时间**: <时间戳>
110
107
 
111
108
  ### 修改内容
@@ -121,7 +118,7 @@ P2 需求快速通道 - 适用于简单修复和小改动。
121
118
  - 或归档:运行 `/6aspec:brown:archive` 归档此需求
122
119
 
123
120
  ### 注意
124
- P2 需求使用快速通道,跳过了详细的分析和设计阶段。
121
+ 快速通道跳过了详细的分析和设计阶段。
125
122
  如果发现需求比预期复杂,建议使用完整流程(/6aspec:brown:new)。
126
123
  ```
127
124
 
@@ -20,7 +20,7 @@ Phase 7: 实施后评估
20
20
  - `6aspecdoc/brown/<name>/requirement.md` - 原始需求
21
21
  - `6aspecdoc/brown/<name>/artifacts/02-impact-analysis.md` - 预期影响
22
22
  - `6aspecdoc/brown/<name>/artifacts/03-technical-design.md` - 技术方案
23
- - `6aspecdoc/brown/<name>/artifacts/ADR-<name>.md` - 架构决策(P0)
23
+ - `6aspecdoc/brown/<name>/artifacts/ADR-<name>.md` - 架构决策(如有)
24
24
 
25
25
  3. **参考相关归档需求(可选)**
26
26
 
@@ -60,7 +60,7 @@ Phase 7: 实施后评估
60
60
  - 用户反馈如何?
61
61
  - 是否需要调整?
62
62
 
63
- **架构决策回顾**(P0 需求):
63
+ **架构决策回顾**(如有):
64
64
  - 当初的架构决策是否正确?
65
65
  - 有哪些经验教训?
66
66
  - 需要更新 ADR 吗?
@@ -144,7 +144,7 @@ Phase 7: 实施后评估
144
144
  调整计划(如需要):
145
145
  <调整计划>
146
146
 
147
- ## 3. 架构决策回顾(P0 需求)
147
+ ## 3. 架构决策回顾(如有)
148
148
 
149
149
  ### 3.1 决策回顾
150
150
 
@@ -266,5 +266,5 @@ Phase 7: 实施后评估
266
266
  - 必须先完成 Phase 6
267
267
  - 评估必须基于实际数据,不能主观臆断
268
268
  - 必须收集用户反馈
269
- - P0 需求必须回顾架构决策
269
+ - 涉及架构决策的需求必须回顾架构决策
270
270
  - 必须进行知识沉淀
@@ -18,8 +18,7 @@ Phase 1: 需求理解与现状分析
18
18
 
19
19
  读取 `6aspecdoc/brown/<name>/status.json`:
20
20
  - 如果 `phases.understand` 不是 "pending",提示已完成或跳过
21
- - 确认需求级别(P0/P1/P2)
22
- - P2 需求提示使用 `/6aspec:brown:quick`
21
+ - 如果是简单需求,提示考虑使用 `/6aspec:brown:quick` 快速通道
23
22
 
24
23
  3. **读取需求描述**
25
24
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "6aspec",
3
- "version": "2.0.0-dev.14",
3
+ "version": "2.0.0-dev.15",
4
4
  "description": "6Aspec - 轻量级 spec 驱动开发框架,支持 Cursor 和 Claude Code",
5
5
  "main": "lib/installer.js",
6
6
  "bin": {