6aspec 3.0.0-dev.1 → 3.0.0-dev.3

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.
@@ -16,7 +16,7 @@
16
16
 
17
17
  如果提供了名称,使用它。否则:
18
18
  - 从对话上下文推断
19
- - 如果模糊,读取 `6aspecdoc/brown/` 目录,让用户选择
19
+ - 如果模糊,读取 `6aspecdoc/brown/` 目录,使用 `AskUserQuestion` 工具列出需求让用户选择
20
20
 
21
21
  读取 `6aspecdoc/brown/<name>/status.json`:
22
22
  - 确认流程深度为 "standard" 或 "complete"
@@ -18,9 +18,10 @@
18
18
 
19
19
  2. **确认归档**
20
20
 
21
- 询问用户确认:
21
+ 使用 `AskUserQuestion` 工具确认:
22
22
  ```
23
- 确认归档需求 <name>?归档后需求将移至归档目录,操作不可逆。
23
+ 问题:"确认归档需求 <name>?归档后需求将移至归档目录,操作不可逆。"
24
+ 选项:
24
25
  - 是,归档此需求
25
26
  - 否,取消归档
26
27
  ```
@@ -10,9 +10,7 @@
10
10
 
11
11
  如果提供了名称,使用它。否则:
12
12
  - 从对话上下文推断
13
- - 如果模糊,读取 `6aspecdoc/brown/` 目录,让用户选择
14
-
15
- 显示最近修改的 3-4 个需求作为选项,标注最近修改的为 "(推荐)"。
13
+ - 如果模糊,读取 `6aspecdoc/brown/` 目录,使用 `AskUserQuestion` 工具列出最近修改的 3-4 个需求让用户选择,标注最近修改的为 "(推荐)"。
16
14
 
17
15
  2. **检查当前状态**
18
16
 
@@ -78,7 +78,8 @@
78
78
 
79
79
  **处理 review 结果**:
80
80
  - `✅ 通过`:标记任务完成,继续下一个任务
81
- - `❌ 有问题`:重新调用 implementer agent 修复,传入原有上下文 + reviewer 的完整反馈(具体缺失/多余/偏差及文件路径);修复后再次调用 reviewer;循环直到通过
81
+ - `❌ 有问题`:重新调用 implementer agent 修复,传入原有上下文 + reviewer 的完整反馈(具体缺失/多余/偏差及文件路径);修复后再次调用 reviewer;**最多循环 3 次**
82
+ - **超过 3 次仍未通过**:暂停,向用户报告每轮的问题和修复情况,让用户决定如何处理
82
83
 
83
84
  **c. 标记任务完成**
84
85
  - 在任务文件中更新状态:`📋 待开始` → `✅ 已完成`
@@ -159,5 +160,6 @@
159
160
  - 串行执行,不并行调用多个 implementer agent
160
161
  - implementer agent 报告 BLOCKED 时必须暂停并向用户报告,不得强行重试
161
162
  - spec compliance review 必须通过才能标记任务完成,不得跳过
163
+ - implementer + reviewer 修复循环最多 3 次,超过则暂停向用户报告
162
164
  - 发现设计问题时暂停,建议更新 artifacts(design/specs/tasks),不得在实现阶段临时发明新方案
163
165
  - 立即更新任务状态(TASK 文件、tasks-overview、status.json)
@@ -13,8 +13,12 @@
13
13
 
14
14
  根据用户输入判断类型:
15
15
 
16
- **情况A:无输入** — 询问用户(开放式问题):
17
- > "你想分析什么需求?请描述要实现的功能或要解决的问题,也可以 @引用 一个需求文档。"
16
+ **情况A:无输入** — 使用 `AskUserQuestion` 工具询问:
17
+ ```
18
+ 问题:"你想分析什么需求?"
19
+ 选项(Other 即可,无需固定选项)
20
+ ```
21
+ 或直接用开放式文本输入(Other)让用户描述需求。
18
22
 
19
23
  **情况B:直接文字描述** — 记录原始描述文本,标记 `inputSource.type = "text"`。
20
24
 
@@ -26,13 +30,13 @@
26
30
 
27
31
  2. **选择流程深度**
28
32
 
29
- 让用户选择流程深度:
33
+ 使用 `AskUserQuestion` 工具让用户选择流程深度:
30
34
  ```
31
35
  问题:"请选择适合的流程深度:"
32
36
  选项:
33
- - 轻量级 - 无需分析现有系统(proposal → specs → design → tasks)(推荐用于与现有业务低耦合的需求)
34
- - 标准级 - 深入分析(analyze → proposal → specs → design → tasks)(推荐用于需要分析现有业务影响面的需求)
35
- - 快速通道 - 简单修复(直接实现,适用于Bug修复、单文件改动)
37
+ - 轻量级(推荐)- 无需分析现有系统(proposal → specs → design → tasks),适用于与现有业务低耦合的需求
38
+ - 标准级 - 深入分析(analyze → proposal → specs → design → tasks),适用于需要分析现有业务影响面的需求
39
+ - 快速通道 - 简单修复(直接实现),适用于 Bug 修复、单文件改动
36
40
  ```
37
41
 
38
42
  **流程深度说明**:
@@ -15,7 +15,7 @@
15
15
 
16
16
  1. **如果没有提供输入,询问需求内容**
17
17
 
18
- 询问用户:
18
+ 使用 `AskUserQuestion` 工具询问(开放式,用 Other 输入):
19
19
  > "你想快速处理什么需求?请描述要修复的问题或要做的改动。"
20
20
 
21
21
  从描述中提取 kebab-case 名称。
@@ -23,7 +23,7 @@
23
23
 
24
24
  如果提供了名称,使用它。否则:
25
25
  - 从对话上下文推断
26
- - 如果模糊,读取 `6aspecdoc/brown/` 目录,让用户选择
26
+ - 如果模糊,读取 `6aspecdoc/brown/` 目录,使用 `AskUserQuestion` 工具列出需求让用户选择
27
27
 
28
28
  2. **检查当前状态**
29
29
 
@@ -56,13 +56,9 @@
56
56
 
57
57
  4. **确认回退操作**
58
58
 
59
- 询问用户确认:
59
+ 使用 `AskUserQuestion` 工具确认:
60
60
  ```
61
- 确认回退操作?
62
- - 当前阶段:<current-phase>
63
- - 回退到:<previous-phase>
64
- - 将删除的文件:<files-to-delete>
65
-
61
+ 问题:"确认回退操作?当前阶段:<current-phase>,将回退到:<previous-phase>,将删除:<files-to-delete>"
66
62
  选项:
67
63
  - 确认回退
68
64
  - 取消
@@ -41,7 +41,7 @@
41
41
 
42
42
  如果提供了名称,使用它。否则:
43
43
  - 从对话上下文推断
44
- - 如果模糊,读取 `6aspecdoc/brown/` 目录,让用户选择
44
+ - 如果模糊,读取 `6aspecdoc/brown/` 目录,使用 `AskUserQuestion` 工具列出需求让用户选择
45
45
 
46
46
  2. **处理特殊选项**
47
47
 
@@ -70,15 +70,10 @@
70
70
 
71
71
  5. **获取用户修改需求**
72
72
 
73
- 询问用户要修改的内容:
73
+ 使用 `AskUserQuestion` 工具询问(开放式,用 Other 输入):
74
74
  ```
75
75
  问题:"请描述您要对 <phase> 阶段文档进行的修改:"
76
-
77
- 提示:
78
- - 请具体描述要修改、补充或调整的内容
79
- - 如果是补充信息,请说明要补充什么
80
- - 如果是修正错误,请说明错误的地方和正确的内容
81
- - 如果是调整描述,请说明要如何调整
76
+ 提示:具体描述要修改、补充或调整的内容
82
77
  ```
83
78
 
84
79
  6. **执行更新(根据模式)**
@@ -123,7 +118,7 @@
123
118
  - 建议:<执行建议>
124
119
  ```
125
120
 
126
- d. **等待用户确认**:
121
+ d. **使用 `AskUserQuestion` 工具等待用户确认**:
127
122
  ```
128
123
  问题:"是否执行上述更新计划?"
129
124
  选项:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "6aspec",
3
- "version": "3.0.0-dev.1",
3
+ "version": "3.0.0-dev.3",
4
4
  "description": "6Aspec - 轻量级 spec 驱动开发框架,支持 Cursor 和 Claude Code",
5
5
  "main": "lib/installer.js",
6
6
  "bin": {