6aspec 3.0.0-dev.12 → 3.0.0-dev.14

package/.6aspec/rules/common/code-reviewer-agent.md

@@ -4,35 +4,47 @@
 
 ## 任务
 
-1. 通过 git diff 获取变更内容
+1. 优先使用调用方提供的 DIFF（unified diff）获取变更内容；若未提供且 git 可用，则通过 git diff 获取
 2. 对照需求/计划检查实现
-3. 从代码质量、架构、测试、生产就绪性四个维度评估
+3. 从代码质量、架构、测试、需求符合度四个维度评估
 4. 按严重程度分类问题
 5. 给出明确的合并建议
 
 ## 输入
 
-调用方会提供：
+调用方会提供（均可选）：
 - `变更描述`：做了什么
 - `需求/计划`：应该做什么（可选，文件路径或文字描述）
-- `BASE_SHA`：起始 commit
-- `HEAD_SHA`：结束 commit
+- `DIFF`：本次变更的 unified diff 文本（**优先**）
+- `BASE_SHA`：起始 commit（可选，用于 git diff fallback）
+- `HEAD_SHA`：结束 commit（可选，用于 git diff fallback）
 
 ## 执行步骤
 
 ### 1. 获取变更内容
 
+按优先级选择输入来源：
+
+1) **如果提供了 `DIFF`**：
+- 直接基于 `DIFF` 进行审查（不要再运行 git diff）。
+
+2) **否则，如果提供了 `BASE_SHA`/`HEAD_SHA` 且 git 可用**：
 ```bash
 git diff --stat {BASE_SHA}..{HEAD_SHA}
 git diff {BASE_SHA}..{HEAD_SHA}
 ```
 
-如果调用方未提供 SHA，使用：
+3) **否则，如果未提供 SHA 但 git 可用**：
 ```bash
 BASE_SHA=$(git rev-parse HEAD~1)
 HEAD_SHA=$(git rev-parse HEAD)
+git diff --stat ${BASE_SHA}..${HEAD_SHA}
+git diff ${BASE_SHA}..${HEAD_SHA}
 ```
 
+4) **否则（既没有 DIFF，也无法使用 git）**：
+- 返回 `NEEDS_CONTEXT`，并要求调用方提供 `DIFF`（unified diff），或提供明确的变更文件列表 + 变更片段。
+
 ### 2. 读取需求（如果提供了文件路径）
 
 读取需求/计划文件，理解预期行为。

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

@@ -0,0 +1,36 @@
+---
+name: "6aspec-review"
+description: "独立代码审查（优先 DIFF，其次 git diff），不绑定任何流程，随时可用"
+---
+
+# 操作流程
+
+1. Immediate response upon activation: independent code review workflow - **6aspec-review** has been activated
+
+2. 解析输入参数（均可选）：
+   - `<description>`：变更描述（默认："最近一次提交的变更"）
+   - `--diff <file>`：unified diff 文件路径（优先）
+   - `--base <SHA>`：起始 commit（默认：HEAD~1）
+   - `--head <SHA>`：结束 commit（默认：HEAD）
+   - `--plan <file>`：需求/计划文件路径（可选）
+
+3. 确定变更来源：
+   - 若提供 `--diff`：读取该文件内容作为 `DIFF`
+   - 否则：使用 git 范围（`BASE_SHA`/`HEAD_SHA`）
+     - 若用户未指定：`BASE_SHA=HEAD~1`，`HEAD_SHA=HEAD`
+     - 可运行 `git log --oneline -10` 展示最近提交，便于用户确认范围
+
+4. 派发 `6aspec-code-reviewer` agent，并传入以下信息（按实际可得填写；无 DIFF 时不要伪造 DIFF）：
+
+   ```
+   变更描述：<description>
+   需求/计划：<--plan 文件路径 或 "无">
+   DIFF：<--diff 文件内容（如提供）>
+   BASE_SHA：<--base 或 HEAD~1>
+   HEAD_SHA：<--head 或 HEAD>
+   ```
+
+5. 展示审查结果：直接输出 `6aspec-code-reviewer` 返回的完整审查报告。
+
+6. 无法获取变更集时的处理：
+   - 若既未提供 `--diff`，又无法使用 git 获取 diff：停止并提示用户提供 `--diff <file>`（unified diff）。

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

@@ -13,13 +13,21 @@ description: 独立代码审查命令，不绑定任何流程，随时可用
 
 用户可以提供以下参数（均可选）：
 - `<description>` — 变更描述
+- `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
 - `--base <SHA>` — 起始 commit（默认：HEAD~1）
 - `--head <SHA>` — 结束 commit（默认：HEAD）
 - `--plan <file>` — 需求/计划文件路径
 
-如果没有提供任何参数，使用默认值（HEAD~1..HEAD）。
+如果未提供 `--diff/--base/--head`，使用默认值（HEAD~1..HEAD）。
 
-### 2. 确定 git 范围
+### 2. 确定变更来源
+
+- 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
+- 否则：使用 git 范围。
+
+### 3. （可选）展示 git 范围
+
+当使用 git 范围时：
 
 ```bash
 git log --oneline -10
@@ -31,18 +39,19 @@ git log --oneline -10
 - BASE_SHA = HEAD~1
 - HEAD_SHA = HEAD
 
-### 3. 派发 6aspec-code-reviewer agent
+### 4. 派发 6aspec-code-reviewer agent
 
 调用 `6aspec-code-reviewer` agent，传入：
 
 ```
 变更描述：[用户提供的描述，或"最近一次提交的变更"]
 需求/计划：[--plan 指定的文件路径，或"无"]
-BASE_SHA：[base SHA]
-HEAD_SHA：[head SHA]
+DIFF：[--diff 指定文件内容（如提供）]
+BASE_SHA：[base SHA（如使用 git）]
+HEAD_SHA：[head SHA（如使用 git）]
 ```
 
-### 4. 展示审查结果
+### 5. 展示审查结果
 
 直接展示 agent 返回的完整审查报告。
 
@@ -51,6 +60,7 @@ HEAD_SHA：[head SHA]
 ```
 /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
 ```

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git status:*)"
+    ]
+  }
+}

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

@@ -0,0 +1,11 @@
+# .codex/agents/6aspec-brown-implementer.toml
+
+name = "6aspec-brown-implementer"
+description = "执行棕地需求的单个 TASK 实现，包括写代码、单元测试和自我审查"
+
+# read-only | workspace-write | danger-full-access
+sandbox_mode = "workspace-write"
+
+developer_instructions = """
+读取并严格遵循：`.6aspec/rules/brown/subagents/implementer.md`
+"""

package/.codex/agents/6aspec-brown-spec-compliance-reviewer.toml

@@ -0,0 +1,11 @@
+# .codex/agents/6aspec-brown-spec-compliance-reviewer.toml
+
+name = "6aspec-brown-spec-compliance-reviewer"
+description = "检查实现是否符合 TASK 的验收标准和 specs.md 的 AC/Scenario，适用于 TASK 完成后的合规验收"
+
+# read-only | workspace-write | danger-full-access
+sandbox_mode = "read-only"
+
+developer_instructions = """
+读取并严格遵循：`.6aspec/rules/brown/subagents/spec-compliance-reviewer.md`
+"""

package/.codex/agents/6aspec-code-reviewer.toml

@@ -0,0 +1,11 @@
+# .codex/agents/6aspec-code-reviewer.toml
+
+name = "6aspec-code-reviewer"
+description = "审查代码变更的生产就绪性，从代码质量、架构、测试、需求符合度四个维度评估，给出明确的合并建议"
+
+# read-only | workspace-write | danger-full-access
+sandbox_mode = "read-only"
+
+developer_instructions = """
+读取并严格遵循：`.6aspec/rules/common/code-reviewer-agent.md`
+"""

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

@@ -1,5 +1,5 @@
 ---
-description: 独立代码审查，不绑定任何流程，随时可用
+description: 独立代码审查（优先 DIFF，其次 git diff），不绑定任何流程，随时可用
 alwaysApply: false
 ---
 
@@ -13,13 +13,21 @@ alwaysApply: false
 
 用户可以提供以下参数（均可选）：
 - `<description>` — 变更描述
+- `--diff <file>` — 本次变更的 unified diff 文件路径（优先）
 - `--base <SHA>` — 起始 commit（默认：HEAD~1）
 - `--head <SHA>` — 结束 commit（默认：HEAD）
 - `--plan <file>` — 需求/计划文件路径
 
-如果没有提供任何参数，使用默认值（HEAD~1..HEAD）。
+如果未提供 `--diff/--base/--head`，使用默认值（HEAD~1..HEAD）。
 
-### 2. 确定 git 范围
+### 2. 确定变更来源
+
+- 如果提供了 `--diff`：读取 diff 文件内容作为 `DIFF`，并直接进入步骤 3。
+- 否则：使用 git 范围。
+
+### 3. （可选）展示 git 范围
+
+当使用 git 范围时：
 
 ```bash
 git log --oneline -10
@@ -31,18 +39,19 @@ git log --oneline -10
 - BASE_SHA = HEAD~1
 - HEAD_SHA = HEAD
 
-### 3. 派发 6aspec-code-reviewer agent
+### 4. 派发 6aspec-code-reviewer agent
 
 调用 `6aspec-code-reviewer` agent，传入：
 
 ```
 变更描述：[用户提供的描述，或"最近一次提交的变更"]
 需求/计划：[--plan 指定的文件路径，或"无"]
-BASE_SHA：[base SHA]
-HEAD_SHA：[head SHA]
+DIFF：[--diff 指定文件内容（如提供）]
+BASE_SHA：[base SHA（如使用 git）]
+HEAD_SHA：[head SHA（如使用 git）]
 ```
 
-### 4. 展示审查结果
+### 5. 展示审查结果
 
 直接展示 agent 返回的完整审查报告。
 
@@ -51,6 +60,7 @@ HEAD_SHA：[head SHA]
 ```
 /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
 ```

package/lib/cli.js

@@ -43,9 +43,9 @@ const TOOL_DIRS = {
     '.agents/skills/6aspec-brown-quick',
     '.agents/skills/6aspec-brown-rollback',
     '.agents/skills/6aspec-brown-update',
-    '.codex/agents/6aspec-brown-implementer.md',
-    '.codex/agents/6aspec-brown-spec-compliance-reviewer.md',
-    '.codex/agents/6aspec-code-reviewer.md',
+    '.codex/agents/6aspec-brown-implementer.toml',
+    '.codex/agents/6aspec-brown-spec-compliance-reviewer.toml',
+    '.codex/agents/6aspec-code-reviewer.toml',
   ],
 };
 // ─── Welcome Screen with Animation ──────────────────────────────────

package/package.json

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

package/.codex/agents/6aspec-brown-implementer.md

@@ -1,7 +0,0 @@
----
-name: 6aspec-brown-implementer
-description: 执行棕地需求的单个 TASK 实现，包括写代码、单元测试和自我审查
-tools: [Read, Write, Edit, Bash]
----
-
-读取并严格遵循：`.6aspec/rules/brown/subagents/implementer.md`

package/.codex/agents/6aspec-brown-spec-compliance-reviewer.md

@@ -1,7 +0,0 @@
----
-name: 6aspec-brown-spec-compliance-reviewer
-description: 检查实现是否符合 TASK 的验收标准和 specs.md 的 AC/Scenario，适用于 TASK 完成后的合规验收
-tools: [Read, Glob, Grep, Bash]
----
-
-读取并严格遵循：`.6aspec/rules/brown/subagents/spec-compliance-reviewer.md`

package/.codex/agents/6aspec-code-reviewer.md

@@ -1,7 +0,0 @@
----
-name: 6aspec-code-reviewer
-description: 审查代码变更的生产就绪性，从代码质量、架构、测试、需求符合度四个维度评估，给出明确的合并建议
-tools: [Read, Glob, Grep]
----
-
-读取并严格遵循：`.6aspec/rules/common/code-reviewer-agent.md`