cc-devflow 4.1.0 → 4.1.2

package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md

@@ -1,77 +1,50 @@
 # Flow-New Orchestration Template
 
-> Execution flow for `/flow-new` one-shot requirement development
+> Execution flow for `/flow-new` one-shot requirement development (v4.1)
 
 ---
 
 ## Stage Execution Skeleton
 
-### [1/8] /flow-init
+### [1/6] /flow-init
 - 创建需求目录 + Git 分支
-- MCP 研究材料收集 (mandatory)
-- Exit Gate: 5-level quality check (research.md 完整性)
-
-### [2/8] /flow-prd
-- 生成 PRD.md (用户故事 + GWT 验收标准)
-- Constitution 符合性检查
-
-### [2.3/8] /flow-checklist (可选, 80% 门禁)
-- 触发条件: `quality-rules.yml` 中 `checklist_gate_enabled: true`
-- 生成 checklists/*.md (5 维度质量验证)
-- 闸门: 完成度 ≥ 80%
-
-### [2.5/8] /flow-ui (条件触发)
-**UI Detection Logic** (JavaScript):
-```javascript
-function detectUIRequirement(prdContent, projectRoot) {
-  const uiKeywords = ['用户界面', '前端', 'Web页面', 'UI', '界面设计', '交互',
-                      '页面', '表单', '按钮', '导航', '布局', '组件'];
-  const hasUIKeywords = uiKeywords.some(kw => prdContent.includes(kw));
-  const hasFrontendStack = fs.existsSync(`${projectRoot}/package.json`);
-  const isBackendOnly = prdContent.includes('纯后端');
-  return (hasUIKeywords || hasFrontendStack) && !isBackendOnly;
-}
-```
-- 输出: UI_PROTOTYPE.html + research/ui_design_strategy.md
-- 跳过: orchestration_status.json.ui_skipped = true
+- 研究材料收集 + `BRAINSTORM.md` 初始化
+- Exit Gate: `orchestration_status.status == initialized`
 
-### [2.7/8] /flow-tech (必需)
-- 生成 TECH_DESIGN.md (7 sections: 架构/技术栈/数据模型/API/安全/性能/部署)
-- 输出: data-model.md + contracts/openapi.yaml + quickstart.md
-- Exit Gate: 所有 Section 1-7 完整
+### [2/6] /flow-clarify (可选)
+- 触发条件: 需求歧义、边界冲突、验收标准不明确
+- 输出: `clarifications/*.md`
+- 若跳过: 标记 `clarify_skipped: true`
 
-### [3/8] /flow-epic
-- Entry Gate: Checklist 完成度 ≥ 80% (如果启用)
-- 生成 EPIC.md + TASKS.md
-- 验证: TASKS 覆盖 TECH_DESIGN.md 所有技术层
+### [3/6] /flow-spec
+- 统一规格阶段: PRD → Tech+UI(并行) → Epic/TASKS
+- 支持模式: `--skip-tech` / `--skip-ui`
+- Exit Gate: 规格产物完整，`status = spec_complete`
 
-### [4/8] /flow-dev
+### [4/6] /flow-dev
 **TDD 执行模式**:
 ```
 Phase 1: 分析现有代码
 Phase 2: 编写测试 (Tests First)
   ↓
-TEST VERIFICATION CHECKPOINT → 测试必须先失败
+TDD CHECKPOINT → 测试必须先失败
   ↓
 Phase 3: 实现代码
 Phase 4: 测试验证 → 测试必须通过
-Phase 5: Git 提交并标记完成
 ```
-- 输出: 实现代码 + 测试代码 + TASKS.md 更新 (checkbox 标记)
-
-### [5/8] /flow-qa --full
-**Exit Gate 检查**:
-- ✅ 所有测试通过
-- ✅ 代码覆盖率 ≥ 80%
-- ✅ 无高危安全问题
-- ✅ TypeScript 类型检查通过
-- 输出: TEST_REPORT.md + SECURITY_REPORT.md
-
-### [6/8] /flow-release
-- 生成 RELEASE_PLAN.md
-- 更新 CLAUDE.md (如有架构变更)
-- 最终构建
-- 创建 GitHub Pull Request
+- 输出: 实现代码 + 测试代码 + `TASKS.md` 勾选更新
+
+### [5/6] /flow-quality --full
+**统一质量验证**:
+- 规格合规审查
+- 代码质量审查
+- 安全扫描与测试门禁
+- 输出: `SPEC_REVIEW.md`, `CODE_QUALITY_REVIEW.md`, `SECURITY_REPORT.md`
+
+### [6/6] /flow-release
+- 生成 `RELEASE_PLAN.md`
+- 执行发布分支策略（PR/merge/squash 等）
+- 必要时更新 `CLAUDE.md`
 
 ---
 
@@ -83,65 +56,52 @@ Phase 5: Git 提交并标记完成
 
 需求: REQ-123 | 支持用户下单
 
-[1/8] ✅ 初始化完成
-[2/8] ✅ PRD生成完成
-[2.5/8] ✅ UI原型生成完成 ⚡️
-[2.7/8] ✅ 技术方案设计完成 🔧
-[3/8] ✅ Epic规划完成
-[4/8] 🔄 开发执行中... (8/18 已完成)
-[5/8] ⏳ 等待质量保证...
-[6/8] ⏳ 等待发布管理...
+[1/6] ✅ 初始化完成
+[2/6] ✅ 澄清完成 (可选)
+[3/6] ✅ 统一规格完成
+[4/6] 🔄 开发执行中... (8/18 已完成)
+[5/6] ⏳ 等待质量验证...
+[6/6] ⏳ 等待发布管理...
 ```
 
-**状态图标**:
-- ✅ 已完成
-- 🔄 执行中
-- ⏳ 等待执行
-- ⚡️ 条件触发已执行
-- 🔧 必需步骤已完成
-
 ---
 
 ## Output Structure
 
 ```
 devflow/requirements/${REQ_ID}/
-├── research/                     # [1/8]
-├── PRD.md                        # [2/8]
-├── checklists/*.md               # [2.3/8] (可选)
-├── UI_PROTOTYPE.html             # [2.5/8] (条件)
-├── TECH_DESIGN.md                # [2.7/8]
-├── data-model.md
-├── contracts/openapi.yaml
-├── quickstart.md
-├── EPIC.md                       # [3/8]
-├── TASKS.md                      # [4/8] (checkbox 标记任务完成状态)
-├── TEST_REPORT.md                # [5/8]
-├── SECURITY_REPORT.md
-└── RELEASE_PLAN.md               # [6/8]
+├── BRAINSTORM.md
+├── research/
+├── clarifications/                # 可选
+├── PRD.md
+├── TECH_DESIGN.md                 # 若未跳过 tech
+├── UI_PROTOTYPE.html              # 若未跳过 ui 且识别到 UI 需求
+├── EPIC.md
+├── TASKS.md
+├── SPEC_REVIEW.md                 # flow-quality --full
+├── CODE_QUALITY_REVIEW.md         # flow-quality --full
+├── SECURITY_REPORT.md             # flow-quality --full
+└── RELEASE_PLAN.md
 ```
 
 ---
 
 ## Status Tracking
 
-**orchestration_status.json 关键字段**:
+**orchestration_status.json 推荐字段**:
 ```json
 {
   "status": "dev_complete",
   "phase": "execution",
-  "phase0_complete": true,
-  "prd_complete": true,
-  "checklist_complete": true,    // 如果启用
-  "ui_skipped": false,            // 或 ui_complete: true
-  "tech_design_complete": true,
-  "epic_complete": true,
+  "initialized": true,
+  "clarify_complete": true,
+  "spec_complete": true,
   "dev_complete": true,
-  "qa_complete": false,
+  "quality_complete": false,
   "release_complete": false
 }
 ```
 
 ---
 
-**Last Updated**: 2025-12-19
+**Last Updated**: 2026-02-07

package/.claude/skills/workflow/flow-init/scripts/check-prerequisites.sh

@@ -85,7 +85,15 @@ done
 
 # Source common functions
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/common.sh"
+COMMON_SH="$SCRIPT_DIR/common.sh"
+if [[ ! -f "$COMMON_SH" ]]; then
+    COMMON_SH="$SCRIPT_DIR/../../../../scripts/common.sh"
+fi
+if [[ ! -f "$COMMON_SH" ]]; then
+    echo "ERROR: common.sh not found (checked local + .claude/scripts)" >&2
+    exit 1
+fi
+source "$COMMON_SH"
 
 # Get requirement paths
 eval $(get_requirement_paths)
@@ -229,4 +237,4 @@ else
         check_file "$ANALYSIS_FILE" "ANALYSIS.md"
         check_file "$PLAN_FILE" "PLAN.md"
     fi
-fi
+fi

package/.claude/skills/workflow/flow-init/scripts/create-requirement.sh

@@ -173,7 +173,15 @@ done
 
 # Source common functions
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/common.sh"
+COMMON_SH="$SCRIPT_DIR/common.sh"
+if [[ ! -f "$COMMON_SH" ]]; then
+    COMMON_SH="$SCRIPT_DIR/../../../../scripts/common.sh"
+fi
+if [[ ! -f "$COMMON_SH" ]]; then
+    echo "ERROR: common.sh not found (checked local + .claude/scripts)" >&2
+    exit 1
+fi
+source "$COMMON_SH"
 REPO_ROOT=$(get_repo_root)
 
 # Interactive mode

package/.claude/skills/workflow/flow-init/scripts/validate-research.sh

@@ -28,7 +28,15 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
 
 # shellcheck source=.claude/scripts/common.sh
-source "$SCRIPT_DIR/common.sh"
+COMMON_SH="$SCRIPT_DIR/common.sh"
+if [[ ! -f "$COMMON_SH" ]]; then
+  COMMON_SH="$SCRIPT_DIR/../../../../scripts/common.sh"
+fi
+if [[ ! -f "$COMMON_SH" ]]; then
+  echo "ERROR: common.sh not found (checked local + .claude/scripts)" >&2
+  exit 1
+fi
+source "$COMMON_SH"
 
 STRICT_MODE=false
 

package/CHANGELOG.md

@@ -7,6 +7,82 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [4.1.2] - 2026-02-07
+
+### 🔧 Adapt Compiler Migration Reliability Fixes
+
+v4.1.2 fixes regressions in multi-platform `adapt` output generation and adds regression coverage to prevent command/skill migration gaps.
+
+#### Fixed
+
+- **Nested command compilation restored**
+  - `adapt` now recursively scans `.claude/commands/**` instead of top-level only
+  - Preserves relative command paths (for example `flow/new` → platform subdirectories)
+  - Ensures command outputs are emitted to matching platform folder structures
+
+- **Skills migration completeness restored**
+  - Added recursive Skill discovery for grouped and root-level skills
+  - Registry and platform emitters now discover the same full skill set
+  - Resolved missing Codex/Cursor/Qwen/Antigravity skill outputs
+
+- **Module emission restored in main compile path**
+  - `adapt` main flow now emits skills/agents/rules/hooks in addition to commands
+  - CLI output now reports module-level emission statistics for easier verification
+
+- **Resource copy reliability improved**
+  - Handles Skill resource symlinks more robustly during emitter copy
+  - Ignores glob-style inline paths to avoid false missing-file warnings
+  - Fixed broken workflow skill symlink targets under `.claude/skills/workflow/*`
+
+#### Added
+
+- **Regression tests for adapt migration pipeline**
+  - Parser recursive command discovery tests
+  - Skill discovery tests (grouped + root-level)
+  - Compile end-to-end regression test
+  - Resource copier glob-filter test
+
+#### Benefits
+
+- ✅ `cc-devflow adapt --platform <target>` now generates complete expected outputs
+- ✅ Cross-platform command/skill migration behavior is consistent and test-protected
+- ✅ Release/debug verification is faster with explicit module emission metrics
+
+## [4.1.1] - 2026-02-07
+
+### 🔧 Flow-Init Script Reliability + Flow Docs Alignment
+
+v4.1.1 focuses on execution reliability for embedded flow-init scripts and removes stale command guidance from flow documentation.
+
+#### Fixed
+
+- **Flow-Init embedded scripts** now resolve shared `common.sh` safely
+  - Added fallback loading path from `skills/workflow/flow-init/scripts/*` to `.claude/scripts/common.sh`
+  - Prevents runtime failure when running bundled scripts directly from skill directories
+  - Affects:
+    - `check-prerequisites.sh`
+    - `create-requirement.sh`
+    - `validate-research.sh`
+
+#### Changed
+
+- **Flow command docs aligned with actual v4.1 workflow**
+  - Updated `/flow-new` orchestration to `flow-init → flow-clarify(optional) → flow-spec → flow-dev → flow-quality → flow-release`
+  - Removed outdated references to deprecated `/flow-review` and `/flow-qa` in active workflow guidance
+  - Synced bilingual README command links to namespace paths under `.claude/commands/flow/`
+
+#### Maintenance
+
+- **Lockfile metadata synchronized**
+  - Normalized `package-lock.json` package version markers to match `package.json`
+
+#### Benefits
+
+- ✅ `flow-init` script execution no longer fails due to missing local `common.sh`
+- ✅ Command docs now map to real command files and current workflow semantics
+- ✅ Release metadata consistency improved for publish pipeline
+
+
 ## [4.1.0] - 2026-02-07
 
 ### 🤖 Claude Team Integration: Multi-Agent Parallel Collaboration

package/README.md

@@ -262,14 +262,13 @@ bash .claude/tests/constitution/run_all_constitution_tests.sh
 |---------|---------|---------------|---------------|
 | `/flow-new` | 🎯 Start New Requirement | `/flow-new "REQ-123\|Feature"` | [→](docs/commands/flow-new.md) |
 | `/flow-init` | 📦 Initialize Requirement | `/flow-init "REQ-123\|Feature"` | [→](docs/commands/flow-init.md) |
-| `/flow-clarify` | 🔎 Clarify Ambiguities | `/flow-clarify "REQ-123"` | [→](.claude/commands/flow-clarify.md) |
-| `/flow-spec` | 📋 Unified Specification (v4.1) | `/flow-spec "REQ-123"` | [→](.claude/commands/flow-spec.md) |
-| `/flow-checklist` | ✅ Requirement Quality Check | `/flow-checklist --type ux` | [→](.claude/commands/flow-checklist.md) |
-| `/flow-review` | �� Two-Stage Code Review | `/flow-review "REQ-123"` | [→](.claude/commands/flow-review.md) |
-| `/flow-fix` | 🐛 Systematic Bug Fix | `/flow-fix "BUG-123\|Description"` | [→](.claude/commands/flow-fix.md) |
-| `/flow-verify` | 🔍 Verify Consistency | `/flow-verify "REQ-123"` | [→](docs/commands/flow-verify.md) |
-| `/flow-qa` | 🧪 Quality Assurance | `/flow-qa "REQ-123"` | [→](docs/commands/flow-qa.md) |
-| `/flow-release` | 🚢 Create Release | `/flow-release "REQ-123"` | [→](docs/commands/flow-release.md) |
+| `/flow-clarify` | 🔎 Clarify Ambiguities | `/flow-clarify "REQ-123"` | [→](.claude/commands/flow/clarify.md) |
+| `/flow-spec` | 📋 Unified Specification (v4.1) | `/flow-spec "REQ-123"` | [→](.claude/commands/flow/spec.md) |
+| `/flow-checklist` | ✅ Requirement Quality Check | `/flow-checklist --type ux` | [→](.claude/commands/flow/checklist.md) |
+| `/flow-quality` | ✅ Combined Quality Verification | `/flow-quality "REQ-123" --full` | [→](.claude/commands/flow/quality.md) |
+| `/flow-fix` | 🐛 Systematic Bug Fix | `/flow-fix "BUG-123\|Description"` | [→](.claude/commands/flow/fix.md) |
+| `/flow-verify` | 🔍 Verify Consistency | `/flow-verify "REQ-123"` | [→](.claude/commands/flow/verify.md) |
+| `/flow-release` | 🚢 Create Release | `/flow-release "REQ-123"` | [→](.claude/commands/flow/release.md) |
 
 📚 [Complete Command Reference](docs/commands/README.md)
 
@@ -288,7 +287,7 @@ Your Scenario:
 ├─ Continue interrupted development? → /flow-restart "REQ-123"
 ├─ Check development progress? → /flow-status REQ-123
 ├─ Found document inconsistencies? → /flow-verify "REQ-123"
-├─ Development complete, need testing? → /flow-qa "REQ-123"
+├─ Development complete, need verification? → /flow-quality "REQ-123" --full
 ├─ Fix production bug? → /flow-fix "BUG-001|Description"
 └─ Ready to release? → /flow-release "REQ-123"
 ```
@@ -322,11 +321,9 @@ graph TB
 
     FlowSpec --> FlowDev["/flow-dev<br/>TASKS.md execution<br/>TDD Checkpoint"]
 
-    FlowDev --> FlowReview["/flow-review<br/>Two-Stage Review<br/>Spec → Quality"]
+    FlowDev --> FlowQuality["/flow-quality<br/>Quick/Full Verification<br/>Spec + Quality + Security"]
 
-    FlowReview --> FlowQA["/flow-qa<br/>QA reports & Security"]
-
-    FlowQA --> FlowRelease["/flow-release<br/>PR creation<br/>Branch decision"]
+    FlowQuality --> FlowRelease["/flow-release<br/>PR creation<br/>Branch decision"]
 
     FlowRelease --> FlowVerify["/flow-verify<br/>Consistency check"]
 
@@ -340,8 +337,7 @@ graph TB
     style FlowClarify fill:#fff9c4
     style FlowSpec fill:#e8f5e9
     style FlowDev fill:#f3e5f5
-    style FlowReview fill:#e1bee7
-    style FlowQA fill:#fce4ec
+    style FlowQuality fill:#e1bee7
     style FlowRelease fill:#e0f2f1
     style FlowVerify fill:#e3f2fd
 ```
@@ -351,7 +347,7 @@ graph TB
 - **Requirement-Level Commands** (light orange): Execute once per requirement (REQ-XXX)
 - **Unified /flow-spec** (v4.1): Replaces flow-prd/flow-tech/flow-ui/flow-epic with parallel execution
 - **Brainstorming** (v2.3.0): `/flow-init` now generates `BRAINSTORM.md` as requirement "North Star"
-- **Two-Stage Review** (v2.3.0): `/flow-review` validates Spec Compliance before Code Quality
+- **Unified Quality Verification** (v3.0.0): `/flow-quality --full` combines spec compliance, code quality, and security
 - **Optional Steps** (yellow): `/flow-clarify` is optional; skip if requirements are clear
 - **TDD Checkpoint** (v2.3.0): `/flow-dev` includes mandatory TDD checkpoint (tests must FAIL first)
 - **Quality Gates**: Each stage has entry/exit gates ensuring document quality and Constitution compliance
@@ -713,7 +709,7 @@ v2.3.0 upgrades the Constitution from a "document" to an "executable discipline
 - Cross-reference to `rationalization-library.md`
 
 **📁 New Files**:
-- `.claude/commands/cancel-ralph.md` - Cancel Ralph loop command
+- `.claude/commands/util/cancel-ralph.md` - Cancel Ralph loop command
 - `.claude/skills/flow-attention-refresh/SKILL.md` - 4 attention refresh protocols
 - `.claude/hooks/ralph-stop-hook.sh` - Stop Hook for self-referential loops
 - `.claude/hooks/hooks.json` - Hook registration configuration
@@ -722,7 +718,7 @@ v2.3.0 upgrades the Constitution from a "document" to an "executable discipline
 - `.claude/docs/templates/ATTEMPT_TEMPLATE.md` - Research attempt log format
 - `.claude/agents/spec-reviewer.md` - Stage 1 spec compliance reviewer
 - `.claude/agents/code-quality-reviewer.md` - Stage 2 code quality reviewer
-- `.claude/commands/flow-review.md` - Two-stage review command
+- `.claude/commands/flow-review.md` - Two-stage review command (legacy, replaced by `.claude/commands/flow/quality.md`)
 - `.claude/rules/rationalization-library.md` - Centralized rationalization defense
 - `.claude/scripts/verify-gate.sh` - Exit gate verification script
 - `.claude/skills/flow-brainstorming/` - Brainstorming skill

package/README.zh-CN.md

@@ -256,12 +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-spec` | 📋 统一规格阶段 (v4.1) | `/flow-spec "REQ-123"` | [→](.claude/commands/flow-spec.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)
 
@@ -281,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"
 ```
@@ -315,9 +316,9 @@ graph TB
 
     FlowSpec --> FlowDev["/flow-dev<br/>TASKS.md 执行<br/>TDD 强制"]
 
-    FlowDev --> FlowQA["/flow-qa<br/>QA 报告 & 安全审查"]
+    FlowDev --> FlowQuality["/flow-quality<br/>快速/完整验证<br/>规格 + 质量 + 安全"]
 
-    FlowQA --> FlowRelease["/flow-release<br/>PR 创建 & 部署"]
+    FlowQuality --> FlowRelease["/flow-release<br/>PR 创建 & 部署"]
 
     FlowRelease --> FlowVerify["/flow-verify<br/>一致性检查"]
 
@@ -331,7 +332,7 @@ graph TB
     style FlowClarify fill:#fff9c4
     style FlowSpec fill:#e8f5e9
     style FlowDev fill:#f3e5f5
-    style FlowQA fill:#fce4ec
+    style FlowQuality fill:#fce4ec
     style FlowRelease fill:#e0f2f1
     style FlowVerify fill:#e3f2fd
 ```
@@ -340,6 +341,7 @@ graph TB
 - **项目级命令**（浅蓝色）：项目初始化时执行一次，建立全局标准（SSOT）
 - **需求级命令**（浅橙色）：每个需求（REQ-XXX）执行一次
 - **统一 /flow-spec** (v4.1)：替代 flow-prd/flow-tech/flow-ui/flow-epic，支持并行执行
+- **统一质量验证** (v3.0.0)：`/flow-quality --full` 合并规格合规、代码质量与安全检查
 - **可选步骤**（黄色）：`/flow-clarify` 为可选步骤，需求清晰时可跳过
 - **质量闸门**：每个阶段都有入口/出口闸门，确保文档质量和 Constitution 合规性
 - **TDD 强制执行**：`/flow-dev` 严格强制执行测试驱动开发顺序
@@ -701,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 注册配置
@@ -710,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/bin/adapt.js

@@ -215,6 +215,10 @@ async function main() {
       console.log(`  Files skipped: ${result.filesSkipped}`);
       console.log(`  Resources copied: ${result.resourcesCopied}`);
       console.log(`  Resources skipped: ${result.resourcesSkipped}`);
+      console.log(`  Skills emitted: ${result.skillsEmitted}`);
+      console.log(`  Agents emitted: ${result.agentsEmitted}`);
+      console.log(`  Module rules emitted: ${result.moduleRulesEmitted}`);
+      console.log(`  Hooks emitted: ${result.hooksEmitted}`);
       console.log(`  Skills registered: ${result.skillsRegistered}`);
       console.log(`  Rules generated: ${result.rulesGenerated}`);
       process.exit(0);

package/lib/compiler/CLAUDE.md

@@ -13,6 +13,8 @@ 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/
+├── skill-discovery.js  # Recursive SKILL.md discovery (grouped + root skills)
+├── resource-copier.js  # Resource collection/copy and .claude path rewriting
 ├── platforms.js        # Platform configuration registry (v2.0)
 ├── context-expander.js # context.jsonl expansion (v3.0)
 ├── index.js            # Compiler entry point, orchestrates pipeline
@@ -69,7 +71,7 @@ Platform-specific output directories
 ## CLI Usage
 
 ```bash
-# Legacy: Compile commands only
+# Compile commands + modules
 npm run adapt                       # Compile all platforms
 npm run adapt -- --platform codex   # Compile single platform
 npm run adapt -- --check            # Drift detection only
@@ -81,8 +83,8 @@ npm run adapt -- --modules skills --platform cursor
 
 ## Key APIs
 
-### compile(options) - Legacy
-Compiles commands only (backward compatible).
+### compile(options) - Main Flow
+Compiles commands and emits platform modules (skills, agents, rules, hooks).
 
 ### compileMultiModule(options) - v3.0
 Compiles all specified modules.

package/lib/compiler/__tests__/compile-regression.test.js

@@ -0,0 +1,94 @@
+/**
+ * T043: Compile Regression Tests
+ *
+ * [INPUT]: 临时 .claude 项目
+ * [OUTPUT]: compile() 端到端回归验证
+ * [POS]: 修复 adapt 回归，确保命令与技能正确落盘
+ * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const { compile } = require('../index.js');
+
+function writeFile(filePath, content) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, content);
+}
+
+function setupProjectFixture(rootDir) {
+  writeFile(path.join(rootDir, '.claude/commands/flow/new.md'), `---
+name: flow-new
+description: Create new requirement
+---
+# Flow New
+
+Run flow new
+`);
+
+  writeFile(path.join(rootDir, '.claude/skills/workflow/flow-dev/SKILL.md'), `---
+name: flow-dev
+description: Workflow dev skill
+---
+# flow-dev
+`);
+
+  writeFile(path.join(rootDir, '.claude/skills/orchestrator/SKILL.md'), `---
+name: orchestrator
+description: Root level skill
+---
+# orchestrator
+`);
+
+  writeFile(path.join(rootDir, '.claude/agents/planner.md'), `---
+name: planner
+description: Plan tasks
+---
+# planner
+`);
+
+  writeFile(path.join(rootDir, '.claude/rules/base-rule.md'), `---
+description: Base rule
+alwaysApply: true
+---
+# rule
+`);
+}
+
+describe('compile() regression', () => {
+  let tempDir;
+  let originalCwd;
+
+  beforeEach(() => {
+    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'compile-regression-'));
+    setupProjectFixture(tempDir);
+    originalCwd = process.cwd();
+    process.chdir(tempDir);
+  });
+
+  afterEach(() => {
+    process.chdir(originalCwd);
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  test('should compile nested commands and emit skills for codex', async () => {
+    const result = await compile({
+      sourceDir: '.claude/commands',
+      skillsDir: '.claude/skills',
+      outputBaseDir: '.',
+      platforms: ['codex'],
+      verbose: false
+    });
+
+    expect(result.success).toBe(true);
+    expect(result.filesCompiled).toBe(1);
+    expect(result.skillsRegistered).toBe(2);
+    expect(result.skillsEmitted).toBe(2);
+    expect(fs.existsSync('.codex/prompts/flow/new.md')).toBe(true);
+    expect(fs.existsSync('.codex/skills/flow-dev/SKILL.md')).toBe(true);
+    expect(fs.existsSync('.codex/skills/orchestrator/SKILL.md')).toBe(true);
+    expect(fs.existsSync('AGENTS.md')).toBe(true);
+  });
+});