cc-devflow 2.4.6 → 4.1.0

package/lib/compiler/platforms.js

@@ -1,50 +1,196 @@
 /**
- * T001: Platform Configuration Registry
+ * T001: Platform Configuration Registry (v2.0)
+ *
+ * [INPUT]: 无外部依赖
+ * [OUTPUT]: PLATFORM_CONFIG, PLATFORMS, getPlatformConfig, isValidPlatform, getRulesEntryPath
+ * [POS]: 编译器核心配置，定义四个目标平台的完整编译配置
+ * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  *
  * 定义四个目标平台的编译配置:
- * - cursor: Cursor IDE (.mdc format)
- * - codex: Codex CLI (SKILL.md format)
- * - qwen: Qwen Code (.toml format)
- * - antigravity: Antigravity (.md with 12K limit)
+ * - cursor: Cursor IDE (.mdc rules, subagents, hooks)
+ * - codex: Codex CLI (skills/, prompts/, AGENTS.md)
+ * - qwen: Qwen Code (.toml commands, agents/)
+ * - antigravity: Antigravity (skills/, workflows/, rules/)
  *
- * Reference: data-model.md#PlatformConfig
+ * v2.0: 支持完整功能模块 (skills, commands, agents, rules, hooks)
  */
 
 // ============================================================
-// PLATFORM_CONFIG - 平台配置注册表
+// MODULE_TYPES - 支持的模块类型
+// ============================================================
+const MODULE_TYPES = ['skills', 'commands', 'agents', 'rules', 'hooks'];
+
+// ============================================================
+// PLATFORM_CONFIG - 平台配置注册表 (v2.0)
 // ============================================================
 const PLATFORM_CONFIG = {
-  cursor: {
-    name: 'Cursor IDE',
-    folder: '.cursor/',
+  // ----------------------------------------------------------
+  // Codex CLI
+  // ----------------------------------------------------------
+  codex: {
+    name: 'Codex CLI',
+    folder: '.codex/',
+
+    // Skills 配置
+    skills: {
+      dir: 'skills/',
+      file: 'SKILL.md',
+      frontmatter: 'yaml',
+      supportsScripts: true,
+      supportsReferences: true
+    },
+
+    // Commands → Prompts
+    commands: {
+      dir: 'prompts/',
+      ext: '.md',
+      frontmatter: 'yaml',
+      argumentPattern: '$ARGUMENTS'
+    },
+
+    // Agents → AGENTS.md (项目根目录合并)
+    agents: {
+      outputFile: 'AGENTS.md',
+      mergeMode: 'append'
+    },
+
+    // Rules → AGENTS.md (合并到 agents)
+    rules: {
+      outputFile: 'AGENTS.md',
+      mergeMode: 'append'
+    },
+
+    // Hooks: 不支持
+    hooks: {
+      supported: false
+    },
+
+    // 旧版兼容字段
     rulesEntry: {
-      path: 'rules/devflow.mdc',
-      format: 'mdc'
+      path: 'skills/cc-devflow/SKILL.md',
+      format: 'markdown'
     },
-    commandsDir: 'commands/',
+    commandsDir: 'prompts/',
     commandExt: '.md',
     argumentPattern: '$ARGUMENTS',
     hasHooks: false,
     limits: {}
   },
 
-  codex: {
-    name: 'Codex CLI',
-    folder: '.codex/',
+  // ----------------------------------------------------------
+  // Cursor IDE
+  // ----------------------------------------------------------
+  cursor: {
+    name: 'Cursor IDE',
+    folder: '.cursor/',
+
+    // Skills → Rules (.mdc)
+    skills: {
+      dir: 'rules/',
+      ext: '.mdc',
+      frontmatter: 'yaml',
+      supportsGlobs: true,
+      supportsAlwaysApply: true
+    },
+
+    // Commands
+    commands: {
+      dir: 'commands/',
+      ext: '.md',
+      frontmatter: null,
+      argumentPattern: '$ARGUMENTS'
+    },
+
+    // Agents → Subagents
+    agents: {
+      dir: 'subagents/',
+      ext: '.md',
+      frontmatter: 'yaml',
+      supportsTools: true
+    },
+
+    // Rules → Rules (.mdc)
+    rules: {
+      dir: 'rules/',
+      ext: '.mdc',
+      frontmatter: 'yaml'
+    },
+
+    // Hooks: 支持
+    hooks: {
+      supported: true,
+      configFile: 'hooks.json',
+      scriptsDir: 'hooks/',
+      events: ['sessionStart', 'preToolUse', 'postToolUse', 'afterFileEdit']
+    },
+
+    // MCP 配置
+    mcp: {
+      supported: true,
+      configFile: 'mcp.json'
+    },
+
+    // 项目级指令
+    projectFile: 'AGENTS.md',
+
+    // 旧版兼容字段
     rulesEntry: {
-      path: 'skills/cc-devflow/SKILL.md',
-      format: 'markdown'
+      path: 'rules/devflow.mdc',
+      format: 'mdc'
     },
-    commandsDir: 'prompts/',
+    commandsDir: 'commands/',
     commandExt: '.md',
     argumentPattern: '$ARGUMENTS',
-    hasHooks: false,
+    hasHooks: true,
     limits: {}
   },
 
+  // ----------------------------------------------------------
+  // Qwen Code
+  // ----------------------------------------------------------
   qwen: {
     name: 'Qwen Code',
     folder: '.qwen/',
+
+    // Skills → Commands (.toml)
+    skills: {
+      dir: 'commands/',
+      ext: '.toml',
+      frontmatter: 'toml',
+      supportsNesting: true
+    },
+
+    // Commands (.toml)
+    commands: {
+      dir: 'commands/',
+      ext: '.toml',
+      frontmatter: 'toml',
+      argumentPattern: '{{args}}'
+    },
+
+    // Agents
+    agents: {
+      dir: 'agents/',
+      ext: '.md',
+      frontmatter: 'yaml',
+      supportsTemplating: true
+    },
+
+    // Rules → CONTEXT.md
+    rules: {
+      outputFile: 'CONTEXT.md',
+      mergeMode: 'append'
+    },
+
+    // Hooks: 不支持
+    hooks: {
+      supported: false
+    },
+
+    // 配置文件
+    configFile: 'settings.json',
+
+    // 旧版兼容字段
     rulesEntry: {
       path: 'commands/devflow.toml',
       format: 'toml'
@@ -56,9 +202,51 @@ const PLATFORM_CONFIG = {
     limits: {}
   },
 
+  // ----------------------------------------------------------
+  // Antigravity
+  // ----------------------------------------------------------
   antigravity: {
     name: 'Antigravity',
     folder: '.agent/',
+
+    // Skills
+    skills: {
+      dir: 'skills/',
+      file: 'SKILL.md',
+      frontmatter: 'yaml',
+      supportsScripts: true,
+      supportsReferences: true,
+      supportsMetadata: true
+    },
+
+    // Commands → Workflows
+    commands: {
+      dir: 'workflows/',
+      ext: '.md',
+      frontmatter: 'yaml',
+      argumentPattern: '$ARGUMENTS',
+      supportsTurbo: true
+    },
+
+    // Agents → AGENTS.md
+    agents: {
+      outputFile: 'AGENTS.md',
+      mergeMode: 'append'
+    },
+
+    // Rules
+    rules: {
+      dir: 'rules/',
+      ext: '.md',
+      frontmatter: null
+    },
+
+    // Hooks: 不支持
+    hooks: {
+      supported: false
+    },
+
+    // 旧版兼容字段
     rulesEntry: {
       path: 'rules/rules.md',
       format: 'markdown'
@@ -104,10 +292,71 @@ function getRulesEntryPath(platform) {
   return `${config.folder}${config.rulesEntry.path}`;
 }
 
+// ============================================================
+// getModuleConfig - 获取特定模块的配置
+// ============================================================
+function getModuleConfig(platform, moduleType) {
+  const config = getPlatformConfig(platform);
+  const moduleConfig = config[moduleType];
+
+  if (!moduleConfig) {
+    return null;
+  }
+
+  return moduleConfig;
+}
+
+// ============================================================
+// isModuleSupported - 检查平台是否支持特定模块
+// ============================================================
+function isModuleSupported(platform, moduleType) {
+  const moduleConfig = getModuleConfig(platform, moduleType);
+
+  if (!moduleConfig) {
+    return false;
+  }
+
+  // hooks 模块需要检查 supported 字段
+  if (moduleType === 'hooks') {
+    return moduleConfig.supported === true;
+  }
+
+  return true;
+}
+
+// ============================================================
+// getOutputPath - 获取模块输出路径
+// ============================================================
+function getOutputPath(platform, moduleType, filename = '') {
+  const config = getPlatformConfig(platform);
+  const moduleConfig = config[moduleType];
+
+  if (!moduleConfig) {
+    return null;
+  }
+
+  // 合并模式 (AGENTS.md, CONTEXT.md)
+  if (moduleConfig.outputFile) {
+    return moduleConfig.outputFile;
+  }
+
+  // 目录模式
+  if (moduleConfig.dir) {
+    const ext = moduleConfig.ext || '';
+    return `${config.folder}${moduleConfig.dir}${filename}${ext}`;
+  }
+
+  return null;
+}
+
 module.exports = {
   PLATFORM_CONFIG,
   PLATFORMS,
+  MODULE_TYPES,
   getPlatformConfig,
   isValidPlatform,
-  getRulesEntryPath
+  getRulesEntryPath,
+  getModuleConfig,
+  isModuleSupported,
+  getOutputPath
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cc-devflow",
-    "version": "2.4.6",
+    "version": "4.1.0",
     "description": "DevFlow CLI tool",
     "main": "bin/cc-devflow.js",
     "bin": {

package/.claude/commands/flow-epic.md

@@ -1,183 +0,0 @@
----
-name: flow-epic
-description: 'Generate Epic and Tasks breakdown. Usage: /flow-epic "REQ-123" or /flow-epic'
-scripts:
-  prereq: .claude/scripts/check-prerequisites.sh
-  setup: .claude/scripts/setup-epic.sh
-  validate_constitution: .claude/scripts/validate-constitution.sh
-agent_scripts:
-  sh: .claude/scripts/update-agent-context.sh __AGENT__
-  ps: scripts/powershell/update-agent-context.ps1 -AgentType __AGENT__
-skills:
-  tdd: .claude/skills/flow-tdd/SKILL.md
----
-
-# Flow-Epic - Epic 和任务规划命令
-
-## Bite-Sized Tasks 原则
-
-任务必须足够小：
-
-```yaml
-Task 粒度规范:
-  - 每个 step 2-5 分钟可完成
-  - "Write the failing test" = 1 step
-  - "Run it to make sure it fails" = 1 step
-  - "Implement minimal code to pass" = 1 step
-  - "Run tests and verify" = 1 step
-  - "Commit" = 1 step
-
-Task 内容规范:
-  - 精确的文件路径 (不是 "update the config")
-  - 完整的代码片段 (不是 "add validation")
-  - 精确的命令 + 期望输出
-  - 明确的验收标准
-
-Bad Task Examples:
-  ❌ "Implement user authentication"
-  ❌ "Add validation"
-  ❌ "Update the API"
-
-Good Task Examples:
-  ✅ "Create src/auth/login.ts with LoginRequest interface"
-  ✅ "Write failing test: POST /api/login returns 401 for invalid credentials"
-  ✅ "Run npm test -- --grep 'login' and verify test fails"
-  ✅ "Implement login handler to pass the test"
-```
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID?"
-```
-空输入时根据当前分支或 `DEVFLOW_REQ_ID` 自动解析；如果无法解析必须直接报错。
-
-## 命令格式
-```text
-/flow-epic "REQ_ID"
-/flow-epic             # Auto-detect from current branch
-```
-
-## 执行流程
-
-### 阶段 1: Entry Gate
-```
-1. Requirement ID
-   → Provided: use argument
-   → Else: run {SCRIPT:prereq} --json --paths-only
-   → Missing: ERROR "No requirement ID found."
-
-2. 结构校验
-   → 需求目录、EXECUTION_LOG.md、orchestration_status.json 必须存在
-   → PRD.md 完整且无 {{PLACEHOLDER}}
-   → 研究产物（/flow-init 输出）：
-      • research/research.md (研究摘要，Decision/Rationale/Alternatives 格式)
-      • research/tasks.json (研究任务列表)
-   → 技术产物（/flow-tech 输出）：
-      • TECH_DESIGN.md (技术方案总纲) ⭐ planner 必读
-      • research/codebase-tech-analysis.md (代码库技术分析)
-      • data-model.md (数据模型定义)
-      • contracts/ (API 契约目录，至少 1 个文件)
-      • quickstart.md (快速启动指南)
-   → 状态校验：
-      • orchestration_status.phase0_complete == true (研究阶段完成)
-      • orchestration_status.phase1_complete == true (技术设计完成)
-
-3. 状态检查
-   → status ∈ {tech_design_complete, epic_generation_failed}
-   → 已存在 EPIC.md 或 TASKS.md → WARN 并询问是否覆盖
-
-4. Constitution Gate
-   → Run: {SCRIPT:validate_constitution} --type prd --severity error --json
-   → 若有 ERROR 级违规 → 停止
-
-5. Checklist Gate (如果 checklists/ 存在)
-   → Run: node .claude/hooks/checklist-gate.js --req-id {REQ_ID} --json
-   → 若 status == "FAIL" 且无 --skip-gate:
-      • ERROR: 显示完成度不足提示
-      • 建议: "Run /flow-checklist --status to review incomplete items"
-   → 若 --skip-gate 提供:
-      • 验证 --reason 参数存在
-      • Run: node .claude/hooks/checklist-gate.js --req-id {REQ_ID} --skip --reason "{reason}"
-      • 审计日志记录到 EXECUTION_LOG.md
-   → 若 status == "PASS" 或 "SKIPPED": 继续
-   → 若 checklists/ 不存在: 跳过此检查 (Checklist 可选)
-```
-
-### 阶段 2: Epic/TASKS 初始化
-```
-1. 执行 {SCRIPT:setup} --json
-   → 返回 EPIC_FILE, TASKS_FILE, reqId, title
-2. 加载模板
-   → EPIC_TEMPLATE.md、TASKS_TEMPLATE.md
-3. 写入 orchestration_status
-   → status = "epic_generation_in_progress"
-   → phase = "planning"
-4. EXECUTION_LOG.md 追加启动记录
-```
-
-### 阶段 3: Planner Agent
-```
-Agent Prompt 要点：
-- Inputs:
-   • PRD.md
-   • TECH_DESIGN.md
-   • research/research.md (决策)
-   • data-model.md
-   • contracts/ (OpenAPI/GraphQL)
-   • quickstart.md (测试环境/命令)
-   • research/codebase-tech-analysis.md
-   • UI_PROTOTYPE.html (若存在)
-- Must:
-   • 执行 Phase -1 Gates (Simplicity / Anti-Abstraction / Integration-First)
-   • 按模板输出 EPIC.md (含 Success Metrics、Phase 2 Tests First、Complexity Tracking)
-   • 生成单一 TASKS.md：
-       - Phase 1 Setup → Phase 2 Foundational → Phase 3+ User Stories → Final Polish
-       - Phase 2 列出所有 contract/integration tests（引用 contracts/ 路径）
-       - Phase 3+ 依据 data-model 分配实体、依据 contracts 分配端点
-       - 引用 quickstart 中的命令作为测试/验证步骤
-       - 使用 `[US#]`、`[P]` 标签，包含精确文件路径
-       - 插入 “⚠️ TEST VERIFICATION CHECKPOINT” 于 Phase 2 与 Phase 3 之间
-   • Dependencies、Parallel Execution、Implementation Strategy 必须填写
-   • Constitution Check per phase
-```
-
-### 阶段 4: Exit Gate
-```
-1. 文件存在
-   → EPIC_FILE, TASKS_FILE
-
-2. EPIC.md 结构
-   → 包含 Technical Approach、Phase 2 Tests First、Complexity Tracking、Constitution Check
-   → 无 {{PLACEHOLDER}}
-
-3. TASKS.md 结构
-   → Phase 顺序正确 (Setup → Foundational → US… → Polish)
-   → Phase 2 在 Phase 3 前且包含 contract tests
-   → “⚠️ TEST VERIFICATION CHECKPOINT” 位于 Phase 2 与 Phase 3 之间
-   → 任务格式 `- [ ] T### [P?] [US#?] Description with file path`
-
-4. 依赖覆盖
-   → 数据模型任务与 data-model.md 一致
-   → API 任务覆盖 contracts/
-   → Tests 引用 quickstart 与 contracts
-
-5. 状态更新
-   → orchestration_status:
-        status = "epic_complete"
-        completedSteps append "epic"
-   → EXECUTION_LOG.md 记录完成时间
-```
-
-## 错误处理
-- 缺少任一必需产物 → 直接返回 ERROR 提示回到 `/flow-tech`。
-- Planner 生成失败 → 标记 `epic_generation_failed`，用户可修正后重试。
-- Constitution 校验不通过 → 输出违规项并终止。
-
-## 输出
-- `EPIC.md`: 包含范围、成功指标、TDD 阶段、复杂度跟踪。
-- `TASKS.md`: 单文件任务清单，按 user story 独立测试，引用 data-model、contracts、quickstart。
-
-## 后续建议
-1. 审阅任务依赖和并行策略。
-2. 立即运行 `/flow-dev` 进入实现，确保 Phase 2 Tests 先落地。
-3. 若新增技术栈，回到 `research/tasks.json` 更新研究状态并同步 agent context。