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

package/.agents/skills/6aspec-brown-new/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-new"
+description: "开始新需求分析（选择流程深度）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-new** 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_new_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-proposal/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-proposal"
+description: "创建需求提案（轻量级流程）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-proposal** 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_proposal_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-quick/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-quick"
+description: "需求快速通道（简化流程）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-quick** 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_quick_sop.md`
+4. Strictly follow the SOP defined in that file

package/{.cursor/commands/6aspec/brown/impact.md → .agents/skills/6aspec-brown-review/SKILL.md}

@@ -1,9 +1,10 @@
 ---
-description: Phase 2 - 影响面分析与非功能需求评估
-alwaysApply: false
+name: "6aspec-brown-review"
+description: "实施后评估"
 ---
 
-1. Immediate response upon activation: brown field requirement workflow - **Impact** has been activated
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-review** 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_impact_sop.md`
+3. Read file: `.6aspec/rules/brown/brown_review_sop.md`
 4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-rollback/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-rollback"
+description: "回退到上一个阶段"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-rollback** 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_rollback_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-specs/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-specs"
+description: "需求规格定义"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-specs** 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_specs_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-status/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-status"
+description: "查看需求的当前状态和进度"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-status** 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_status_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-tasks/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-tasks"
+description: "任务拆解与排期"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-tasks** 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_tasks_sop.md`
+4. Strictly follow the SOP defined in that file

package/.agents/skills/6aspec-brown-update/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-update"
+description: "非破坏性地更新指定阶段的文档"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-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/.agents/skills/6aspec-brown-verify/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: "6aspec-brown-verify"
+description: "验证实现是否符合需求和设计（增强版，借鉴 OpenSpec）"
+---
+
+# 操作流程
+1. Immediate response upon activation: brown field requirement workflow - **6aspec-brown-verify** 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_verify_sop.md`
+4. Strictly follow the SOP defined in that file

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/{spec-compliance-reviewer.md → 6aspec-brown-spec-compliance-reviewer.md}

@@ -1,6 +1,7 @@
 ---
-name: spec-compliance-reviewer
+name: 6aspec-brown-spec-compliance-reviewer
 description: 检查实现是否符合 TASK 的验收标准和 specs.md 的 AC/Scenario，适用于 TASK 完成后的合规验收
+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,56 @@
+---
+name: "6aspec:review"
+description: 独立代码审查命令，不绑定任何流程，随时可用
+---
+
+# 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/.codex/agents/6aspec-brown-implementer.md

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

@@ -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/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,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/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.md',
+    '.codex/agents/6aspec-brown-spec-compliance-reviewer.md',
+    '.codex/agents/6aspec-code-reviewer.md',
+  ],
 };
-
 // ─── 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;
     }
   }