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

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

@@ -0,0 +1,66 @@
+---
+name: "6aspec-review"
+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
+```

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

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

package/.claude/agents/{implementer.md → 6aspec-brown-implementer.md}

@@ -1,6 +1,7 @@
 ---
-name: implementer
+name: 6aspec-brown-implementer
 description: 执行棕地需求的单个 TASK 实现，包括写代码、单元测试和自我审查，适用于 brown implement 阶段
+model: inherit
 ---
 
 读取并严格遵循：`.6aspec/rules/brown/subagents/implementer.md`

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

@@ -0,0 +1,7 @@
+---
+name: 6aspec-brown-spec-compliance-reviewer
+description: 检查实现是否符合 TASK 与 specs.md 的 AC/Scenario（不审查 design.md；设计对齐由实现阶段与 verify 等负责）
+model: gpt-5.3-codex
+---
+
+读取并严格遵循：`.6aspec/rules/brown/subagents/spec-compliance-reviewer.md`

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

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

package/.claude/commands/6aspec/brown/analyze.md

@@ -1,6 +1,6 @@
 ---
 name: "6aspec:brown: Analyze"
-description: Phase 1 - 需求澄清与影响面分析（合并原 Understand + Impact）
+description: 需求澄清与影响面分析（合并原 Understand + Impact）
 category: Workflow
 tags: [workflow, requirement, analysis]
 ---

package/.claude/commands/6aspec/brown/design.md

@@ -1,6 +1,6 @@
 ---
 name: "6aspec:brown: Design"
-description: Phase 3 - 技术方案设计（含 ADR 和技术债务识别）
+description: 技术方案设计（含 ADR 和技术债务识别）
 category: Workflow
 tags: [workflow, requirement, design]
 ---

package/.claude/commands/6aspec/brown/quick.md

@@ -1,6 +1,6 @@
 ---
 name: "6aspec:brown: Quick"
-description: P2 需求快速通道（简化流程）
+description: 需求快速通道（简化流程）
 category: Workflow
 tags: [workflow, requirement, quick]
 ---

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

@@ -1,6 +1,6 @@
 ---
 name: "6aspec:brown: Review"
-description: Phase 7 - 实施后评估
+description: 实施后评估
 category: Workflow
 tags: [workflow, requirement, review]
 ---

package/.claude/commands/6aspec/brown/specs.md

@@ -1,6 +1,6 @@
 ---
 name: "6aspec:brown: Specs"
-description: Phase 1.5 - 需求规格定义
+description: 需求规格定义
 category: Workflow
 tags: [workflow, requirement, specs]
 ---

package/.claude/commands/6aspec/brown/tasks.md

@@ -1,6 +1,6 @@
 ---
 name: "6aspec:brown: Tasks"
-description: Phase 4 - 任务拆解与排期
+description: 任务拆解与排期
 category: Workflow
 tags: [workflow, requirement, tasks]
 ---

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

@@ -0,0 +1,66 @@
+---
+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
+```

package/.claude/settings.local.json

@@ -1,28 +1,7 @@
 {
   "permissions": {
     "allow": [
-      "Bash(ls -la .claude/commands/6aspec/green/*.md)",
-      "Bash(xargs -I {} basename {})",
-      "Bash(git mv 6A_constitution.md green_constitution.md)",
-      "Bash(git mv 6A_design_sop.md green_design_sop.md)",
-      "Bash(git mv 6A_import_model_table_sop.md green_import_model_table_sop.md)",
-      "Bash(git mv 6A_init_event_list_sop.md green_init_event_list_sop.md)",
-      "Bash(git mv 6A_init_map_sop.md green_init_map_sop.md)",
-      "Bash(git mv 6A_model_sop.md green_model_sop.md)",
-      "Bash(git mv 6A_new_sop.md green_new_sop.md)",
-      "Bash(git mv 6A_rollback_sop.md green_rollback_sop.md)",
-      "Bash(git mv 6A_visual_logic_sop.md green_visual_logic_sop.md)",
-      "Bash(git mv 6A_code_implementation_sop.md green_code_implementation_sop.md)",
-      "Bash(git mv 6A_archive_sop.md green_archive_sop.md)",
-      "Bash(git mv 6A_continue_sop.md green_continue_sop.md)",
-      "Bash(git mv 6A_tasks_sop.md green_tasks_sop.md)",
-      "Bash(git mv 6A_clarify_sop.md green_clarify_sop.md)",
-      "Bash(git mv 6A_status_sop.md green_status_sop.md)",
-      "Bash(ls -la .6aspec/rules/green/6A_*.md)",
-      "Bash(xargs sed -i '' 's/6A_\\\\\\([a-z_]*\\\\\\)\\\\.md/green_\\\\1.md/g')",
-      "Bash(openspec --help)",
-      "Bash(openspec schemas --json 2>/dev/null | head -100)",
-      "Bash(openspec status --json 2>/dev/null | head -50)"
+      "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,13 @@
+# .codex/agents/6aspec-brown-spec-compliance-reviewer.toml
+
+name = "6aspec-brown-spec-compliance-reviewer"
+description = "检查实现是否符合 TASK 与 specs.md 的 AC/Scenario（不审查 design.md）"
+
+# read-only | workspace-write | danger-full-access
+sandbox_mode = "read-only"
+
+model = "gpt-5.2-codex"
+
+developer_instructions = """
+读取并严格遵循：`.6aspec/rules/brown/subagents/spec-compliance-reviewer.md`
+"""

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

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

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

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

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

@@ -0,0 +1,8 @@
+---
+name: 6aspec-brown-spec-compliance-reviewer
+description: 检查实现是否符合 TASK 与 specs.md 的 AC/Scenario（不审查 design.md；设计对齐由实现阶段与 verify 等流程负责）
+model: gpt-5.3-codex
+readonly: true
+---
+
+读取并严格遵循：`.6aspec/rules/brown/subagents/spec-compliance-reviewer.md`

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

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

package/.cursor/commands/6aspec-brown-analyze.md

@@ -0,0 +1,9 @@
+---
+description: 需求澄清与影响面分析（合并原 Understand + Impact）
+alwaysApply: false
+---
+
+1. Immediate response upon activation: brown field requirement workflow - **Analyze** has been activated
+2. **Read and strictly follow the brown field constitution**: `.6aspec/rules/brown/brown_constitution.md`
+3. Read file: `.6aspec/rules/brown/brown_analyze_sop.md`
+4. Strictly follow the SOP defined in that file

package/.cursor/commands/{6aspec/brown/design.md → 6aspec-brown-design.md}

@@ -1,5 +1,5 @@
 ---
-description: Phase 3 - 技术方案设计（含 ADR 和技术债务识别）
+description: 技术方案设计（含 ADR 和技术债务识别）
 alwaysApply: false
 ---
 

package/.cursor/commands/{6aspec/brown/implement.md → 6aspec-brown-implement.md}

@@ -1,5 +1,5 @@
 ---
-description: 执行任务实现
+description: 执行任务实现；可选 --skipTest=true|false（未写则 false，标准单测模式）
 alwaysApply: false
 ---
 

package/.cursor/commands/{6aspec/brown/quick.md → 6aspec-brown-quick.md}

@@ -1,5 +1,5 @@
 ---
-description: P2 需求快速通道（简化流程）
+description: 需求快速通道（简化流程）
 alwaysApply: false
 ---
 

package/.cursor/commands/{6aspec/brown/review.md → 6aspec-brown-review.md}

@@ -1,5 +1,5 @@
 ---
-description: Phase 7 - 实施后评估
+description: 实施后评估
 alwaysApply: false
 ---
 

package/.cursor/commands/{6aspec/brown/specs.md → 6aspec-brown-specs.md}

@@ -1,5 +1,5 @@
 ---
-description: Phase 1.5 - 需求规格定义
+description: 需求规格定义
 alwaysApply: false
 ---
 

package/.cursor/commands/{6aspec/brown/tasks.md → 6aspec-brown-tasks.md}

@@ -1,5 +1,5 @@
 ---
-description: Phase 4 - 任务拆解与排期
+description: 任务拆解与排期
 alwaysApply: false
 ---
 

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

@@ -0,0 +1,66 @@
+---
+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
+```

package/lib/cli.js

@@ -17,14 +17,37 @@ const CONFIG_FILE = '.6aspec/init.json';
 const TOOLS = [
   { id: 'cursor', name: 'Cursor', desc: 'Cursor IDE 配置' },
   { id: 'claude', name: 'Claude Code', desc: 'Claude Code CLI 配置' },
+  { id: 'codex', name: 'Codex CLI', desc: 'Codex CLI skills/agents 配置' },
 ];
 
 // Only the 6aspec-owned subdirectory is removed — user's own commands are untouched
 const TOOL_DIRS = {
   cursor: ['.cursor/commands/6aspec'],
   claude:  ['.claude/commands/6aspec', '.claude/agents'],
+  codex: [
+    '.agents/skills/6aspec-brown-new',
+    '.agents/skills/6aspec-brown-explore',
+    '.agents/skills/6aspec-brown-analyze',
+    '.agents/skills/6aspec-brown-proposal',
+    '.agents/skills/6aspec-brown-specs',
+    '.agents/skills/6aspec-brown-design',
+    '.agents/skills/6aspec-brown-tasks',
+    '.agents/skills/6aspec-brown-implement',
+    '.agents/skills/6aspec-brown-verify',
+    '.agents/skills/6aspec-brown-review',
+    '.agents/skills/6aspec-brown-archive',
+    '.agents/skills/6aspec-brown-continue',
+    '.agents/skills/6aspec-brown-status',
+    '.agents/skills/6aspec-brown-list',
+    '.agents/skills/6aspec-brown-ff',
+    '.agents/skills/6aspec-brown-quick',
+    '.agents/skills/6aspec-brown-rollback',
+    '.agents/skills/6aspec-brown-update',
+    '.codex/agents/6aspec-brown-implementer.toml',
+    '.codex/agents/6aspec-brown-spec-compliance-reviewer.toml',
+    '.codex/agents/6aspec-code-reviewer.toml',
+  ],
 };
-
 // ─── Welcome Screen with Animation ──────────────────────────────────
 
 // Braille spinner frames
@@ -272,15 +295,23 @@ function writeConfig(targetDir, tools) {
 
 // ─── Tool removal ───────────────────────────────────────────────────
 
-function removeDirRecursive(dirPath) {
-  if (!fs.existsSync(dirPath)) return;
-  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
-  for (const entry of entries) {
-    const full = path.join(dirPath, entry.name);
-    if (entry.isDirectory()) removeDirRecursive(full);
-    else fs.unlinkSync(full);
+function removePathRecursive(targetPath) {
+  if (!fs.existsSync(targetPath)) return;
+  const stat = fs.lstatSync(targetPath);
+
+  if (stat.isDirectory()) {
+    const entries = fs.readdirSync(targetPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const full = path.join(targetPath, entry.name);
+      if (entry.isDirectory()) removePathRecursive(full);
+      else fs.unlinkSync(full);
+    }
+    fs.rmdirSync(targetPath);
+    return;
   }
-  fs.rmdirSync(dirPath);
+
+  // file or symlink
+  fs.unlinkSync(targetPath);
 }
 
 function removeToolFiles(targetDir, tools) {
@@ -289,13 +320,12 @@ function removeToolFiles(targetDir, tools) {
     for (const rel of dirs) {
       const full = path.join(targetDir, rel);
       if (fs.existsSync(full)) {
-        removeDirRecursive(full);
+        removePathRecursive(full);
         console.log(`${GREEN}[INFO]${RESET} 已删除 ${rel}`);
       }
     }
   }
 }
-
 // Simple y/N prompt (readline, no raw mode needed)
 function promptConfirm(question) {
   return new Promise((resolve) => {
@@ -380,6 +410,9 @@ async function init(args) {
       case 'claude':
         installer.installClaude();
         break;
+      case 'codex':
+        installer.installCodex();
+        break;
     }
   }
 
@@ -439,6 +472,9 @@ async function update(args) {
       case 'claude':
         installer.installClaude();
         break;
+      case 'codex':
+        installer.installCodex();
+        break;
     }
   }