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

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

@@ -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

@@ -3,66 +3,6 @@ name: "6aspec-review"
 description: "独立代码审查。用于审查指定 diff 文件、指定 git 提交范围或当前工作区未提交变更，并输出完整审查报告。"
 ---
 
-# 操作流程
-
-对当前代码变更进行独立审查。好的
-
-## 步骤
-
-### 1. 解析输入
-
-用户可以提供以下参数（均可选）：
-- `<description>` — 变更描述
-- `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
-- `--base <SHA>` — 起始 commit（用于指定 git 范围）
-- `--head <SHA>` — 结束 commit（用于指定 git 范围）
-- `--plan <file>` — 需求/计划文件路径
-
-如果未提供 `--diff/--base/--head`，不传 SHA，让子 agent 审查当前工作区未提交变更。
-
-### 2. 确定变更来源
-
-- 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
-- 否则：
-  - 如果提供了 `--base/--head`：使用 git 范围。
-  - 如果未提供 `--base/--head`：不传 SHA（由子 agent 审查未提交变更）。
-
-### 3. （可选）展示 git 范围
-
-当使用 git 范围时：
-
-```bash
-git log --oneline -10
-```
-
-显示最近 10 条 commit，帮助用户确认审查范围。
-
-如果用户未指定 SHA，使用：
-- 不设置 BASE_SHA/HEAD_SHA
-
-### 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 HEAD~1 --head HEAD
-/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/.claude/commands/6aspec/review.md

@@ -3,66 +3,6 @@ name: "6aspec:review"
 description: 独立代码审查命令，不绑定任何流程，随时可用
 ---
 
-# Code Review
-
-对当前代码变更进行独立审查。
-
-## 步骤
-
-### 1. 解析输入
-
-用户可以提供以下参数（均可选）：
-- `<description>` — 变更描述
-- `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
-- `--base <SHA>` — 起始 commit（用于指定 git 范围）
-- `--head <SHA>` — 结束 commit（用于指定 git 范围）
-- `--plan <file>` — 需求/计划文件路径
-
-如果未提供 `--diff/--base/--head`，不传 SHA，让子 agent 审查当前工作区未提交变更。
-
-### 2. 确定变更来源
-
-- 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
-- 否则：
-  - 如果提供了 `--base/--head`：使用 git 范围。
-  - 如果未提供 `--base/--head`：不传 SHA（由子 agent 审查未提交变更）。
-
-### 3. （可选）展示 git 范围
-
-当使用 git 范围时：
-
-```bash
-git log --oneline -10
-```
-
-显示最近 10 条 commit，帮助用户确认审查范围。
-
-如果用户未指定 SHA，使用：
-- 不设置 BASE_SHA/HEAD_SHA
-
-### 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 HEAD~1 --head HEAD
-/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/.cursor/commands/6aspec-review.md

@@ -3,66 +3,6 @@ description: 独立代码审查（优先 DIFF，其次 git diff），不绑定
 alwaysApply: false
 ---
 
-# Code Review
-
-对当前代码变更进行独立审查。
-
-## 步骤
-
-### 1. 解析输入
-
-用户可以提供以下参数（均可选）：
-- `<description>` — 变更描述
-- `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
-- `--base <SHA>` — 起始 commit（用于指定 git 范围）
-- `--head <SHA>` — 结束 commit（用于指定 git 范围）
-- `--plan <file>` — 需求/计划文件路径
-
-如果未提供 `--diff/--base/--head`，不传 SHA，让子 agent 审查当前工作区未提交变更。
-
-### 2. 确定变更来源
-
-- 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
-- 否则：
-  - 如果提供了 `--base/--head`：使用 git 范围。
-  - 如果未提供 `--base/--head`：不传 SHA（由子 agent 审查未提交变更）。
-
-### 3. （可选）展示 git 范围
-
-当使用 git 范围时：
-
-```bash
-git log --oneline -10
-```
-
-显示最近 10 条 commit，帮助用户确认审查范围。
-
-如果用户未指定 SHA，使用：
-- 不设置 BASE_SHA/HEAD_SHA
-
-### 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 HEAD~1 --head HEAD
-/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

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