6aspec 2.0.0-dev.9 → 3.0.0-dev.10

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

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

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

@@ -0,0 +1,11 @@
+---
+name: "6aspec:brown: Explore"
+description: 前期探索（轻量级流程可选）
+category: Workflow
+tags: [workflow, explore, lightweight, brownfield]
+---
+
+1. Immediate response upon activation: brown field requirement workflow - **Explore** 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_explore_sop.md`
+4. Strictly follow the SOP defined in that file

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-brown-update.md

@@ -0,0 +1,9 @@
+---
+description: 非破坏性地更新指定阶段的文档
+alwaysApply: false
+---
+
+1. Immediate response upon activation: brown field requirement workflow - **Update** 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_update_sop.md`
+4. Strictly follow the SOP defined in that file

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

@@ -0,0 +1,8 @@
+---
+description: 根据用户需求编写代码
+alwaysApply: false
+---
+
+1. Immediate response upon activation: code command has been activated
+2. Read and strictly follow the SOP: `.6aspec/rules/biz/code_implementation_sop.md`
+3. Strictly follow the SOP defined in that file

package/.cursor/commands/{6aspec/green/archive.md → 6aspec-green-archive.md}

@@ -4,6 +4,6 @@ alwaysApply: false
 ---
 
 1. Immediate response upon activation: archive workflow has been activated
-2. Read file: `.6aspec/rules/green/6A_archive_sop.md`
+2. Read file: `.6aspec/rules/green/green_archive_sop.md`
 3. Strictly follow the "Archive Workflow SOP" defined in that file
 4. Archive the completed requirement

package/.cursor/commands/{6aspec/green/clarify.md → 6aspec-green-clarify.md}

@@ -4,11 +4,11 @@ alwaysApply: false
 ---
 
 1. Immediate response upon activation: clarify workflow has been activated
-2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/green_constitution.md`
 3. **Context Restriction**: 
    - Do NOT perform `codebase_search`.
    - Do NOT read any files unless they are explicitly provided by the user (via '@') or explicitly listed in the SOP steps.
    - Stop and ask the user if you think you need more information.
-4. Read file: `.6aspec/rules/green/6A_clarify_sop.md`
+4. Read file: `.6aspec/rules/green/green_clarify_sop.md`
 5. Strictly follow the "Requirement Clarification SOP" defined in that file
 6. Update the requirement document with clarified details

package/.cursor/commands/{6aspec/green/continue.md → 6aspec-green-continue.md}

@@ -4,6 +4,6 @@ alwaysApply: false
 ---
 
 1. Immediate response upon activation: continue workflow has been activated
-2. Read file: `.6aspec/rules/green/6A_continue_sop.md`
+2. Read file: `.6aspec/rules/green/green_continue_sop.md`
 3. Strictly follow the "Continue Workflow SOP" defined in that file
 4. Automatically execute the next step based on current status

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

@@ -3,7 +3,7 @@ description: design workflow
 alwaysApply: false
 ---
 1. Immediate response upon activation: design workflow has been activated.
-2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
-3. Read file: `.6aspec/rules/green/6A_design_sop.md`
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/green_constitution.md`
+3. Read file: `.6aspec/rules/green/green_design_sop.md`
 4. Strictly follow the "New Feature Architecture SOP" defined in that file.
 5. Output the Technical Design Document (TDD).

package/.cursor/commands/{6aspec/green/execute-task.md → 6aspec-green-implement.md}

@@ -11,7 +11,7 @@ alwaysApply: false
 当用户提供一个任务文件路径（如 `@task_01_api_xxx.md`）并要求“执行任务”时：
 
 1.  **激活角色**：切换至 `Senior Developer` 角色。
-2.  **调用 SOP**：严格遵循 `.6aspec/rules/green/6A_code_implementation_sop.md` 中的协议。
+2.  **调用 SOP**：严格遵循 `.6aspec/rules/green/green_code_implementation_sop.md` 中的协议。
     - **Step 0**: 上下文加载 (Task + TDD + Rules)
     - **Step 1**: 自底向上编码 (DTO -> Repo -> Service -> API)
     - **Step 2**: 质量检查 (Lint)

package/.cursor/commands/{6aspec/green/import-model-table.md → 6aspec-green-import-model-table.md}

@@ -3,7 +3,7 @@ description: import-model-table workflow
 alwaysApply: false
 ---
 1. Immediate response upon activation: import-model-table workflow has been activated
-2. Read file: `.6aspec/rules/green/6A_import_model_table_sop.md`
+2. Read file: `.6aspec/rules/green/green_import_model_table_sop.md`
 3. Strictly follow the "Import Model Table SOP" defined in that file
 4. Execute the python script to import entities
 

package/.cursor/commands/{6aspec/green/init.md → 6aspec-green-init.md}

@@ -5,11 +5,11 @@ alwaysApply: false
 Immediate response upon activation: Project Artifacts Initialization workflow has been activated.
 
 Phase 1: Functional Capability Map
-1. Read file: `.6aspec/rules/green/6A_init_map_sop.md`
+1. Read file: `.6aspec/rules/green/green_init_map_sop.md`
 2. Strictly follow the "Init Functional Capability Map SOP" defined in that file.
 3. Execute the codebase scan and update the artifact at `.6aspec/biz/functional-capability-Map.md`.
 
 Phase 2: Event List
-1. Read file: `.6aspec/rules/green/6A_init_event_list_sop.md`
+1. Read file: `.6aspec/rules/green/green_init_event_list_sop.md`
 2. Strictly follow the "Event List Generation SOP" defined in that file.
 3. Execute the codebase scan and update the artifact at `.6aspec/biz/event-list.md`.

package/.cursor/commands/{6aspec/green/model.md → 6aspec-green-model.md}

@@ -3,11 +3,11 @@ description: model workflow
 alwaysApply: false
 ---
 1. Immediate response upon activation: model workflow has been activated
-2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/green_constitution.md`
 3. **Context Restriction**: 
    - Do NOT perform `codebase_search`.
    - Do NOT read any files unless they are explicitly provided by the user (via '@') or explicitly listed in the SOP steps.
    - Stop and ask the user if you think you need more information.
-4. Read file: `.6aspec/rules/green/6A_model_sop.md`
+4. Read file: `.6aspec/rules/green/green_model_sop.md`
 5. Strictly follow the "Domain modeling and database design Architecture SOP" defined in that file
 6. Output the Domain model and table design

package/.cursor/commands/{6aspec/green/new.md → 6aspec-green-new.md}

@@ -4,11 +4,11 @@ alwaysApply: false
 ---
 
 1. Immediate response upon activation: new feature workflow has been activated
-2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/green_constitution.md`
 3. **Context Restriction**: 
    - Do NOT perform `codebase_search`.
    - Do NOT read any files unless they are explicitly provided by the user (via '@') or explicitly listed in the SOP steps.
    - Stop and ask the user if you think you need more information.
-4. Read file: `.6aspec/rules/green/6A_new_sop.md`
+4. Read file: `.6aspec/rules/green/green_new_sop.md`
 5. Strictly follow the "New Feature Requirement SOP" defined in that file
 6. Output the structured requirement document

package/.cursor/commands/{6aspec/green/rollback.md → 6aspec-green-rollback.md}

@@ -4,6 +4,6 @@ alwaysApply: false
 ---
 
 1. Immediate response upon activation: rollback workflow has been activated
-2. Read file: `.6aspec/rules/green/6A_rollback_sop.md`
+2. Read file: `.6aspec/rules/green/green_rollback_sop.md`
 3. Strictly follow the "Rollback SOP" defined in that file
 4. **Do not** perform any file deletion or status file update until the user has explicitly confirmed (e.g. "确认回退" or "执行回退")

package/.cursor/commands/{6aspec/green/status.md → 6aspec-green-status.md}

@@ -4,6 +4,6 @@ alwaysApply: false
 ---
 
 1. Immediate response upon activation: status workflow has been activated
-2. Read file: `.6aspec/rules/green/6A_status_sop.md`
+2. Read file: `.6aspec/rules/green/green_status_sop.md`
 3. Strictly follow the "Status Query SOP" defined in that file
 4. Output the current status and progress

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

@@ -3,7 +3,7 @@ description: tasks workflow
 alwaysApply: false
 ---
 1. Immediate response upon activation: tasks workflow has been activated
-2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
-3. Read file: `.6aspec/rules/green/6A_tasks_sop.md`
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/green_constitution.md`
+3. Read file: `.6aspec/rules/green/green_tasks_sop.md`
 4. Strictly follow the "Task Decomposition SOP" defined in that file
 5. Output the task list

package/.cursor/commands/{6aspec/green/visual-logic.md → 6aspec-green-visual-logic.md}

@@ -3,8 +3,8 @@ description: visual-logic workflow
 alwaysApply: false
 ---
 1. Immediate response upon activation: visual-logic workflow has been activated.
-2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/6A_constitution.md`
-3. Read file: `.6aspec/rules/green/6A_visual_logic_sop.md`.
+2. **You must first read and strictly abide by the principles in the constitutional documents**：`.6aspec/rules/green/green_constitution.md`
+3. Read file: `.6aspec/rules/green/green_visual_logic_sop.md`.
 4. Strictly follow the "Visual Logic Diagrams SOP" defined in that file.
 5. Output Mermaid diagrams as specified in the SOP.
 

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

@@ -0,0 +1,56 @@
+---
+description: 独立代码审查，不绑定任何流程，随时可用
+alwaysApply: false
+---
+
+# Code Review
+
+对当前代码变更进行独立审查。
+
+## 步骤
+
+### 1. 解析输入
+
+用户可以提供以下参数（均可选）：
+- `<description>` — 变更描述
+- `--base <SHA>` — 起始 commit（默认：HEAD~1）
+- `--head <SHA>` — 结束 commit（默认：HEAD）
+- `--plan <file>` — 需求/计划文件路径
+
+如果没有提供任何参数，使用默认值（HEAD~1..HEAD）。
+
+### 2. 确定 git 范围
+
+```bash
+git log --oneline -10
+```
+
+显示最近 10 条 commit，帮助用户确认审查范围。
+
+如果用户未指定 SHA，使用：
+- BASE_SHA = HEAD~1
+- HEAD_SHA = HEAD
+
+### 3. 派发 6aspec-code-reviewer agent
+
+调用 `6aspec-code-reviewer` agent，传入：
+
+```
+变更描述：[用户提供的描述，或"最近一次提交的变更"]
+需求/计划：[--plan 指定的文件路径，或"无"]
+BASE_SHA：[base SHA]
+HEAD_SHA：[head SHA]
+```
+
+### 4. 展示审查结果
+
+直接展示 agent 返回的完整审查报告。
+
+## 使用示例
+
+```
+/6aspec:review
+/6aspec:review 实现了用户认证功能
+/6aspec:review --base abc1234 --head def5678
+/6aspec:review --plan 6aspecdoc/brown/add-user-auth/artifacts/specs.md
+```

package/README.md

@@ -118,7 +118,7 @@ npm install -g 6aspec@2.0.0
 |------|------|
 | `/6aspec:green:new` | 创建一个模块 |
 | `/6aspec:green:continue` | 生成下一个工件 |
-| `/6aspec:green:execute-task` | 执行任务 |
+| `/6aspec:green:implement` | 执行任务 |
 | `/6aspec:green:init` | 初始化项目 |
 | `/6aspec:green:status` | 查看状态 |
 | `/6aspec:green:model` | 数据建模 |

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:  ['.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.md',
+    '.codex/agents/6aspec-brown-spec-compliance-reviewer.md',
+    '.codex/agents/6aspec-code-reviewer.md',
+  ],
 };
-
 // ─── Welcome Screen with Animation ──────────────────────────────────
 
 // Braille spinner frames
@@ -88,7 +111,7 @@ function buildRightLines() {
     `  ${MAGENTA}Greenfield (new project):${RESET}`,
     `  ${GREEN}/6aspec:green:new${RESET}        Create a module`,
     `  ${GREEN}/6aspec:green:continue${RESET}   Next artifact`,
-    `  ${GREEN}/6aspec:green:execute-task${RESET} Execute tasks`,
+    `  ${GREEN}/6aspec:green:implement${RESET} Execute tasks`,
   ];
 }
 
@@ -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;
     }
   }