6aspec 2.0.0-dev.12 → 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.
- package/.6aspec/rules/brown/brown_archive_sop.md +5 -5
- package/.6aspec/rules/brown/brown_constitution.md +11 -0
- package/.6aspec/rules/brown/brown_design_sop.md +109 -21
- package/.6aspec/rules/brown/brown_list_sop.md +12 -12
- package/.6aspec/rules/brown/brown_new_sop.md +2 -0
- package/.6aspec/rules/brown/brown_quick_sop.md +5 -5
- package/.6aspec/rules/brown/brown_review_sop.md +4 -4
- package/.6aspec/rules/brown/brown_rollback_sop.md +2 -2
- package/.6aspec/rules/brown/brown_understand_sop.md +1 -2
- package/package.json +1 -1
|
@@ -36,6 +36,9 @@
|
|
|
36
36
|
|
|
37
37
|
c. **更新归档状态**
|
|
38
38
|
在归档目录中创建 `archive-info.json`:
|
|
39
|
+
|
|
40
|
+
**注意**:所有时间戳必须使用东八区(北京时间)格式:`yyyy-MM-dd HH:mm:ss`(例如:`2026-02-20 12:36:23`)
|
|
41
|
+
|
|
39
42
|
```json
|
|
40
43
|
{
|
|
41
44
|
"name": "<name>",
|
|
@@ -44,8 +47,7 @@
|
|
|
44
47
|
"originalPath": "6aspecdoc/brown/<name>",
|
|
45
48
|
"archivePath": "6aspecdoc/brown/.archived/<timestamp>-<name>",
|
|
46
49
|
"completedPhases": 7,
|
|
47
|
-
"totalTasks": 8
|
|
48
|
-
"priority": "P0/P1/P2"
|
|
50
|
+
"totalTasks": 8
|
|
49
51
|
}
|
|
50
52
|
```
|
|
51
53
|
|
|
@@ -56,7 +58,6 @@
|
|
|
56
58
|
# 归档摘要:<name>
|
|
57
59
|
|
|
58
60
|
> **归档时间**: <timestamp>
|
|
59
|
-
> **优先级**: P0/P1/P2
|
|
60
61
|
> **完成阶段**: 7/7
|
|
61
62
|
> **总任务数**: 8
|
|
62
63
|
> **总工时**: <工时>
|
|
@@ -80,7 +81,7 @@
|
|
|
80
81
|
- 04-tasks-overview.md - 任务拆解
|
|
81
82
|
- 05-verification-report.md - 验证报告
|
|
82
83
|
- 06-post-implementation-review.md - 实施后评估
|
|
83
|
-
- ADR-<name>.md -
|
|
84
|
+
- ADR-<name>.md - 架构决策记录(如有)
|
|
84
85
|
|
|
85
86
|
## 经验教训
|
|
86
87
|
|
|
@@ -104,7 +105,6 @@
|
|
|
104
105
|
**归档位置**: 6aspecdoc/brown/.archived/<timestamp>-<name>/
|
|
105
106
|
|
|
106
107
|
### 需求统计
|
|
107
|
-
- 优先级:P0/P1/P2
|
|
108
108
|
- 完成阶段:7/7
|
|
109
109
|
- 总任务数:8
|
|
110
110
|
- 总工时:<工时>
|
|
@@ -6,6 +6,17 @@
|
|
|
6
6
|
|
|
7
7
|
**所有生成的文档内容必须使用中文**,包括标题、字段名、描述等所有文本内容。
|
|
8
8
|
|
|
9
|
+
## 时间格式规范
|
|
10
|
+
|
|
11
|
+
**所有时间戳必须使用东八区(北京时间)格式**:`yyyy-MM-dd HH:mm:ss`
|
|
12
|
+
|
|
13
|
+
示例:`2026-02-20 12:36:23`
|
|
14
|
+
|
|
15
|
+
适用范围:
|
|
16
|
+
- status.json 中的 `createdAt`、`lastModified`、`completedAt` 等字段
|
|
17
|
+
- 所有 artifacts 文档中的时间戳(创建时间、完成时间、评估时间等)
|
|
18
|
+
- 归档时使用的时间戳
|
|
19
|
+
|
|
9
20
|
## 核心行为规则
|
|
10
21
|
|
|
11
22
|
1. **阶段化推进**:每个阶段完成后必须停止,等待用户通过显式命令推进
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 棕地需求 - Design SOP
|
|
2
2
|
|
|
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
|
-
-
|
|
13
|
-
|
|
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/
|
|
19
|
-
- `6aspecdoc/brown/<name>/artifacts/
|
|
20
|
-
- `6aspecdoc/brown/<name>/artifacts/
|
|
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.
|
|
57
|
+
7. **架构决策记录(涉及架构决策时创建)**
|
|
50
58
|
|
|
51
|
-
|
|
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/
|
|
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
|
-
##
|
|
202
|
+
## Design 完成:<name>
|
|
117
203
|
|
|
118
|
-
|
|
119
|
-
**进度**: 4/
|
|
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/
|
|
135
|
-
- 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (
|
|
220
|
+
- 6aspecdoc/brown/<name>/artifacts/design.md
|
|
221
|
+
- 6aspecdoc/brown/<name>/artifacts/ADR-<name>.md (如涉及架构决策)
|
|
136
222
|
|
|
137
223
|
### 下一步
|
|
138
|
-
- 直接回复修正设计方案或补充细节 → 我会更新本阶段文档(
|
|
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. 将用户的修正/补充整合到 `
|
|
232
|
+
1. 将用户的修正/补充整合到 `design.md` 的对应章节
|
|
147
233
|
2. 展示变更摘要
|
|
148
234
|
3. 再次提示:可以继续补充,或通过命令进入下一阶段
|
|
149
235
|
4. **禁止**:不得自动进入下一阶段
|
|
150
236
|
|
|
151
237
|
**防护措施**
|
|
152
|
-
-
|
|
153
|
-
-
|
|
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 |
|
|
36
|
-
| fix-login-bug |
|
|
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 |
|
|
40
|
+
| 需求 | 完成时间 | 任务完成率 |
|
|
41
|
+
|------|----------|-----------|
|
|
42
|
+
| add-export-feature | 3天前 | 8/8 (100%) |
|
|
43
43
|
|
|
44
44
|
### 已归档 (3)
|
|
45
45
|
|
|
46
|
-
| 需求 |
|
|
47
|
-
|
|
48
|
-
| refactor-api |
|
|
49
|
-
| update-ui |
|
|
50
|
-
| fix-typo |
|
|
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
|
-
|
|
3
|
+
快速通道 - 适用于简单修复和小改动。
|
|
4
4
|
|
|
5
5
|
**输入**:`/6aspec:brown:quick` 后的参数是需求名称(kebab-case)或需求描述。
|
|
6
6
|
|
|
@@ -27,10 +27,12 @@ P2 需求快速通道 - 适用于简单修复和小改动。
|
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
创建状态文件 `6aspecdoc/brown/<name>/status.json`:
|
|
30
|
+
|
|
31
|
+
**注意**:所有时间戳必须使用东八区(北京时间)格式:`yyyy-MM-dd HH:mm:ss`(例如:`2026-02-20 12:36:23`)
|
|
32
|
+
|
|
30
33
|
```json
|
|
31
34
|
{
|
|
32
35
|
"name": "<name>",
|
|
33
|
-
"priority": "P2",
|
|
34
36
|
"status": "quick_track",
|
|
35
37
|
"createdAt": "<timestamp>",
|
|
36
38
|
"lastModified": "<timestamp>",
|
|
@@ -43,7 +45,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
|
|
|
43
45
|
# <需求标题>
|
|
44
46
|
|
|
45
47
|
> **需求ID**: <name>
|
|
46
|
-
> **优先级**: P2(快速通道)
|
|
47
48
|
> **状态**: 🚀 快速处理中
|
|
48
49
|
> **创建时间**: <timestamp>
|
|
49
50
|
|
|
@@ -102,7 +103,6 @@ P2 需求快速通道 - 适用于简单修复和小改动。
|
|
|
102
103
|
```
|
|
103
104
|
## 快速处理完成:<name>
|
|
104
105
|
|
|
105
|
-
**优先级**: P2(快速通道)
|
|
106
106
|
**处理时间**: <时间戳>
|
|
107
107
|
|
|
108
108
|
### 修改内容
|
|
@@ -118,7 +118,7 @@ P2 需求快速通道 - 适用于简单修复和小改动。
|
|
|
118
118
|
- 或归档:运行 `/6aspec:brown:archive` 归档此需求
|
|
119
119
|
|
|
120
120
|
### 注意
|
|
121
|
-
|
|
121
|
+
快速通道跳过了详细的分析和设计阶段。
|
|
122
122
|
如果发现需求比预期复杂,建议使用完整流程(/6aspec:brown:new)。
|
|
123
123
|
```
|
|
124
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` -
|
|
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
|
-
|
|
63
|
+
**架构决策回顾**(如有):
|
|
64
64
|
- 当初的架构决策是否正确?
|
|
65
65
|
- 有哪些经验教训?
|
|
66
66
|
- 需要更新 ADR 吗?
|
|
@@ -144,7 +144,7 @@ Phase 7: 实施后评估
|
|
|
144
144
|
调整计划(如需要):
|
|
145
145
|
<调整计划>
|
|
146
146
|
|
|
147
|
-
## 3.
|
|
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
|
-
-
|
|
269
|
+
- 涉及架构决策的需求必须回顾架构决策
|
|
270
270
|
- 必须进行知识沉淀
|
|
@@ -133,8 +133,8 @@
|
|
|
133
133
|
"name": "example",
|
|
134
134
|
"flowDepth": "standard",
|
|
135
135
|
"status": "tasks_pending",
|
|
136
|
-
"createdAt": "2026-02-
|
|
137
|
-
"lastModified": "2026-02-
|
|
136
|
+
"createdAt": "2026-02-15 18:00:00",
|
|
137
|
+
"lastModified": "2026-02-15 18:30:00",
|
|
138
138
|
"phases": {
|
|
139
139
|
"understand": "done",
|
|
140
140
|
"specs": "done",
|