cxg-workflow 0.1.2

package/templates/skills/cxg/analyze/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: cxg-analyze
+description: "CXG 技术分析。使用场景：需要深度技术分析但不修改代码，适合技术选型、架构评估、性能分析、安全审计。触发词：analyze、分析、评估、审计。"
+metadata:
+  short-description: "深度技术分析（只读）"
+---
+
+# CXG Analyze - 技术分析
+
+使用 Codex 子进程进行深度技术分析。**仅分析，不修改代码。**
+
+## 子进程调用规范
+
+```
+Bash({
+  command: "{{WRAPPER_BIN}} {{LITE_MODE_FLAG}}--backend codex - \"{{WORKDIR}}\" <<'EOF'
+ROLE_FILE: {{ROLE_ANALYZER}}
+<TASK>
+需求：<增强后的需求>
+上下文：<检索到的代码上下文>
+</TASK>
+OUTPUT: 技术可行性、架构影响、方案建议
+EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "技术分析"
+})
+```
+
+**等待后台任务**：`TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })`
+
+---
+
+## 执行工作流
+
+### 阶段 1：上下文检索
+
+`[模式：研究]`
+
+1. Prompt 增强：补全为结构化需求
+2. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码
+
+### 阶段 2：深度分析
+
+`[模式：分析]`
+
+调用子进程（analyzer 角色）：技术可行性、架构影响、方案对比、风险识别。
+
+### 阶段 3：综合输出
+
+`[模式：总结]`
+
+输出：核心发现、方案对比表、推荐方案、后续行动。
+
+---
+
+## 关键规则
+
+1. **仅分析不修改** — 不执行任何代码变更
+2. 子进程对文件系统**零写入权限**

package/templates/skills/cxg/commit/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: cxg-commit
+description: "CXG 智能 Git 提交。使用场景：分析当前改动生成 Conventional Commits 风格的提交信息，支持拆分建议。触发词：commit、提交、git commit。"
+metadata:
+  short-description: "Conventional Commit 生成"
+---
+
+# CXG Commit - 智能 Git 提交
+
+分析当前改动，生成 Conventional Commits 风格的提交信息。
+
+## 执行工作流
+
+### 阶段 1：仓库校验
+
+验证 Git 仓库状态，检测冲突。
+
+### 阶段 2：改动检测
+
+获取已暂存与未暂存改动。
+
+### 阶段 3：拆分建议
+
+若检测到多组独立变更（>300 行 / 跨多个顶级目录），建议拆分。
+
+### 阶段 4：生成提交信息
+
+格式：`[emoji] <type>(<scope>): <subject>`，首行 ≤ 72 字符。语言根据最近提交判断。
+
+### 阶段 5：执行提交
+
+```bash
+git commit -F .git/COMMIT_EDITMSG
+```
+
+## Type 映射
+
+| Emoji | Type | 说明 |
+|-------|------|------|
+| ✨ | feat | 新增功能 |
+| 🐛 | fix | 缺陷修复 |
+| 📝 | docs | 文档更新 |
+| ♻️ | refactor | 重构 |
+| ⚡️ | perf | 性能优化 |
+| ✅ | test | 测试相关 |
+| 🔧 | chore | 构建/工具 |
+
+---
+
+## 关键规则
+
+1. **仅使用 Git** — 不调用包管理器
+2. **原子提交** — 一次提交只做一件事

package/templates/skills/cxg/debug/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: cxg-debug
+description: "CXG 问题诊断与修复。使用场景：定位 bug 根因并提供修复方案，适合错误排查、异常定位、问题修复。触发词：debug、调试、修复 bug、排查问题、报错。"
+metadata:
+  short-description: "问题诊断与修复"
+---
+
+# CXG Debug - 问题诊断与修复
+
+定位问题根因并提供修复方案。
+
+## 子进程调用规范
+
+```
+Bash({
+  command: "{{WRAPPER_BIN}} {{LITE_MODE_FLAG}}--backend codex - \"{{WORKDIR}}\" <<'EOF'
+ROLE_FILE: {{ROLE_ANALYZER}}
+<TASK>
+需求：诊断以下问题
+问题描述：<问题描述>
+上下文：<相关代码和错误信息>
+</TASK>
+OUTPUT: 根因分析 + 修复方案
+EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "问题诊断"
+})
+```
+
+**等待后台任务**：`TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })`
+
+---
+
+## 执行工作流
+
+### 阶段 1：信息收集
+
+收集错误信息、相关代码、环境信息。调用 `{{MCP_SEARCH_TOOL}}` 检索上下文。
+
+### 阶段 2：根因分析
+
+调用子进程（analyzer 角色）分析根因。补充复现路径和影响范围。
+
+### 阶段 3：修复方案
+
+提出修复方案，请求用户选择。
+
+### 阶段 4：实施修复
+
+执行选定方案，运行测试验证。
+
+### 阶段 5：总结
+
+输出调试报告：问题、根因、修复、验证、预防建议。
+
+---
+
+## 关键规则
+
+1. **先诊断后修复** — 确认根因再修复
+2. **最小修复** — 不引入不必要的变更
+3. 修复后必须验证

package/templates/skills/cxg/enhance/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: cxg-enhance
+description: "CXG Prompt 增强。使用场景：将模糊、不完整的需求转化为结构化任务描述，适合在使用其他命令前先优化需求。触发词：enhance、增强、优化需求、结构化需求。"
+metadata:
+  short-description: "需求结构化增强"
+---
+
+# CXG Enhance - Prompt 增强
+
+将模糊需求转化为结构化任务描述。
+
+## 执行工作流
+
+### 阶段 1：需求解析
+
+`[模式：解析]`
+
+识别核心意图、缺失信息、隐含假设、需求类型。
+
+### 阶段 2：上下文补全
+
+`[模式：补全]`
+
+1. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码
+2. 读取 AGENTS.md 了解项目约束
+
+### 阶段 3：结构化输出
+
+`[模式：输出]`
+
+输出：目标、技术约束、范围边界、验收标准、相关代码、风险。
+
+### 阶段 4：完整性评分
+
+需求完整性评分（0-10 分），<7 时指出需补充信息。
+
+---
+
+## 关键规则
+
+1. **不执行** — 只输出增强后的需求
+2. **补全不臆测** — 基于代码上下文补全

package/templates/skills/cxg/execute/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: cxg-execute
+description: "CXG 按计划执行。使用场景：已有批准的实施计划，需要按步骤执行代码变更。触发词：execute、执行计划、按计划实施。"
+metadata:
+  short-description: "读取计划文件并按步骤执行"
+---
+
+# CXG Execute - 按计划执行
+
+读取已批准的计划文件，按步骤执行实现。
+
+## 执行工作流
+
+### 阶段 1：加载计划
+
+`[模式：准备]`
+
+1. 读取计划文件（参数或 `.codex/plan/` 下最新文件）
+2. 验证计划完整性
+3. 列出待执行步骤，请求用户确认
+
+### 阶段 2：逐步实施
+
+`[模式：执行]`
+
+- 按计划步骤顺序执行
+- 遵循项目代码规范（参考 AGENTS.md）
+- 每完成一个里程碑报告进度
+- 遇到计划外情况时暂停，请求用户决策
+
+### 阶段 3：验证
+
+`[模式：验证]`
+
+1. 运行相关测试
+2. 检查类型错误
+3. 对照计划检查完成度
+
+### 阶段 4：报告
+
+`[模式：总结]`
+
+输出执行报告：完成情况、变更文件、测试结果、遗留问题。
+
+---
+
+## 关键规则
+
+1. **严格按计划** — 不擅自添加计划外功能
+2. **关键节点确认** — 架构变更需用户确认
+3. **保持原子性** — 每步变更可独立回滚

package/templates/skills/cxg/feat/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: cxg-feat
+description: "CXG 智能功能开发。使用场景：快速开发新功能，自动识别复杂度并选择合适流程。适合中小功能的快速实现。触发词：feat、功能开发、新增功能、实现功能。"
+metadata:
+  short-description: "智能功能开发"
+---
+
+# CXG Feat - 智能功能开发
+
+快速开发新功能，自动识别需求类型并选择合适的开发流程。
+
+## 子进程调用规范
+
+```
+Bash({
+  command: "{{WRAPPER_BIN}} {{LITE_MODE_FLAG}}--backend codex - \"{{WORKDIR}}\" <<'EOF'
+ROLE_FILE: {{ROLE_ARCHITECT}}
+<TASK>
+需求：<功能需求>
+上下文：<项目上下文>
+</TASK>
+OUTPUT: 架构设计 + Unified Diff Patch
+EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "架构分析"
+})
+```
+
+**等待后台任务**：`TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })`
+
+---
+
+## 执行工作流
+
+### 阶段 1：需求理解
+
+`[模式：分析]`
+
+1. 分析需求，识别功能类型（新增 / 扩展 / 重构）
+2. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码
+3. 评估复杂度：简单（1-2 文件）→ 直接实施 | 中等（3-5 文件）→ 简要规划 | 复杂（>5 文件）→ 建议 `/cxg-workflow`
+
+### 阶段 2：快速规划
+
+中等/复杂任务调用子进程（architect 角色），生成简要实施方案。请求用户确认。
+
+### 阶段 3：实施
+
+按规划实施代码变更，遵循项目现有代码规范。
+
+### 阶段 4：验证
+
+运行相关测试，检查类型错误，简要总结变更。
+
+---
+
+## 关键规则
+
+1. **快速交付** — 避免过度设计
+2. **遵循规范** — 与现有代码风格一致
+3. 复杂任务建议使用完整工作流

package/templates/skills/cxg/init/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: cxg-init
+description: "CXG 初始化项目上下文。使用场景：生成项目 AGENTS.md 上下文文档，以「根级简明 + 模块级详尽」策略扫描项目并生成文档。触发词：init、初始化、初始化上下文、生成 AGENTS.md。"
+metadata:
+  short-description: "初始化 AGENTS.md 项目上下文"
+---
+
+# CXG Init - 初始化项目上下文
+
+以「根级简明 + 模块级详尽」策略生成项目 AGENTS.md 上下文文档。
+
+## 执行工作流
+
+### 阶段 1：项目扫描
+
+`[模式：扫描]`
+
+识别项目类型、文件结构、入口文件、核心模块。
+
+### 阶段 2：模块分析
+
+`[模式：分析]`
+
+对每个核心模块分析：入口文件、对外接口、关键依赖、测试覆盖。
+
+### 阶段 3：生成 AGENTS.md
+
+`[模式：生成]`
+
+**根目录 AGENTS.md**：架构总览、模块索引、运行与开发、编码规范。
+
+**模块级 AGENTS.md**：职责、入口、对外接口、依赖、相关文件。
+
+### 阶段 4：输出摘要
+
+报告创建/更新的文档、扫描覆盖率、推荐下一步。
+
+---
+
+## 关键规则
+
+1. **只写文档** — 不修改源代码
+2. **忽略生成物** — 跳过 node_modules、dist
+3. **增量更新** — 已有 AGENTS.md 时做更新

package/templates/skills/cxg/optimize/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: cxg-optimize
+description: "CXG 性能优化。使用场景：分析性能瓶颈并实施优化，适合响应慢、内存泄漏、构建慢等性能问题。触发词：optimize、优化、性能、加速。"
+metadata:
+  short-description: "性能分析与优化"
+---
+
+# CXG Optimize - 性能优化
+
+分析性能瓶颈并实施优化。
+
+## 子进程调用规范
+
+```
+Bash({
+  command: "{{WRAPPER_BIN}} {{LITE_MODE_FLAG}}--backend codex - \"{{WORKDIR}}\" <<'EOF'
+ROLE_FILE: {{ROLE_REVIEWER}}
+<TASK>
+需求：性能分析与优化建议
+目标：<优化目标>
+上下文：<相关代码和性能数据>
+</TASK>
+OUTPUT: 性能瓶颈分析 + 优化方案
+EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "性能分析"
+})
+```
+
+**等待后台任务**：`TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })`
+
+---
+
+## 执行工作流
+
+### 阶段 1：性能分析
+
+调用 `{{MCP_SEARCH_TOOL}}` 检索代码，识别性能热点。调用子进程（reviewer 角色）深度分析。
+
+### 阶段 2：优化方案
+
+按优先级列出优化建议（P0/P1/P2），请求用户选择。
+
+### 阶段 3：实施优化
+
+按选定方案实施，保持代码可读性。
+
+### 阶段 4：验证
+
+运行测试，对比优化前后指标。
+
+---
+
+## 关键规则
+
+1. **量化优先** — 优化要有可度量的收益
+2. **不牺牲可读性** — 避免过度优化
+3. 优化后必须通过所有测试

package/templates/skills/cxg/plan/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: cxg-plan
+description: "CXG 技术规划。使用场景：需要生成详细的实施计划和架构设计，适合在开始编码前进行技术方案规划。触发词：plan、规划、计划、架构设计。"
+metadata:
+  short-description: "生成实施计划和架构设计"
+---
+
+# CXG Plan - 技术规划
+
+生成详细的实施计划，包含架构设计和步骤分解。
+
+## 子进程调用规范
+
+```
+Bash({
+  command: "{{WRAPPER_BIN}} {{LITE_MODE_FLAG}}--backend codex - \"{{WORKDIR}}\" <<'EOF'
+ROLE_FILE: <角色提示词路径>
+<TASK>
+需求：<增强后的需求>
+上下文：<检索到的代码上下文>
+</TASK>
+OUTPUT: 期望输出格式
+EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "简短描述"
+})
+```
+
+**角色提示词**：分析用 `{{ROLE_ANALYZER}}`，规划用 `{{ROLE_ARCHITECT}}`
+
+**等待后台任务**：`TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })`
+
+---
+
+## 执行工作流
+
+### 阶段 1：上下文收集
+
+`[模式：研究]`
+
+1. Prompt 增强：补全为结构化需求
+2. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码
+3. 读取 AGENTS.md 了解项目上下文
+
+### 阶段 2：技术分析
+
+`[模式：分析]`
+
+调用子进程（analyzer 角色）：分析技术可行性、识别风险、提出 2-3 个方案。保存 SESSION_ID，等待用户选择方案。
+
+### 阶段 3：详细规划
+
+`[模式：规划]`
+
+调用子进程（architect 角色，resume SESSION）：基于用户选定方案，生成文件变更清单、架构设计、步骤分解、风险缓解。
+
+### 阶段 4：输出计划
+
+`[模式：输出]`
+
+将计划保存到 `.codex/plan/任务名.md`。
+
+---
+
+## 关键规则
+
+1. 子进程对文件系统**零写入权限**
+2. 计划必须用户确认后才能执行
+3. 提供可执行的具体步骤

package/templates/skills/cxg/review/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: cxg-review
+description: "CXG 代码审查。使用场景：对代码进行质量与安全审查，无参数时自动审查 git diff。适合代码提交前审查、PR 审查。触发词：review、审查、代码审查、code review。"
+metadata:
+  short-description: "代码质量与安全审查"
+---
+
+# CXG Review - 代码审查
+
+对代码进行质量与安全审查。无参数时自动审查 git diff。
+
+## 子进程调用规范
+
+```
+Bash({
+  command: "{{WRAPPER_BIN}} {{LITE_MODE_FLAG}}--backend codex - \"{{WORKDIR}}\" <<'EOF'
+ROLE_FILE: {{ROLE_REVIEWER}}
+<TASK>
+需求：审查以下代码变更
+变更内容：<diff 或代码>
+上下文：<项目上下文>
+</TASK>
+OUTPUT: 结构化审查报告（含评分）
+EOF",
+  run_in_background: true,
+  timeout: 3600000,
+  description: "代码审查"
+})
+```
+
+**等待后台任务**：`TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })`
+
+---
+
+## 执行工作流
+
+### 阶段 1：收集变更
+
+若无参数执行 `git diff`，若指定文件则读取对应代码。
+
+### 阶段 2：子进程审查
+
+调用子进程（reviewer 角色）：安全性、代码质量、性能、可维护性。
+
+### 阶段 3：综合报告
+
+输出评分报告（代码质量/安全性/性能/可维护性各 25 分）+ 必须修复 + 建议改进 + 结论。
+
+---
+
+## 关键规则
+
+1. **客观公正** — 基于事实评估
+2. **可操作** — 每个问题附带修复建议
+3. **分级** — Critical > Warning > Info

package/templates/skills/cxg/test/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: cxg-test
+description: "CXG 测试生成。使用场景：为代码生成测试用例，包括单元测试、集成测试、边界测试。触发词：test、测试、写测试、生成测试。"
+metadata:
+  short-description: "测试设计与生成"
+---
+
+# CXG Test - 测试生成
+
+为指定代码生成测试用例。
+
+## 执行工作流
+
+### 阶段 1：分析测试目标
+
+`[模式：分析]`
+
+1. 调用 `{{MCP_SEARCH_TOOL}}` 检索目标代码
+2. 识别现有测试框架和配置
+3. 分析代码路径和边界条件
+
+### 阶段 2：设计测试
+
+`[模式：设计]`
+
+按类型设计：单元测试、集成测试、边界测试。
+
+### 阶段 3：实施
+
+`[模式：实施]`
+
+按项目现有测试风格编写，使用已有测试框架，包含 Arrange-Act-Assert 结构。
+
+### 阶段 4：验证
+
+运行新增测试，报告覆盖率变化。
+
+---
+
+## 关键规则
+
+1. **遵循现有风格** — 与项目已有测试保持一致
+2. **有意义的断言** — 每个测试验证明确的行为
+3. **独立性** — 测试之间无依赖