cc-devflow 2.5.0 → 4.1.1

package/README.zh-CN.md

@@ -31,6 +31,9 @@
 - 📜 **Constitution** - 10条宪法条款管控质量、安全和架构
 - 🔄 **自主开发** - Ralph × Manus 集成实现有记忆的持续迭代
 - 🔌 **多平台支持** - 通过 `npm run adapt` 编译工作流到 Codex、Cursor、Qwen、Antigravity
+- 🔄 **多模块编译器** - 完整模块编译：skills、commands、agents、rules、hooks
+- 🌿 **Git Worktree 集成** - 支持 3-5 个并行 Claude 会话的隔离 worktree 开发
+- 🤝 **Claude Team 集成** - 多 Agent 并行协作，自动任务调度和冲突检测
 
 ---
 
@@ -73,28 +76,37 @@ export SKIP_TDD_ENFORCER=1
 📚 [完整 Hooks 文档](docs/guides/hooks-system.zh-CN.md)
 </details>
 
-### Skills 系统
+### Skills 系统 (v4.0 Skills-First 架构)
 
-智能知识库激活，自动推荐相关领域知识。
+智能知识库激活，分组 Skills 与自动上下文注入。
 
 <details>
 <summary>📖 Skills 详解（点击展开）</summary>
 
-**可用 Skills**:
+**Skills-First 架构** (v4.0):
 
-| Skill | 类型 | 触发场景 |
-|-------|------|----------|
-| `cc-devflow-orchestrator` | domain | 需求管理、流程指导 |
-| `devflow-tdd-enforcer` | guardrail | 编辑 TASKS.md |
-| `constitution-guardian` | guardrail | 编辑 PRD/EPIC/TASKS |
-| `devflow-file-standards` | domain | 文件命名、目录结构 |
-| `skill-developer` | domain | Skill 开发、Hook 系统 |
+```
+.claude/skills/
+├── workflow.yaml           # Skill 依赖图 (借鉴 OpenSpec)
+├── workflow/               # 9 个工作流 Skills (flow-init, flow-spec, flow-dev 等)
+├── domain/                 # 7 个领域 Skills (tdd, debugging, brainstorming)
+├── guardrail/              # 3 个守护 Skills (constitution-guardian, tdd-enforcer)
+└── utility/                # 8 个工具 Skills (npm-release, skill-creator)
+```
+
+**按分类的关键 Skills**:
 
-**触发机制**:
-1. **关键词触发** - 输入包含特定关键词
-2. **意图匹配** - 正则匹配用户意图
-3. **文件触发** - 编辑特定路径文件
-4. **内容匹配** - 文件内容匹配特定模式
+| 分类 | Skills | 用途 |
+|------|--------|------|
+| **Workflow** | flow-init, flow-spec, flow-dev, flow-quality, flow-release | 核心开发工作流 |
+| **Domain** | tdd, debugging, brainstorming, verification | 领域专业知识 |
+| **Guardrail** | constitution-guardian, tdd-enforcer | 实时合规检查 |
+| **Utility** | npm-release, skill-creator, writing-skills | 开发工具 |
+
+**上下文注入** (借鉴 Trellis):
+- 每个 Skill 有 `context.jsonl` 定义所需上下文文件
+- `inject-skill-context.ts` 钩子在 Skill 执行前自动加载上下文
+- 变量替换: `{REQ}` → 实际需求 ID
 
 📚 [完整 Skills 文档](docs/guides/skills-system.zh-CN.md)
 </details>
@@ -244,11 +256,13 @@ bash .claude/tests/constitution/run_all_constitution_tests.sh
 |------|------|----------|----------|
 | `/flow-new` | 🎯 启动新需求 | `/flow-new "REQ-123\|功能"` | [→](docs/commands/flow-new.zh-CN.md) |
 | `/flow-init` | 📦 初始化需求 | `/flow-init "REQ-123\|功能"` | [→](docs/commands/flow-init.zh-CN.md) |
-| `/flow-clarify` | 🔎 澄清歧义 | `/flow-clarify "REQ-123"` | [→](.claude/commands/flow-clarify.md) |
-| `/flow-checklist` | ✅ 需求质量检查 | `/flow-checklist --type ux` | [→](.claude/commands/flow-checklist.md) |
-| `/flow-verify` | 🔍 验证一致性 | `/flow-verify "REQ-123"` | [→](docs/commands/flow-verify.zh-CN.md) |
-| `/flow-qa` | 🧪 质量保证 | `/flow-qa "REQ-123"` | [→](docs/commands/flow-qa.zh-CN.md) |
-| `/flow-release` | 🚢 创建发布 | `/flow-release "REQ-123"` | [→](docs/commands/flow-release.zh-CN.md) |
+| `/flow-clarify` | 🔎 澄清歧义 | `/flow-clarify "REQ-123"` | [→](.claude/commands/flow/clarify.md) |
+| `/flow-spec` | 📋 统一规格阶段 (v4.1) | `/flow-spec "REQ-123"` | [→](.claude/commands/flow/spec.md) |
+| `/flow-checklist` | ✅ 需求质量检查 | `/flow-checklist --type ux` | [→](.claude/commands/flow/checklist.md) |
+| `/flow-quality` | ✅ 统一质量验证 | `/flow-quality "REQ-123" --full` | [→](.claude/commands/flow/quality.md) |
+| `/flow-fix` | 🐛 系统化缺陷修复 | `/flow-fix "BUG-123\|描述"` | [→](.claude/commands/flow/fix.md) |
+| `/flow-verify` | 🔍 验证一致性 | `/flow-verify "REQ-123"` | [→](.claude/commands/flow/verify.md) |
+| `/flow-release` | 🚢 创建发布 | `/flow-release "REQ-123"` | [→](.claude/commands/flow/release.md) |
 
 📚 [完整命令参考](docs/commands/README.zh-CN.md)
 
@@ -268,7 +282,7 @@ bash .claude/tests/constitution/run_all_constitution_tests.sh
 ├─ 开发中断需要继续？ → /flow-restart "REQ-123"
 ├─ 检查开发进度？ → /flow-status REQ-123
 ├─ 发现文档不一致？ → /flow-verify "REQ-123"
-├─ 开发完成需要测试？ → /flow-qa "REQ-123"
+├─ 开发完成需要验证？ → /flow-quality "REQ-123" --full
 ├─ 修复生产 Bug？ → /flow-fix "BUG-001|描述"
 └─ 准备发布？ → /flow-release "REQ-123"
 ```
@@ -283,53 +297,42 @@ bash .claude/tests/constitution/run_all_constitution_tests.sh
 ```mermaid
 graph TB
     Start([项目启动]) --> ProjectLevel{项目级初始化}
-    
+
     ProjectLevel --> CoreRoadmap["/core-roadmap<br/>ROADMAP.md & BACKLOG.md"]
     ProjectLevel --> CoreArch["/core-architecture<br/>ARCHITECTURE.md"]
     ProjectLevel --> CoreGuidelines["/core-guidelines<br/>前端/后端规范"]
     ProjectLevel --> CoreStyle["/core-style<br/>STYLE.md"]
-    
+
     CoreRoadmap --> ReqLevel
     CoreArch --> ReqLevel
     CoreGuidelines --> ReqLevel
     CoreStyle --> ReqLevel
-    
-    ReqLevel([需求级开发流程]) --> FlowInit["/flow-init<br/>research.md & tasks.json"]
-    
+
+    ReqLevel([需求级开发流程]) --> FlowInit["/flow-init<br/>research.md & BRAINSTORM.md"]
+
     FlowInit --> FlowClarify["/flow-clarify<br/>clarifications/*.md<br/>可选"]
-    FlowClarify --> FlowPRD["/flow-prd<br/>PRD.md"]
-    FlowInit -.->|跳过澄清| FlowPRD
-    FlowPRD --> FlowChecklist["/flow-checklist<br/>checklists/*.md<br/>80%门禁"]
-    FlowPRD --> FlowTech["/flow-tech<br/>TECH_DESIGN.md & 数据模型"]
-    FlowPRD --> FlowUI["/flow-ui<br/>UI_PROTOTYPE.html<br/>可选"]
-
-    FlowChecklist --> FlowEpic
-    FlowTech --> FlowEpic["/flow-epic<br/>EPIC.md & TASKS.md"]
-    FlowUI --> FlowEpic
-    
-    FlowEpic --> FlowDev["/flow-dev<br/>TASKS.md 执行<br/>TDD 强制"]
-    
-    FlowDev --> FlowQA["/flow-qa<br/>QA 报告 & 安全审查"]
-    
-    FlowQA --> FlowRelease["/flow-release<br/>PR 创建 & 部署"]
-    
+    FlowClarify --> FlowSpec["/flow-spec (v4.1)<br/>PRD → Tech+UI (并行) → Epic<br/>统一规格阶段"]
+    FlowInit -.->|跳过澄清| FlowSpec
+
+    FlowSpec --> FlowDev["/flow-dev<br/>TASKS.md 执行<br/>TDD 强制"]
+
+    FlowDev --> FlowQuality["/flow-quality<br/>快速/完整验证<br/>规格 + 质量 + 安全"]
+
+    FlowQuality --> FlowRelease["/flow-release<br/>PR 创建 & 部署"]
+
     FlowRelease --> FlowVerify["/flow-verify<br/>一致性检查"]
-    
+
     FlowVerify --> End([发布完成])
-    
+
     FlowVerify -.->|可在任意阶段调用| ReqLevel
-    
+
     style ProjectLevel fill:#e1f5ff
     style ReqLevel fill:#fff4e1
     style FlowInit fill:#e8f5e9
     style FlowClarify fill:#fff9c4
-    style FlowPRD fill:#e8f5e9
-    style FlowChecklist fill:#ffe0b2
-    style FlowTech fill:#e8f5e9
-    style FlowUI fill:#fff9c4
-    style FlowEpic fill:#e8f5e9
+    style FlowSpec fill:#e8f5e9
     style FlowDev fill:#f3e5f5
-    style FlowQA fill:#fce4ec
+    style FlowQuality fill:#fce4ec
     style FlowRelease fill:#e0f2f1
     style FlowVerify fill:#e3f2fd
 ```
@@ -337,8 +340,9 @@ graph TB
 **流程说明**:
 - **项目级命令**（浅蓝色）：项目初始化时执行一次，建立全局标准（SSOT）
 - **需求级命令**（浅橙色）：每个需求（REQ-XXX）执行一次
-- **可选步骤**（黄色）：`/flow-clarify` 和 `/flow-ui` 为可选步骤
-- **质量门禁**（橙色）：`/flow-checklist` 在 `/flow-epic` 前验证需求质量，80% 完成度阈值
+- **统一 /flow-spec** (v4.1)：替代 flow-prd/flow-tech/flow-ui/flow-epic，支持并行执行
+- **统一质量验证** (v3.0.0)：`/flow-quality --full` 合并规格合规、代码质量与安全检查
+- **可选步骤**（黄色）：`/flow-clarify` 为可选步骤，需求清晰时可跳过
 - **质量闸门**：每个阶段都有入口/出口闸门，确保文档质量和 Constitution 合规性
 - **TDD 强制执行**：`/flow-dev` 严格强制执行测试驱动开发顺序
 - **一致性检查**：`/flow-verify` 可在任意阶段调用，确保文档一致性
@@ -420,7 +424,7 @@ devflow/
 ```
 
 <details>
-<parameter name="summary">🔧 完整配置选项（点击展开）</summary>
+<summary>🔧 完整配置选项（点击展开）</summary>
 
 ### Hooks 配置
 
@@ -484,7 +488,165 @@ bash .claude/tests/run-all-tests.sh --scripts
 
 ## 📝 版本历史
 
-### v2.3.0 (2026-01-08) - 最新版本
+### v4.7.0 (2026-02-07) - 最新版本
+
+**🤝 Claude Team 集成：多 Agent 并行协作**
+
+v4.7.0 引入 Claude Team 集成，支持多 Agent 并行开发：
+
+- **flow-dev Team 模式** - 多 Agent 并行任务执行
+  - `--team` 标志启用 Team 模式（默认 3 个 Agent）
+  - `--agents N` 指定 Agent 数量（2-5）
+  - 自动任务依赖分析和冲突检测
+  - 文件冲突任务分配给同一 Agent 串行执行
+
+- **新增 Hooks** - Team 生命周期管理
+  - `TeammateIdle Hook` - 任务分配和调度
+  - `TaskCompleted Hook` - 完成时质量验证
+  - 超时检测和告警
+
+- **任务依赖解析器** - 智能任务分析
+  - `parse-task-dependencies.js` - 解析 TASKS.md 格式
+  - 识别 `[P]` 并行标记、`[US*]` 用户故事分组
+  - 基于 Phase 的依赖解析
+
+- **状态恢复** - 断点续传
+  - `team-state-recovery.sh` - 快照和恢复 Team 状态
+  - 支持中断会话恢复
+
+- **新增文件**
+  - `.claude/scripts/parse-task-dependencies.js` - 任务解析器
+  - `.claude/scripts/detect-file-conflicts.sh` - 冲突检测
+  - `.claude/scripts/team-dev-init.sh` - Dev Team 初始化
+  - `.claude/scripts/team-state-recovery.sh` - 状态恢复
+  - `.claude/docs/guides/TEAM_MODE_GUIDE.md` - 完整使用指南
+
+**📊 v4.7 改进指标**:
+| 指标 | 之前 | 之后 | 改善 |
+|------|------|------|------|
+| 并行 Agent 数 | 1 | 3-5 | +400% |
+| 需求完成时间 | 90 分钟 | 50 分钟 | -45% |
+| 任务调度 | 手动 | 自动 | 100% |
+| 质量验证 | 单点 | 分布式 | 100% |
+
+### v4.3.0 (2026-02-07)
+
+**🌿 Git Worktree 集成：并行开发支持**
+
+v4.3.0 引入 Git Worktree 集成，支持多个隔离的 Claude Code 会话并行开发：
+
+- **Git Worktree 模式（默认）** - 隔离的开发环境
+  - 创建 `../repo-name-REQ-xxx/` worktree 目录
+  - 每个 worktree 有独立的 Claude Code 会话
+  - 用 `cd` 切换需求，而非 `git checkout`
+  - `--branch-only` 标志支持传统分支模式
+
+- **新增 Skill: using-git-worktrees** - 完整的 worktree 管理
+  - `worktree-create.sh` - 创建新 worktree
+  - `worktree-list.sh` - 列出所有 worktree
+  - `worktree-switch.sh` - 切换 worktree
+  - `worktree-cleanup.sh` - 清理已合并的 worktree
+  - Shell 别名模板 (za/zl/zm/zw)
+
+- **修改的命令**
+  - `/flow-init` - 默认 worktree 模式，`--branch-only` 兼容旧模式
+  - `/flow-release` - 自动清理 worktree
+
+**📊 v4.3 改进指标**:
+| 指标 | 之前 | 之后 | 改善 |
+|------|------|------|------|
+| 并行需求数 | 1 | 3-5 | +400% |
+| 上下文切换时间 | 30s | 1s | -97% |
+| 会话隔离 | 无 | 完全 | 100% |
+
+### v4.1.0 (2026-02-07)
+
+**🎯 统一规格阶段：/flow-spec 命令**
+
+v4.1.0 将 flow-prd/flow-tech/flow-ui/flow-epic 合并为单一 `/flow-spec` 命令，支持并行执行：
+
+- **统一 /flow-spec 命令** - 一个命令完成整个规格阶段
+  - 完整模式：PRD → Tech + UI（并行）→ Epic/Tasks
+  - 快速模式：`--skip-tech --skip-ui` 适用于小需求
+  - 仅后端：`--skip-ui`
+  - 仅前端：`--skip-tech`
+
+- **并行 Agent 执行** - Tech + UI 代理并发运行
+  - 设计阶段时间减少约 35%
+  - 共享模板组件位于 `_shared/` 目录
+
+- **简化工作流** (v4.1)
+  ```
+  精简 (3 步):   /flow-init --quick → /flow-spec --skip-tech --skip-ui → /flow-dev → /flow-release
+  标准 (4 步):   /flow-init → /flow-spec → /flow-dev → /flow-quality → /flow-release
+  完整 (5 步):   /flow-init → /flow-clarify → /flow-spec → /flow-dev → /flow-quality --full → /flow-release
+  ```
+
+- **废弃命令**：`/flow-prd`、`/flow-tech`、`/flow-ui`、`/flow-epic` 已废弃（请使用 `/flow-spec`）
+
+**📊 v4.1 改进指标**:
+| 指标 | 之前 (v4.0) | 之后 (v4.1) | 改善 |
+|------|-------------|-------------|------|
+| 命令调用次数 | 4 | 1 | -75% |
+| 设计阶段时间 | 8-12 分钟 | 5-8 分钟 | -35% |
+| Entry/Exit Gate 代码 | ~280 行 | ~100 行 | -64% |
+
+### v4.0.0 (2026-02-07)
+
+**🏗️ Skills-First 架构：统一 Skills 与上下文注入**
+
+v4.0.0 引入重大架构重构，将 135 个文件重组为统一的 Skills-First 架构，借鉴 Trellis 和 OpenSpec：
+
+- **Skills-First 架构** - 所有 Skills 组织为 4 个分组
+  - `workflow/`: 9 个核心工作流 Skills (flow-init, flow-spec, flow-dev 等)
+  - `domain/`: 7 个领域专业 Skills (tdd, debugging, brainstorming, verification)
+  - `guardrail/`: 3 个实时合规 Skills (constitution-guardian, tdd-enforcer)
+  - `utility/`: 8 个开发工具 Skills (npm-release, skill-creator, writing-skills)
+
+- **JSONL 上下文注入** (借鉴 Trellis)
+  - 每个 Skill 有 `context.jsonl` 定义所需上下文文件
+  - `inject-skill-context.ts` 钩子在 Skill 执行前自动加载上下文
+  - 变量替换: `{REQ}` 替换为实际需求 ID
+  - 支持可选文件 `"optional": true`
+
+- **workflow.yaml 依赖图** (借鉴 OpenSpec)
+  - 通过 `requires` 和 `generates` 定义 Skill 依赖
+  - 文件存在性状态检测
+  - 清晰可视化 Skill 执行顺序
+
+- **自包含 Skills**
+  - 每个 Skill 目录包含: SKILL.md + context.jsonl + scripts/ + references/ + assets/
+  - SKILL.md 限制 <500 行，聚焦核心指令
+  - Agent 指令移至 `references/` 子目录
+  - 模板移至 `assets/` 子目录
+
+- **多模块跨平台编译器** (v3.0)
+  - 完整模块编译：skills、commands、agents、rules、hooks
+  - 平台专用输出格式：
+    - **Codex**: `.codex/skills/`, `.codex/prompts/`, `AGENTS.md`
+    - **Cursor**: `.cursor/rules/*.mdc`, `.cursor/subagents/`, `hooks.json`
+    - **Qwen**: `.qwen/commands/*.toml`, `.qwen/agents/`, `CONTEXT.md`
+    - **Antigravity**: `.agent/skills/`, `.agent/workflows/`, `.agent/rules/`
+  - `context.jsonl` 编译时展开，支持平台专用格式
+  - 197 个测试通过（24 个新增多模块测试）
+
+**📊 v4.0 改进指标**:
+| 指标 | 之前 | 之后 | 改善 |
+|------|------|------|------|
+| 维护点 | 4 个目录 | 1 个目录 | -75% |
+| 上下文加载 | 手动全量 | 按需自动 | -70% token |
+| 依赖可见性 | 隐式 | 显式 (workflow.yaml) | +100% |
+| 平台模块支持 | 仅命令 | 全部模块 | +400% |
+
+**📁 新增文件**:
+- `.claude/skills/workflow.yaml` - Skill 依赖图
+- `.claude/hooks/inject-skill-context.ts` - 上下文注入钩子
+- `.claude/skills/workflow/*/context.jsonl` - 每个 Skill 的上下文定义
+- `devflow/spec/{frontend,backend,shared}/index.md` - 规范索引
+- `lib/compiler/context-expander.js` - Context.jsonl 展开模块
+- `lib/compiler/__tests__/multi-module-emitters.test.js` - 多模块测试
+
+### v2.3.0 (2026-01-08)
 
 **🛡️ 纪律系统：铁律 + 合理化防御 + 压力测试**
 
@@ -541,7 +703,7 @@ v2.3.0 将 Constitution 从"文档"升级为"可执行纪律系统"，借鉴 sup
 - 交叉引用到 `rationalization-library.md`
 
 **📁 新增文件**:
-- `.claude/commands/cancel-ralph.md` - 取消 Ralph 循环命令
+- `.claude/commands/util/cancel-ralph.md` - 取消 Ralph 循环命令
 - `.claude/skills/flow-attention-refresh/SKILL.md` - 4 个注意力刷新协议
 - `.claude/hooks/ralph-stop-hook.sh` - 自引用循环 Stop Hook
 - `.claude/hooks/hooks.json` - Hook 注册配置
@@ -550,7 +712,7 @@ v2.3.0 将 Constitution 从"文档"升级为"可执行纪律系统"，借鉴 sup
 - `.claude/docs/templates/ATTEMPT_TEMPLATE.md` - 研究尝试日志格式
 - `.claude/agents/spec-reviewer.md` - 阶段 1 规格合规性审查员
 - `.claude/agents/code-quality-reviewer.md` - 阶段 2 代码质量审查员
-- `.claude/commands/flow-review.md` - 两阶段审查命令
+- `.claude/commands/flow-review.md` - 两阶段审查命令（legacy，已由 `.claude/commands/flow/quality.md` 取代）
 - `.claude/rules/rationalization-library.md` - 集中式合理化防御
 - `.claude/scripts/verify-gate.sh` - 出口闸门验证脚本
 - `.claude/skills/flow-brainstorming/` - 头脑风暴技能

package/lib/compiler/CLAUDE.md

@@ -1,9 +1,9 @@
 # Command Emitter - Compiler Module Architecture
 
 ## Purpose
-Multi-platform command compiler that transforms `.claude/commands/*.md` (SSOT) into native formats for Codex, Cursor, Qwen, and Antigravity platforms.
+Multi-platform compiler that transforms `.claude/` modules (commands, skills, agents, rules, hooks) into native formats for Codex, Cursor, Qwen, and Antigravity platforms.
 
-## Architecture
+## Architecture (v3.0)
 
 ```
 lib/compiler/
@@ -13,63 +13,90 @@ lib/compiler/
 ├── schemas.js          # Zod validation schemas (CommandIR, Manifest)
 ├── errors.js           # Custom error types (MissingFrontmatter, UnknownAlias, etc.)
 ├── skills-registry.js  # Generate skills registry from .claude/skills/
+├── platforms.js        # Platform configuration registry (v2.0)
+├── context-expander.js # context.jsonl expansion (v3.0)
 ├── index.js            # Compiler entry point, orchestrates pipeline
-└── emitters/
-    ├── base-emitter.js       # Abstract base class
-    ├── codex-emitter.js      # .codex/prompts/*.md (YAML frontmatter)
-    ├── cursor-emitter.js     # .cursor/commands/*.md (pure Markdown)
-    ├── qwen-emitter.js       # .qwen/commands/*.toml (TOML format)
-    ├── antigravity-emitter.js # .agent/workflows/*.md (12K limit, auto-split)
-    └── index.js              # Emitter factory
+├── emitters/
+│   ├── base-emitter.js       # Abstract base class (v2.0: multi-module support)
+│   ├── codex-emitter.js      # .codex/prompts/*.md, .codex/skills/*, AGENTS.md
+│   ├── cursor-emitter.js     # .cursor/commands/*.md, .cursor/rules/*.mdc, subagents/
+│   ├── qwen-emitter.js       # .qwen/commands/*.toml, .qwen/agents/*, CONTEXT.md
+│   ├── antigravity-emitter.js # .agent/workflows/*.md, .agent/skills/*, rules/
+│   └── index.js              # Emitter factory
+└── rules-emitters/           # Legacy rules emitters (deprecated)
+    └── ...
 ```
 
-## Data Flow
+## Multi-Module Compilation (v3.0)
+
+### Supported Modules
+
+| Module | Source | Codex | Cursor | Qwen | Antigravity |
+|--------|--------|-------|--------|------|-------------|
+| skills | `.claude/skills/` | `.codex/skills/` | `.cursor/rules/*.mdc` | `.qwen/commands/*.toml` | `.agent/skills/` |
+| commands | `.claude/commands/` | `.codex/prompts/` | `.cursor/commands/` | `.qwen/commands/` | `.agent/workflows/` |
+| agents | `.claude/agents/` | `AGENTS.md` | `.cursor/subagents/` | `.qwen/agents/` | `AGENTS.md` |
+| rules | `.claude/rules/` | `AGENTS.md` | `.cursor/rules/*.mdc` | `CONTEXT.md` | `.agent/rules/` |
+| hooks | `.claude/hooks/` | ❌ | `hooks.json` + `hooks/` | ❌ | ❌ |
+
+### Data Flow (v3.0)
 
 ```
-.claude/commands/*.md
+.claude/
+├── skills/*/SKILL.md
+├── commands/*.md
+├── agents/*.md
+├── rules/*.md
+└── hooks/*.ts
         │
         ▼
-┌─────────────────┐
-│     Parser      │ gray-matter → CommandIR
-│  (parser.js)    │ - Extract frontmatter
-│                 │ - Detect placeholders
-│                 │ - Compute SHA-256 hash
-└────────┬────────┘
-         │ CommandIR[]
-         ▼
-┌─────────────────┐
-│   Transformer   │ Platform-specific transforms
-│(transformer.js) │ - {SCRIPT:alias} → "bash <path>"
-│                 │ - $ARGUMENTS → {{args}} / [arguments]
-│                 │ - {AGENT_SCRIPT} + __AGENT__ substitution
-└────────┬────────┘
-         │ TransformedContent
-         ▼
-┌─────────────────┐
-│    Emitters     │ Platform format + file write
-│ (emitters/*.js) │ - Codex: MD + YAML frontmatter
-│                 │ - Cursor: pure MD
-│                 │ - Qwen: TOML
-│                 │ - Antigravity: MD + YAML (12K limit)
-└────────┬────────┘
+┌─────────────────────┐
+│  compileMultiModule │ Orchestrates all modules
+│     (index.js)      │
+└────────┬────────────┘
          │
-         ▼
-┌─────────────────┐
-│    Manifest     │ devflow/.generated/manifest.json
-│ (manifest.js)   │ - Track source/target hashes
-│                 │ - Enable incremental compilation
-│                 │ - Detect drift
-└─────────────────┘
+    ┌────┴────┬────────┬────────┬────────┐
+    ▼         ▼        ▼        ▼        ▼
+┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐
+│Skills │ │Commands│ │Agents │ │Rules  │ │Hooks  │
+│Emitter│ │Emitter │ │Emitter│ │Emitter│ │Emitter│
+└───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘
+    │         │        │        │        │
+    ▼         ▼        ▼        ▼        ▼
+Platform-specific output directories
 ```
 
 ## CLI Usage
 
 ```bash
+# Legacy: Compile commands only
 npm run adapt                       # Compile all platforms
 npm run adapt -- --platform codex   # Compile single platform
 npm run adapt -- --check            # Drift detection only
-npm run adapt -- --skills           # Generate skills-registry.json
-npm run adapt -- --verbose          # Detailed output
+
+# v3.0: Multi-module compilation
+npm run adapt -- --modules skills,commands,agents,rules
+npm run adapt -- --modules skills --platform cursor
+```
+
+## Key APIs
+
+### compile(options) - Legacy
+Compiles commands only (backward compatible).
+
+### compileMultiModule(options) - v3.0
+Compiles all specified modules.
+
+```javascript
+const { compileMultiModule } = require('./lib/compiler');
+
+await compileMultiModule({
+  sourceBaseDir: '.claude/',
+  outputBaseDir: '.',
+  platforms: ['codex', 'cursor', 'qwen', 'antigravity'],
+  modules: ['skills', 'commands', 'agents', 'rules'],
+  verbose: true
+});
 ```
 
 ## Key Schemas
@@ -77,16 +104,20 @@ npm run adapt -- --verbose          # Detailed output
 - **CommandIR**: Intermediate representation after parsing
 - **ManifestEntry**: Single compilation record (source, target, hash, platform)
 - **Manifest**: Complete compilation history
+- **PlatformConfig**: Platform-specific configuration (v2.0)
 
 ## Dependencies
 
 - `gray-matter`: Frontmatter parsing
 - `@iarna/toml`: TOML serialization (Qwen)
-- `js-yaml`: YAML serialization (Codex, Antigravity)
+- `js-yaml`: YAML serialization (Codex, Antigravity, Cursor)
 - `zod`: Schema validation
 
 ---
 
 **Created**: 2025-12-18
-**REQ**: REQ-005 (RM-007)
-**Version**: 1.0.0
+**Updated**: 2026-02-07
+**REQ**: REQ-005 (RM-007), Multi-Platform Adaptation
+**Version**: 3.0.0
+
+[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md