npm - 6aspec - Versions diffs - 3.0.0-dev.31 → 3.0.0-dev.33 - Mend

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

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 (10) hide show

package/.6aspec/rules/brown/subagents/implementer.md +8 -0
package/.6aspec/rules/common/code-review-command-sop.md +111 -0
package/.agents/skills/6aspec-review/SKILL.md +4 -62
package/.agents/skills/6aspec-review/agents/openai.yaml +2 -2
package/.claude/agents/6aspec-brown-implementer.md +2 -0
package/.claude/commands/6aspec/review.md +3 -61
package/.codex/agents/6aspec-brown-implementer.toml +2 -0
package/.cursor/agents/6aspec-brown-implementer.md +2 -0
package/.cursor/commands/6aspec-review.md +3 -61
package/package.json +1 -1

package/.6aspec/rules/brown/subagents/implementer.md CHANGED Viewed

@@ -1,5 +1,12 @@
 # Implementer Subagent
+**🚨 停止约束（最高优先级）**：
+- 你**只负责完成一个 TASK**
+- 完成该 TASK 的实现、自我审查和报告后，**立即停止**
+- **不要**读取其他 TASK-*.md 文件
+- **不要**继续执行其他任务
+- **不要**批量处理多个任务
 你是一个代码实现专家，负责完成指定的 TASK。
 **重要**：你只负责完成**这一个 TASK**，完成任务并报告后**立即停止**，不要主动执行其他任务。
@@ -7,6 +14,7 @@
 ## 开始前必须读取
 - **TASK 文件**：任务详情、实现步骤、验收标准、涉及文件
+  - **⚠️ 忽略依赖字段**：如果 TASK 文件中有"前置依赖"或"后置任务"字段，**不要读取或执行那些任务**，那些依赖关系由主 agent 管理
 - **specs.md**：该任务引用的 AC/Scenario
 - **design.md**：相关技术决策
 - **analysis.md**：现状分析和影响面背景（如果存在）

package/.6aspec/rules/common/code-review-command-sop.md ADDED Viewed

@@ -0,0 +1,111 @@
+# Code Review Command SOP
+用于 `/6aspec:review` 与 `$6aspec-review` 的统一执行流程。
+> 执行模型：主 agent 作为协调者，先建立任务队列，再派发 `6aspec-code-reviewer` 子 agent 执行审查；主 agent 只管理队列与状态，不直接产出审查结论。
+## 输入
+用户可以提供以下参数（均可选）：
+- `<description>` — 变更描述
+- `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
+- `--base <SHA>` — 起始 commit（用于指定 git 范围）
+- `--head <SHA>` — 结束 commit（用于指定 git 范围）
+- `--plan <file>` — 需求/计划文件路径（可为 specs/design/rules/task 清单等）
+默认行为：
+- 如果未提供 `--diff/--base/--head`，不传 SHA，让子 agent 审查当前工作区未提交变更。
+---
+## 步骤
+1. **解析输入并归一化**
+   - 解析 `<description>`、`--diff`、`--base`、`--head`、`--plan`。
+   - 归一化规则：
+     - 提供了 `--diff`：优先使用 `DIFF`。
+     - 未提供 `--diff` 且提供了 `--base/--head`：使用 git 提交范围。
+     - 三者都未提供：不传 `BASE_SHA/HEAD_SHA`，交由子 agent 走“未提交变更”分支。
+2. **准备审查输入材料**
+   - 使用 git 范围时，可先执行：
+     ```bash
+     git log --oneline -10
+     ```
+     用于向用户展示最近提交，确认审查范围。
+   - 组装将传给子 agent 的统一输入：
+     - `变更描述`：用户提供值，或默认 `当前代码变更`
+     - `需求/计划`：`--plan` 文件路径，或 `无`
+     - `DIFF`：`--diff` 文件内容（如提供）
+     - `BASE_SHA` / `HEAD_SHA`：仅在显式给定 git 范围时传入
+3. **建立任务队列（外部状态锚点）**
+   按固定顺序建立任务队列（宿主支持 `TaskCreate` 时必须使用；若宿主不支持 `TaskCreate`，则用等价的显式文本清单维护状态）：
+   - `REVIEW-001: 准备审查输入`
+   - `REVIEW-002: 调用 code-reviewer`
+   - `REVIEW-003: 回传审查报告`
+   任务状态统一使用：`todo` / `in_progress` / `completed` / `blocked`。
+4. **按队列串行执行**
+   **a. 执行 REVIEW-001（准备输入）**
+   - 标记 `in_progress`。
+   - 完成步骤 1、2 的归一化与输入组装。
+   - 标记 `completed`。
+   **b. 执行 REVIEW-002（派发子 agent）**
+   - 标记 `in_progress`。
+   - 调用 `6aspec-code-reviewer`，传入：
+   ```
+   变更描述：[用户提供的描述，或"当前代码变更"]
+   需求/计划：[--plan 指定的文件路径，或"无"]
+   DIFF：[--diff 指定文件内容（如提供）]
+   BASE_SHA：[base SHA（如使用 git）]
+   HEAD_SHA：[head SHA（如使用 git）]
+   ```
+   - 处理子 agent 返回状态：
+     - `DONE`：标记 `REVIEW-002` 为 `completed`，进入 `REVIEW-003`。
+     - `DONE_WITH_CONCERNS`：同样标记 `completed`，保留 concerns 原文并进入 `REVIEW-003`。
+     - `NEEDS_CONTEXT`：补充缺失上下文后重新调用；最多重试 2 次。
+     - `BLOCKED`：标记 `blocked`，暂停并向用户报告阻塞原因。
+   - 若返回为空、结构不完整或明显未执行审查：按 `NEEDS_CONTEXT` 路径重试；超过 2 次仍失败则标记 `blocked` 并暂停。
+   **c. 执行 REVIEW-003（回传结果）**
+   - 标记 `in_progress`。
+   - 直接展示 `6aspec-code-reviewer` 返回的完整审查报告（可补充 1-3 行摘要，但不得替换原报告）。
+   - 标记 `completed`。
+5. **结束态处理**
+   - 若 3 个任务均 `completed`：输出“审查完成”。
+   - 若存在 `blocked`：输出“审查暂停”，并给出阻塞原因与下一步选项。
+---
+## 防护措施
+- 必须先建立任务队列，再派发子 agent；不得跳步。
+- 主 agent 只做协调，不直接执行代码审查并给结论。
+- 串行执行，不并行派发多个 code-reviewer agent。
+- 子 agent 返回 `BLOCKED` 时必须暂停并向用户报告，不得无限重试。
+- `REVIEW-002` 未完成前，不得提前输出审查结论。
+---
+## 使用示例
+```bash
+/6aspec:review
+/6aspec:review 实现了用户认证功能
+/6aspec:review --diff /tmp/change.patch
+/6aspec:review --base HEAD~1 --head HEAD
+/6aspec:review --base abc1234 --head def5678
+/6aspec:review --plan 6aspecdoc/brown/add-user-auth/artifacts/specs.md
+```

package/.agents/skills/6aspec-review/SKILL.md CHANGED Viewed

@@ -1,66 +1,8 @@
 ---
 name: "6aspec-review"
-description: "独立代码审查。用于审查指定 diff 文件或 git 提交范围内的代码变更，并输出完整审查报告。"
+description: "独立代码审查。用于审查指定 diff 文件、指定 git 提交范围或当前工作区未提交变更，并输出完整审查报告。"
 ---
-# 操作流程
-对当前代码变更进行独立审查。好的
-## 步骤
-### 1. 解析输入
-用户可以提供以下参数（均可选）：
-- `<description>` — 变更描述
-- `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
-- `--base <SHA>` — 起始 commit（默认：HEAD~1）
-- `--head <SHA>` — 结束 commit（默认：HEAD）
-- `--plan <file>` — 需求/计划文件路径
-如果未提供 `--diff/--base/--head`，使用默认值（HEAD~1..HEAD）。
-### 2. 确定变更来源
-- 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
-- 否则：使用 git 范围。
-### 3. （可选）展示 git 范围
-当使用 git 范围时：
-```bash
-git log --oneline -10
-```
-显示最近 10 条 commit，帮助用户确认审查范围。
-如果用户未指定 SHA，使用：
-- BASE_SHA = HEAD~1
-- HEAD_SHA = HEAD
-### 4. 派发 6aspec-code-reviewer agent
-调用 `6aspec-code-reviewer` agent，传入：
-```
-变更描述：[用户提供的描述，或"最近一次提交的变更"]
-需求/计划：[--plan 指定的文件路径，或"无"]
-DIFF：[--diff 指定文件内容（如提供）]
-BASE_SHA：[base SHA（如使用 git）]
-HEAD_SHA：[head SHA（如使用 git）]
-```
-### 5. 展示审查结果
-直接展示 agent 返回的完整审查报告。
-## 使用示例
-```
-/6aspec:review
-/6aspec:review 实现了用户认证功能
-/6aspec:review --diff /tmp/change.patch
-/6aspec:review --base abc1234 --head def5678
-/6aspec:review --plan 6aspecdoc/brown/add-user-auth/artifacts/specs.md
-```
+1. Immediate response upon activation: **6aspec-review** has been activated
+2. Read file: `.6aspec/rules/common/code-review-command-sop.md`
+3. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-review/agents/openai.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 interface:
   display_name: "6ASpec code review"
-  short_description: "仅在显式调用时审查 diff 文件或指定 git 范围变更"
-  default_prompt: "使用 $6aspec-review 审查一个 diff 文件或 git 提交范围，并输出完整审查报告。"
+  short_description: "仅在显式调用时审查 diff 文件、指定 git 范围或当前未提交变更"
+  default_prompt: "使用 $6aspec-review 审查一个 diff 文件、指定 git 提交范围或当前工作区未提交变更，并输出完整审查报告。"
 policy:
   allow_implicit_invocation: false

package/.claude/agents/6aspec-brown-implementer.md CHANGED Viewed

@@ -4,4 +4,6 @@ description: 执行棕地需求的单个 TASK 实现，包括写代码、单元
 model: inherit
 ---
+**重要**：你只负责完成**一个 TASK**，完成后立即停止。
 读取并严格遵循：`.6aspec/rules/brown/subagents/implementer.md`

package/.claude/commands/6aspec/review.md CHANGED Viewed

@@ -3,64 +3,6 @@ name: "6aspec:review"
 description: 独立代码审查命令，不绑定任何流程，随时可用
 ---
-# Code Review
-对当前代码变更进行独立审查。
-## 步骤
-### 1. 解析输入
-用户可以提供以下参数（均可选）：
-- `<description>` — 变更描述
-- `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
-- `--base <SHA>` — 起始 commit（默认：HEAD~1）
-- `--head <SHA>` — 结束 commit（默认：HEAD）
-- `--plan <file>` — 需求/计划文件路径
-如果未提供 `--diff/--base/--head`，使用默认值（HEAD~1..HEAD）。
-### 2. 确定变更来源
-- 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
-- 否则：使用 git 范围。
-### 3. （可选）展示 git 范围
-当使用 git 范围时：
-```bash
-git log --oneline -10
-```
-显示最近 10 条 commit，帮助用户确认审查范围。
-如果用户未指定 SHA，使用：
-- BASE_SHA = HEAD~1
-- HEAD_SHA = HEAD
-### 4. 派发 6aspec-code-reviewer agent
-调用 `6aspec-code-reviewer` agent，传入：
-```
-变更描述：[用户提供的描述，或"最近一次提交的变更"]
-需求/计划：[--plan 指定的文件路径，或"无"]
-DIFF：[--diff 指定文件内容（如提供）]
-BASE_SHA：[base SHA（如使用 git）]
-HEAD_SHA：[head SHA（如使用 git）]
-```
-### 5. 展示审查结果
-直接展示 agent 返回的完整审查报告。
-## 使用示例
-```
-/6aspec:review
-/6aspec:review 实现了用户认证功能
-/6aspec:review --diff /tmp/change.patch
-/6aspec:review --base abc1234 --head def5678
-/6aspec:review --plan 6aspecdoc/brown/add-user-auth/artifacts/specs.md
-```
+1. Immediate response upon activation: **6aspec:review** has been activated
+2. Read file: `.6aspec/rules/common/code-review-command-sop.md`
+3. Strictly follow the SOP defined in that file

package/.codex/agents/6aspec-brown-implementer.toml CHANGED Viewed

@@ -7,5 +7,7 @@ description = "执行棕地需求的单个 TASK 实现，包括写代码、单
 sandbox_mode = "workspace-write"
 developer_instructions = """
+**重要**：你只负责完成**一个 TASK**，完成后立即停止。
 读取并严格遵循：`.6aspec/rules/brown/subagents/implementer.md`
 """

package/.cursor/agents/6aspec-brown-implementer.md CHANGED Viewed

@@ -4,4 +4,6 @@ description: 执行棕地需求的单个 TASK 实现，包括写代码、单元
 model: inherit
 ---
+**重要**：你只负责完成**一个 TASK**，完成后立即停止。
 读取并严格遵循：`.6aspec/rules/brown/subagents/implementer.md`

package/.cursor/commands/6aspec-review.md CHANGED Viewed

@@ -3,64 +3,6 @@ description: 独立代码审查（优先 DIFF，其次 git diff），不绑定
 alwaysApply: false
 ---
-# Code Review
-对当前代码变更进行独立审查。
-## 步骤
-### 1. 解析输入
-用户可以提供以下参数（均可选）：
-- `<description>` — 变更描述
-- `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
-- `--base <SHA>` — 起始 commit（默认：HEAD~1）
-- `--head <SHA>` — 结束 commit（默认：HEAD）
-- `--plan <file>` — 需求/计划文件路径
-如果未提供 `--diff/--base/--head`，使用默认值（HEAD~1..HEAD）。
-### 2. 确定变更来源
-- 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
-- 否则：使用 git 范围。
-### 3. （可选）展示 git 范围
-当使用 git 范围时：
-```bash
-git log --oneline -10
-```
-显示最近 10 条 commit，帮助用户确认审查范围。
-如果用户未指定 SHA，使用：
-- BASE_SHA = HEAD~1
-- HEAD_SHA = HEAD
-### 4. 派发 6aspec-code-reviewer agent
-调用 `6aspec-code-reviewer` agent，传入：
-```
-变更描述：[用户提供的描述，或"最近一次提交的变更"]
-需求/计划：[--plan 指定的文件路径，或"无"]
-DIFF：[--diff 指定文件内容（如提供）]
-BASE_SHA：[base SHA（如使用 git）]
-HEAD_SHA：[head SHA（如使用 git）]
-```
-### 5. 展示审查结果
-直接展示 agent 返回的完整审查报告。
-## 使用示例
-```
-/6aspec:review
-/6aspec:review 实现了用户认证功能
-/6aspec:review --diff /tmp/change.patch
-/6aspec:review --base abc1234 --head def5678
-/6aspec:review --plan 6aspecdoc/brown/add-user-auth/artifacts/specs.md
-```
+1. Immediate response upon activation: **6aspec:review** has been activated
+2. Read file: `.6aspec/rules/common/code-review-command-sop.md`
+3. Strictly follow the SOP defined in that file

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "6aspec",
-  "version": "3.0.0-dev.31",
+  "version": "3.0.0-dev.33",
   "description": "6Aspec - 轻量级 spec 驱动开发框架，支持 Cursor 和 Claude Code",
   "main": "lib/installer.js",
   "bin": {