cxg-workflow 0.1.2

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "cxg-workflow",
+  "version": "0.1.2",
+  "description": "Codex CLI single-model workflow system - structured development workflow powered by Codex",
+  "type": "module",
+  "packageManager": "pnpm@10.17.1",
+  "author": {
+    "name": "CXG Contributors"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cainsyake/cxg-workflow"
+  },
+  "homepage": "https://github.com/cainsyake/cxg-workflow",
+  "bugs": {
+    "url": "https://github.com/cainsyake/cxg-workflow/issues"
+  },
+  "keywords": [
+    "codex",
+    "ai",
+    "cli",
+    "workflow",
+    "single-model"
+  ],
+  "bin": {
+    "cxg": "bin/cxg.mjs"
+  },
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin/cxg.mjs",
+    "dist",
+    "templates/prompts/",
+    "templates/skills/",
+    "templates/roles/"
+  ],
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "unbuild",
+    "start": "node bin/cxg.mjs",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build",
+    "test": "vitest run",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix"
+  },
+  "dependencies": {
+    "cac": "^6.7.14",
+    "fs-extra": "^11.3.2",
+    "pathe": "^2.0.3",
+    "smol-toml": "^1.4.2"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^5.4.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.36.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "unbuild": "^3.6.1",
+    "vitest": "^3.1.1"
+  }
+}

package/templates/prompts/cxg-analyze.md

@@ -0,0 +1,94 @@
+# CXG Analyze - 技术分析
+
+使用 Codex 子进程进行深度技术分析。**仅分析，不修改代码。**
+
+## 使用方法
+
+```bash
+/cxg-analyze <分析问题或任务>
+```
+
+## 你的角色
+
+你是**分析协调者**，编排分析流程：
+- **{{MCP_SEARCH_TOOL}}** – 代码上下文检索
+- **Codex 子进程** – 深度技术分析
+- **主 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 })`
+
+---
+
+## 执行工作流
+
+**分析任务**：$ARGUMENTS
+
+### 阶段 1：上下文检索
+
+`[模式：研究]`
+
+1. **Prompt 增强**：分析 $ARGUMENTS，补全为结构化需求
+2. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码
+3. 识别分析范围和关键组件
+
+### 阶段 2：深度分析
+
+`[模式：分析]`
+
+**调用子进程**（analyzer 角色）：
+- 技术可行性评估
+- 架构影响分析
+- 方案对比（2-3 个方案）
+- 风险识别
+
+### 阶段 3：综合输出
+
+`[模式：总结]`
+
+```markdown
+## 技术分析：<主题>
+
+### 核心发现
+1. <关键发现>
+
+### 方案对比
+| 方案 | 优势 | 劣势 | 风险 |
+|------|------|------|------|
+
+### 核心结论
+<1-2 句话总结>
+
+### 推荐方案
+**首选**：<方案>
+- 理由 / 风险 / 缓解措施
+
+### 后续行动
+1. [ ] <具体步骤>
+```
+
+---
+
+## 关键规则
+
+1. **仅分析不修改** — 本命令不执行任何代码变更
+2. 子进程对文件系统**零写入权限**

package/templates/prompts/cxg-commit.md

@@ -0,0 +1,88 @@
+# CXG Commit - 智能 Git 提交
+
+分析当前改动，生成 Conventional Commits 风格的提交信息。
+
+## 使用方法
+
+```bash
+/cxg-commit [options]
+```
+
+## 选项
+
+| 选项 | 说明 |
+|------|------|
+| `--all` | 暂存所有改动 |
+| `--amend` | 修补上次提交 |
+| `--emoji` | 包含 emoji 前缀 |
+
+---
+
+## 执行工作流
+
+### 阶段 1：仓库校验
+
+`[模式：检查]`
+
+1. 验证 Git 仓库状态
+2. 检测 rebase/merge 冲突
+3. 读取当前分支/HEAD 状态
+
+### 阶段 2：改动检测
+
+`[模式：分析]`
+
+1. 获取已暂存与未暂存改动
+2. 若暂存区为空：
+   - `--all` → 执行 `git add -A`
+   - 否则提示选择
+
+### 阶段 3：拆分建议
+
+`[模式：建议]`
+
+若检测到多组独立变更（>300 行 / 跨多个顶级目录），建议拆分为多次提交。
+
+### 阶段 4：生成提交信息
+
+`[模式：生成]`
+
+**格式**：`[emoji] <type>(<scope>): <subject>`
+
+- 首行 ≤ 72 字符
+- 祈使语气
+- 消息体：动机、实现要点、影响范围
+
+**语言**：根据最近 50 次提交判断中文/英文
+
+### 阶段 5：执行提交
+
+`[模式：执行]`
+
+```bash
+git commit -F .git/COMMIT_EDITMSG
+```
+
+---
+
+## Type 与 Emoji 映射
+
+| Emoji | Type | 说明 |
+|-------|------|------|
+| ✨ | `feat` | 新增功能 |
+| 🐛 | `fix` | 缺陷修复 |
+| 📝 | `docs` | 文档更新 |
+| 🎨 | `style` | 代码格式 |
+| ♻️ | `refactor` | 重构 |
+| ⚡️ | `perf` | 性能优化 |
+| ✅ | `test` | 测试相关 |
+| 🔧 | `chore` | 构建/工具 |
+
+---
+
+## 关键规则
+
+1. **仅使用 Git** — 不调用包管理器
+2. **尊重钩子** — 默认执行 Git hooks
+3. **不改源码** — 只读写 `.git/COMMIT_EDITMSG`
+4. **原子提交** — 一次提交只做一件事

package/templates/prompts/cxg-debug.md

@@ -0,0 +1,111 @@
+# CXG Debug - 问题诊断与修复
+
+定位问题根因并提供修复方案。
+
+## 使用方法
+
+```bash
+/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 })`
+
+---
+
+## 执行工作流
+
+**问题描述**：$ARGUMENTS
+
+### 阶段 1：信息收集
+
+`[模式：收集]`
+
+1. 解析错误信息和上下文
+2. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码
+3. 收集环境信息（依赖版本、配置等）
+
+### 阶段 2：根因分析
+
+`[模式：诊断]`
+
+**调用子进程**（analyzer 角色）：分析问题根因
+
+主 Codex 补充：
+- 复现路径
+- 影响范围
+- 可能的触发条件
+
+### 阶段 3：修复方案
+
+`[模式：方案]`
+
+提出修复方案（至少 1 个），包含：
+- 修复原理
+- 代码变更
+- 副作用评估
+
+请求用户选择方案。
+
+### 阶段 4：实施修复
+
+`[模式：修复]`
+
+- 执行选定方案
+- 运行测试验证
+- 确认问题已解决
+
+### 阶段 5：总结
+
+`[模式：总结]`
+
+```markdown
+## 调试报告
+
+### 问题
+<原始问题描述>
+
+### 根因
+<根因分析>
+
+### 修复
+<实施的修复方案>
+
+### 验证
+<测试结果>
+
+### 预防建议
+<如何避免类似问题>
+```
+
+---
+
+## 关键规则
+
+1. **先诊断后修复** — 确认根因再实施修复
+2. **最小修复** — 不引入不必要的代码变更
+3. 修复后必须验证

package/templates/prompts/cxg-enhance.md

@@ -0,0 +1,83 @@
+# CXG Enhance - Prompt 增强
+
+将模糊需求转化为结构化任务描述。
+
+## 使用方法
+
+```bash
+/cxg-enhance <原始需求描述>
+```
+
+## 你的角色
+
+你是**需求分析师**，将模糊、不完整的需求转化为结构化、可执行的任务描述。
+
+---
+
+## 执行工作流
+
+**原始需求**：$ARGUMENTS
+
+### 阶段 1：需求解析
+
+`[模式：解析]`
+
+分析原始需求：
+1. 识别核心意图
+2. 发现缺失信息
+3. 识别隐含假设
+4. 判断需求类型（功能 / 修复 / 优化 / 重构）
+
+### 阶段 2：上下文补全
+
+`[模式：补全]`
+
+1. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码上下文
+2. 读取 AGENTS.md 了解项目约束
+3. 分析现有代码模式
+
+### 阶段 3：结构化输出
+
+`[模式：输出]`
+
+```markdown
+## 增强后的需求
+
+### 目标
+<明确的目标描述>
+
+### 技术约束
+- <约束 1>
+- <约束 2>
+
+### 范围边界
+- 包含：<在范围内的内容>
+- 排除：<不在范围内的内容>
+
+### 验收标准
+1. [ ] <标准 1>
+2. [ ] <标准 2>
+
+### 相关代码
+- `<file1>` — <相关性说明>
+- `<file2>` — <相关性说明>
+
+### 风险与注意事项
+- <风险 1>
+```
+
+### 阶段 4：完整性评分
+
+**需求完整性评分**（0-10 分）：
+- 目标明确性（0-3）
+- 预期结果（0-3）
+- 边界范围（0-2）
+- 约束条件（0-2）
+
+---
+
+## 关键规则
+
+1. **不执行** — 只输出增强后的需求，不实施代码变更
+2. **补全不臆测** — 基于代码上下文补全，不编造需求
+3. 评分 <7 时指出需要补充的信息

package/templates/prompts/cxg-execute.md

@@ -0,0 +1,74 @@
+# CXG Execute - 按计划执行
+
+读取已批准的计划文件，按步骤执行实现。
+
+## 使用方法
+
+```bash
+/cxg-execute [计划文件路径]
+```
+
+## 你的角色
+
+你是**执行者**，严格按照批准的计划实施代码变更，用中文协助用户。
+
+---
+
+## 执行工作流
+
+**执行参数**：$ARGUMENTS
+
+### 阶段 1：加载计划
+
+`[模式：准备]`
+
+1. 读取计划文件（$ARGUMENTS 或 `.codex/plan/` 下最新文件）
+2. 验证计划完整性
+3. 列出待执行步骤，请求用户确认
+
+### 阶段 2：逐步实施
+
+`[模式：执行]`
+
+- 按计划步骤顺序执行
+- 遵循项目现有代码规范（参考 AGENTS.md）
+- 每完成一个里程碑报告进度
+- 遇到计划外情况时暂停，请求用户决策
+
+### 阶段 3：验证
+
+`[模式：验证]`
+
+1. 运行相关测试
+2. 检查类型错误
+3. 对照计划检查完成度
+
+### 阶段 4：报告
+
+`[模式：总结]`
+
+```markdown
+## 执行报告
+
+### 完成情况
+- [x] 步骤 1: <描述>
+- [x] 步骤 2: <描述>
+
+### 变更文件
+| 文件 | 操作 |
+|------|------|
+
+### 测试结果
+<测试通过/失败情况>
+
+### 遗留问题
+<如有>
+```
+
+---
+
+## 关键规则
+
+1. **严格按计划** — 不擅自添加计划外功能
+2. **关键节点确认** — 架构变更需用户确认
+3. **保持原子性** — 每步变更可独立回滚

package/templates/prompts/cxg-feat.md

@@ -0,0 +1,85 @@
+# CXG Feat - 智能功能开发
+
+快速开发新功能，自动识别需求类型并选择合适的开发流程。
+
+## 使用方法
+
+```bash
+/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 })`
+
+---
+
+## 执行工作流
+
+**功能需求**：$ARGUMENTS
+
+### 阶段 1：需求理解
+
+`[模式：分析]`
+
+1. 分析 $ARGUMENTS，识别功能类型（新增 / 扩展 / 重构）
+2. 调用 `{{MCP_SEARCH_TOOL}}` 检索相关代码
+3. 评估复杂度：
+   - **简单**（1-2 个文件）→ 直接实施
+   - **中等**（3-5 个文件）→ 简要规划后实施
+   - **复杂**（>5 个文件）→ 建议使用 `/cxg-workflow`
+
+### 阶段 2：快速规划
+
+`[模式：规划]`
+
+- 简单任务：跳过
+- 中等/复杂任务：调用子进程（architect 角色），生成简要实施方案
+- 列出变更文件和实施步骤
+- 请求用户确认
+
+### 阶段 3：实施
+
+`[模式：执行]`
+
+- 按规划实施代码变更
+- 遵循项目现有代码规范
+- 确保新功能与现有代码一致
+
+### 阶段 4：验证
+
+`[模式：验证]`
+
+- 运行相关测试
+- 检查类型错误
+- 简要总结变更
+
+---
+
+## 关键规则
+
+1. **快速交付** — 避免过度设计
+2. **遵循规范** — 与现有代码风格一致
+3. 复杂任务建议使用 `/cxg-workflow` 走完整流程

package/templates/prompts/cxg-init.md

@@ -0,0 +1,96 @@
+# CXG Init - 初始化项目上下文
+
+以「根级简明 + 模块级详尽」策略生成项目 AGENTS.md 上下文文档。
+
+## 使用方法
+
+```bash
+/cxg-init [项目摘要]
+```
+
+---
+
+## 执行工作流
+
+**项目摘要**：$ARGUMENTS
+
+### 阶段 1：项目扫描
+
+`[模式：扫描]`
+
+1. 识别项目类型（语言、框架、构建工具）
+2. 统计文件和目录结构
+3. 识别入口文件和核心模块
+
+### 阶段 2：模块分析
+
+`[模式：分析]`
+
+对每个核心模块：
+- 入口文件
+- 对外接口
+- 关键依赖
+- 测试覆盖
+
+### 阶段 3：生成 AGENTS.md
+
+`[模式：生成]`
+
+**根目录 AGENTS.md**：
+
+```markdown
+# <项目名> — <一句话描述>
+
+## 架构总览
+<Mermaid 结构图>
+
+## 模块索引
+| 模块 | 职责 | 文档 |
+|------|------|------|
+
+## 运行与开发
+### 常用命令
+### 测试策略
+
+## 编码规范
+<从现有代码推断>
+```
+
+**模块级 AGENTS.md**（每个核心模块一个）：
+
+```markdown
+# <模块名>
+
+## 职责
+## 入口
+## 对外接口
+## 依赖关系
+## 相关文件
+```
+
+### 阶段 4：输出摘要
+
+`[模式：报告]`
+
+```markdown
+## 初始化结果
+
+### 文档
+- 根级 AGENTS.md: [创建/更新]
+- 模块级 AGENTS.md: X 个
+
+### 覆盖率
+- 扫描文件: X / Y
+- 覆盖模块: X%
+
+### 推荐下一步
+- [ ] <补充建议>
+```
+
+---
+
+## 关键规则
+
+1. **只写文档** — 不修改源代码
+2. **忽略生成物** — 跳过 node_modules、dist、二进制文件
+3. **增量更新** — 已有 AGENTS.md 时做更新而非覆盖