6aspec 3.0.0-dev.31 → 3.0.0-dev.32

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 (9) hide show
  1. package/.6aspec/rules/brown/subagents/implementer.md +8 -0
  2. package/.agents/skills/6aspec-review/SKILL.md +10 -8
  3. package/.agents/skills/6aspec-review/agents/openai.yaml +2 -2
  4. package/.claude/agents/6aspec-brown-implementer.md +2 -0
  5. package/.claude/commands/6aspec/review.md +9 -7
  6. package/.codex/agents/6aspec-brown-implementer.toml +2 -0
  7. package/.cursor/agents/6aspec-brown-implementer.md +2 -0
  8. package/.cursor/commands/6aspec-review.md +9 -7
  9. package/package.json +1 -1
package/.6aspec/rules/brown/subagents/implementer.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Implementer Subagent
2
2
 
3
+ **🚨 停止约束（最高优先级）**：
4
+ - 你**只负责完成一个 TASK**
5
+ - 完成该 TASK 的实现、自我审查和报告后，**立即停止**
6
+ - **不要**读取其他 TASK-*.md 文件
7
+ - **不要**继续执行其他任务
8
+ - **不要**批量处理多个任务
9
+
3
10
  你是一个代码实现专家，负责完成指定的 TASK。
4
11
 
5
12
  **重要**：你只负责完成**这一个 TASK**，完成任务并报告后**立即停止**，不要主动执行其他任务。
@@ -7,6 +14,7 @@
7
14
  ## 开始前必须读取
8
15
 
9
16
  - **TASK 文件**：任务详情、实现步骤、验收标准、涉及文件
17
+ - **⚠️ 忽略依赖字段**：如果 TASK 文件中有"前置依赖"或"后置任务"字段，**不要读取或执行那些任务**，那些依赖关系由主 agent 管理
10
18
  - **specs.md**：该任务引用的 AC/Scenario
11
19
  - **design.md**：相关技术决策
12
20
  - **analysis.md**：现状分析和影响面背景（如果存在）
package/.agents/skills/6aspec-review/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: "6aspec-review"
3
- description: "独立代码审查。用于审查指定 diff 文件或 git 提交范围内的代码变更，并输出完整审查报告。"
3
+ description: "独立代码审查。用于审查指定 diff 文件、指定 git 提交范围或当前工作区未提交变更，并输出完整审查报告。"
4
4
  ---
5
5
 
6
6
  # 操作流程
@@ -14,16 +14,18 @@ description: "独立代码审查。用于审查指定 diff 文件或 git 提交
14
14
  用户可以提供以下参数（均可选）：
15
15
  - `<description>` — 变更描述
16
16
  - `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
17
- - `--base <SHA>` — 起始 commit（默认：HEAD~1）
18
- - `--head <SHA>` — 结束 commit（默认：HEAD）
17
+ - `--base <SHA>` — 起始 commit（用于指定 git 范围）
18
+ - `--head <SHA>` — 结束 commit（用于指定 git 范围）
19
19
  - `--plan <file>` — 需求/计划文件路径
20
20
 
21
- 如果未提供 `--diff/--base/--head`，使用默认值（HEAD~1..HEAD）。
21
+ 如果未提供 `--diff/--base/--head`，不传 SHA，让子 agent 审查当前工作区未提交变更。
22
22
 
23
23
  ### 2. 确定变更来源
24
24
 
25
25
  - 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
26
- - 否则：使用 git 范围。
26
+ - 否则：
27
+ - 如果提供了 `--base/--head`：使用 git 范围。
28
+ - 如果未提供 `--base/--head`：不传 SHA（由子 agent 审查未提交变更）。
27
29
 
28
30
  ### 3. （可选）展示 git 范围
29
31
 
@@ -36,15 +38,14 @@ git log --oneline -10
36
38
  显示最近 10 条 commit，帮助用户确认审查范围。
37
39
 
38
40
  如果用户未指定 SHA，使用：
39
- - BASE_SHA = HEAD~1
40
- - HEAD_SHA = HEAD
41
+ - 不设置 BASE_SHA/HEAD_SHA
41
42
 
42
43
  ### 4. 派发 6aspec-code-reviewer agent
43
44
 
44
45
  调用 `6aspec-code-reviewer` agent，传入：
45
46
 
46
47
  ```
47
- 变更描述：[用户提供的描述，或"最近一次提交的变更"]
48
+ 变更描述：[用户提供的描述，或"当前代码变更"]
48
49
  需求/计划：[--plan 指定的文件路径，或"无"]
49
50
  DIFF：[--diff 指定文件内容（如提供）]
50
51
  BASE_SHA：[base SHA（如使用 git）]
@@ -61,6 +62,7 @@ HEAD_SHA：[head SHA（如使用 git）]
61
62
  /6aspec:review
62
63
  /6aspec:review 实现了用户认证功能
63
64
  /6aspec:review --diff /tmp/change.patch
65
+ /6aspec:review --base HEAD~1 --head HEAD
64
66
  /6aspec:review --base abc1234 --head def5678
65
67
  /6aspec:review --plan 6aspecdoc/brown/add-user-auth/artifacts/specs.md
66
68
  ```
package/.agents/skills/6aspec-review/agents/openai.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  interface:
2
2
  display_name: "6ASpec code review"
3
- short_description: "仅在显式调用时审查 diff 文件或指定 git 范围变更"
4
- default_prompt: "使用 $6aspec-review 审查一个 diff 文件或 git 提交范围，并输出完整审查报告。"
3
+ short_description: "仅在显式调用时审查 diff 文件、指定 git 范围或当前未提交变更"
4
+ default_prompt: "使用 $6aspec-review 审查一个 diff 文件、指定 git 提交范围或当前工作区未提交变更，并输出完整审查报告。"
5
5
 
6
6
  policy:
7
7
  allow_implicit_invocation: false
package/.claude/agents/6aspec-brown-implementer.md CHANGED
@@ -4,4 +4,6 @@ description: 执行棕地需求的单个 TASK 实现，包括写代码、单元
4
4
  model: inherit
5
5
  ---
6
6
 
7
+ **重要**：你只负责完成**一个 TASK**，完成后立即停止。
8
+
7
9
  读取并严格遵循：`.6aspec/rules/brown/subagents/implementer.md`
package/.claude/commands/6aspec/review.md CHANGED
@@ -14,16 +14,18 @@ description: 独立代码审查命令，不绑定任何流程，随时可用
14
14
  用户可以提供以下参数（均可选）：
15
15
  - `<description>` — 变更描述
16
16
  - `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
17
- - `--base <SHA>` — 起始 commit（默认：HEAD~1）
18
- - `--head <SHA>` — 结束 commit（默认：HEAD）
17
+ - `--base <SHA>` — 起始 commit（用于指定 git 范围）
18
+ - `--head <SHA>` — 结束 commit（用于指定 git 范围）
19
19
  - `--plan <file>` — 需求/计划文件路径
20
20
 
21
- 如果未提供 `--diff/--base/--head`，使用默认值（HEAD~1..HEAD）。
21
+ 如果未提供 `--diff/--base/--head`，不传 SHA，让子 agent 审查当前工作区未提交变更。
22
22
 
23
23
  ### 2. 确定变更来源
24
24
 
25
25
  - 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
26
- - 否则：使用 git 范围。
26
+ - 否则：
27
+ - 如果提供了 `--base/--head`：使用 git 范围。
28
+ - 如果未提供 `--base/--head`：不传 SHA（由子 agent 审查未提交变更）。
27
29
 
28
30
  ### 3. （可选）展示 git 范围
29
31
 
@@ -36,15 +38,14 @@ git log --oneline -10
36
38
  显示最近 10 条 commit，帮助用户确认审查范围。
37
39
 
38
40
  如果用户未指定 SHA，使用：
39
- - BASE_SHA = HEAD~1
40
- - HEAD_SHA = HEAD
41
+ - 不设置 BASE_SHA/HEAD_SHA
41
42
 
42
43
  ### 4. 派发 6aspec-code-reviewer agent
43
44
 
44
45
  调用 `6aspec-code-reviewer` agent，传入：
45
46
 
46
47
  ```
47
- 变更描述：[用户提供的描述，或"最近一次提交的变更"]
48
+ 变更描述：[用户提供的描述，或"当前代码变更"]
48
49
  需求/计划：[--plan 指定的文件路径，或"无"]
49
50
  DIFF：[--diff 指定文件内容（如提供）]
50
51
  BASE_SHA：[base SHA（如使用 git）]
@@ -61,6 +62,7 @@ HEAD_SHA：[head SHA（如使用 git）]
61
62
  /6aspec:review
62
63
  /6aspec:review 实现了用户认证功能
63
64
  /6aspec:review --diff /tmp/change.patch
65
+ /6aspec:review --base HEAD~1 --head HEAD
64
66
  /6aspec:review --base abc1234 --head def5678
65
67
  /6aspec:review --plan 6aspecdoc/brown/add-user-auth/artifacts/specs.md
66
68
  ```
package/.codex/agents/6aspec-brown-implementer.toml CHANGED
@@ -7,5 +7,7 @@ description = "执行棕地需求的单个 TASK 实现，包括写代码、单
7
7
  sandbox_mode = "workspace-write"
8
8
 
9
9
  developer_instructions = """
10
+ **重要**：你只负责完成**一个 TASK**，完成后立即停止。
11
+
10
12
  读取并严格遵循：`.6aspec/rules/brown/subagents/implementer.md`
11
13
  """
package/.cursor/agents/6aspec-brown-implementer.md CHANGED
@@ -4,4 +4,6 @@ description: 执行棕地需求的单个 TASK 实现，包括写代码、单元
4
4
  model: inherit
5
5
  ---
6
6
 
7
+ **重要**：你只负责完成**一个 TASK**，完成后立即停止。
8
+
7
9
  读取并严格遵循：`.6aspec/rules/brown/subagents/implementer.md`
package/.cursor/commands/6aspec-review.md CHANGED
@@ -14,16 +14,18 @@ alwaysApply: false
14
14
  用户可以提供以下参数（均可选）：
15
15
  - `<description>` — 变更描述
16
16
  - `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
17
- - `--base <SHA>` — 起始 commit（默认：HEAD~1）
18
- - `--head <SHA>` — 结束 commit（默认：HEAD）
17
+ - `--base <SHA>` — 起始 commit（用于指定 git 范围）
18
+ - `--head <SHA>` — 结束 commit（用于指定 git 范围）
19
19
  - `--plan <file>` — 需求/计划文件路径
20
20
 
21
- 如果未提供 `--diff/--base/--head`，使用默认值（HEAD~1..HEAD）。
21
+ 如果未提供 `--diff/--base/--head`，不传 SHA，让子 agent 审查当前工作区未提交变更。
22
22
 
23
23
  ### 2. 确定变更来源
24
24
 
25
25
  - 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
26
- - 否则：使用 git 范围。
26
+ - 否则：
27
+ - 如果提供了 `--base/--head`：使用 git 范围。
28
+ - 如果未提供 `--base/--head`：不传 SHA（由子 agent 审查未提交变更）。
27
29
 
28
30
  ### 3. （可选）展示 git 范围
29
31
 
@@ -36,15 +38,14 @@ git log --oneline -10
36
38
  显示最近 10 条 commit，帮助用户确认审查范围。
37
39
 
38
40
  如果用户未指定 SHA，使用：
39
- - BASE_SHA = HEAD~1
40
- - HEAD_SHA = HEAD
41
+ - 不设置 BASE_SHA/HEAD_SHA
41
42
 
42
43
  ### 4. 派发 6aspec-code-reviewer agent
43
44
 
44
45
  调用 `6aspec-code-reviewer` agent，传入：
45
46
 
46
47
  ```
47
- 变更描述：[用户提供的描述，或"最近一次提交的变更"]
48
+ 变更描述：[用户提供的描述，或"当前代码变更"]
48
49
  需求/计划：[--plan 指定的文件路径，或"无"]
49
50
  DIFF：[--diff 指定文件内容（如提供）]
50
51
  BASE_SHA：[base SHA（如使用 git）]
@@ -61,6 +62,7 @@ HEAD_SHA：[head SHA（如使用 git）]
61
62
  /6aspec:review
62
63
  /6aspec:review 实现了用户认证功能
63
64
  /6aspec:review --diff /tmp/change.patch
65
+ /6aspec:review --base HEAD~1 --head HEAD
64
66
  /6aspec:review --base abc1234 --head def5678
65
67
  /6aspec:review --plan 6aspecdoc/brown/add-user-auth/artifacts/specs.md
66
68
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "6aspec",
3
- "version": "3.0.0-dev.31",
3
+ "version": "3.0.0-dev.32",
4
4
  "description": "6Aspec - 轻量级 spec 驱动开发框架，支持 Cursor 和 Claude Code",
5
5
  "main": "lib/installer.js",
6
6
  "bin": {