okooooooo/ccg-workflow
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
34 Commits 1 Branch 0 Tags
d8a3ee2bfdcefbf8d05e876638d64fa5e73cbf48
Commit Graph
20 Commits
Author SHA1 Message Date
li d8a3ee2bfd fix: 修复默认语言为英文的问题 v1.3.4 
变更:
- src/i18n/index.ts: initI18n 默认语言从 'en' 改为 'zh-CN'
- package.json: 版本号 1.3.3 → 1.3.4
- src/utils/config.ts: 配置版本号更新到 1.3.4
- README.md: 添加 Codex CLI 和 Gemini CLI 徽章
- POST_DRAFT.md: 添加 Codex CLI 和 Gemini CLI 徽章，修正命令分类

问题:
- 用户反馈 npx ccg-workflow 默认显示英文界面
- 中文用户需要手动选择语言

解决方案:
- 将默认语言改为中文 (zh-CN)
- fallbackLng 保持英文，确保翻译缺失时有回退
 2026-01-05 20:54:47 +08:00
li 26fb88f3b5 fix: 修复 Windows PATH 配置安全问题 v1.3.3 
问题:
- Windows 使用 setx 配置 PATH 有 1024 字符限制
- 超长 PATH 会被截断，导致数据丢失
- 社区用户反馈中招过

修复:
- ✅ src/commands/init.ts: 改用安全追加方法
  - 使用 PowerShell GetEnvironmentVariable 先读取后追加
  - 支持最大 32767 字符（vs setx 的 1024）
  - 自动检测路径是否已存在（-notlike 判断）
  - 避免重复添加

新方法示例:
```powershell
$currentPath = [System.Environment]::GetEnvironmentVariable('PATH', 'User')
$newPath = 'C:\Users\xxx\.claude\bin'
if ($currentPath -notlike "*$newPath*") {
    [System.Environment]::SetEnvironmentVariable('PATH', "$currentPath;$newPath", 'User')
}
```

影响范围:
- 仅 Windows 用户
- 不影响 macOS/Linux 自动配置
- 向下兼容，不破坏现有配置

修改文件:
- src/commands/init.ts: Windows PATH 配置逻辑
- package.json: 版本号 1.3.2 → 1.3.3
- src/utils/config.ts: 配置版本号 1.3.3
- README.md: 添加 v1.3.3 更新说明
- POST_DRAFT.md: 更新头部和尾部版本号
- CHANGELOG.md: 详细记录修复过程和代码对比
 2026-01-05 20:27:57 +08:00
li 071ceb021e fix: 修复 MCP 配置缺失问题 v1.3.2 
问题:
- 安装后 ~/.ccg/config.toml 缺少 [mcp] 配置部分
- TypeScript 类型定义未包含 mcp 字段
- createDefaultConfig 未生成 MCP 配置

修复:
- ✅ 添加 CcgConfig.mcp 类型定义
- ✅ 更新 createDefaultConfig 生成完整 MCP 配置
  - provider = "ace-tool"
  - setup_url 指向配置教程
  - tools: code_search + prompt_enhance (ace + auggie)
  - query_param 参数名映射
- ✅ 配置版本号从 1.0.0 升级到 1.3.2

修改文件:
- src/types/index.ts: 添加 mcp 接口定义
- src/utils/config.ts: createDefaultConfig 生成 MCP 配置
- package.json: 版本号 1.3.1 → 1.3.2
 2026-01-05 20:13:46 +08:00
li 3d63141ac7 chore: bump version to 1.3.1 2026-01-05 19:53:43 +08:00
li c74c8c927b feat: 新增 MCP 动态选择系统 v1.3.0 
## 主要更新

### 1. MCP 动态选择
- ✨ 支持安装时选择 MCP 提供商（ace-tool 或 auggie）
- 🔧 自动生成 ~/.ccg/config.toml 配置文件
- 🔄 命令模板根据配置动态路由 MCP 工具

### 2. 命令模板简化
- 📝 移除外部文档引用（memorys/MCP_USAGE.md）
- 🎯 自包含配置读取说明，减少 50% 提示词长度
- 🔍 统一模式：读取 config → 获取 provider → 调用对应工具

### 3. 配置驱动架构
- 🗂️ 新增 [mcp.tools] 工具名称映射
- 🏷️ 参数名映射（query vs information_request）
- 🚫 优雅处理缺失功能（auggie 无 prompt enhancement）

### 4. 文件更改
- 修改: install.py（新增 MCP 选择逻辑）
- 修改: config.json（operation: install_mcp）
- 修改: 12 个命令模板（dev, enhance, code, analyze, etc.）
- 删除: SLASH_COMMAND_FORMAT.md, UPDATES.md（已合并到文档）
- 更新: CHANGELOG.md, README.md, CLAUDE.md

### 5. 兼容性
- ✅ 向后兼容：默认使用 ace-tool
- ✅ 支持跳过 MCP 安装
- ✅ 配置不存在时使用默认值

Breaking Changes: 无
 2026-01-05 19:42:44 +08:00
li 7a7dae187b fix: 添加二进制安装验证和错误显示 v1.2.3 
- 新增安装后运行 `--version` 验证二进制是否可执行
- 在安装结果中显示 result.errors，让用户看到安装失败原因
- 改进错误信息："Binary not found in package" 更明确
- 新增 i18n 翻译键：installationErrors（中/英）

参考 myclaude/install.sh 的验证逻辑：
- 复制二进制后立即验证
- 验证失败时明确报错
- 确保用户知道安装状态

修复用户反馈：部分用户安装后找不到 codeagent-wrapper 工具
 2026-01-05 19:14:53 +08:00
li b38d14289b chore: 删除重复的根目录提示词 v1.2.2 
- 删除多余的 prompts/ 目录（与 templates/prompts/ 重复）
- 从 package.json files 字段移除 'prompts'
- 只保留 templates/prompts/ 作为安装模板
- 减少 npm 包大小（75 files → 57 files）
 2026-01-05 18:59:22 +08:00
li 370923f5cc fix: 确保配置文件在安装失败时也能创建 v1.2.1 
- 将 writeCcgConfig() 提前到 installWorkflows() 之前执行
- 即使后续安装步骤失败，~/.ccg/config.toml 也会被创建
- 修复用户反馈：首次 init 时配置文件不存在的问题
 2026-01-05 18:56:10 +08:00
li 0fe8fd3566 feat: codeagent-wrapper 支持 ROLE_FILE 动态注入提示词 
核心功能:
- 新增 injectRoleFile() 函数，自动读取 ROLE_FILE 指定的文件
- 支持 ~/ 路径展开为用户主目录
- 在所有 stdin 读取场景自动注入（单任务模式 + 并行模式）

使用方式:
codeagent-wrapper --backend codex - $PROJECT_DIR <<'EOF'
ROLE_FILE: ~/.claude/prompts/ccg/codex/analyzer.md

<TASK>
分析任务描述
</TASK>
EOF

实现细节:
1. 正则匹配 ^ROLE_FILE 行
2. 读取文件内容
3. 替换为文件内容
4. 输出日志

修改文件:
- codeagent-wrapper/utils.go
- codeagent-wrapper/main.go
- bin/* (重新编译)
- package.json (1.1.3 → 1.2.0)

解决问题:
✅ 用户反馈：提示词文件已安装但找不到
✅ 原因：命令模板期望动态注入，但未实现
✅ 现在：完全支持 ROLE_FILE 动态注入
 2026-01-05 18:37:06 +08:00
li a719e2bf77 feat: Mac/Linux 用户自动配置 PATH，Windows 用户详细手动说明 
**新功能**:
1. **Mac/Linux 自动配置**
   - 安装完成后询问用户是否自动配置 PATH
   - 自动检测 shell 类型（zsh 或 bash）
   - 检查是否已配置，避免重复添加
   - 自动追加到 ~/.zshrc 或 ~/.bashrc
   - 提示用户运行 source 命令使配置生效

2. **Windows 详细说明**
   - 图形界面步骤说明（Win+X → 系统 → 环境变量）
   - PowerShell 自动配置命令
   - 路径格式自动转换（/ → \）

3. **非交互模式支持**
   - --skip-prompt 模式下仅显示手动配置说明
   - 不会自动修改配置文件

**用户体验改进**:
- Mac/Linux 用户：一键自动配置，无需手动编辑配置文件
- Windows 用户：清晰的分步说明 + PowerShell 快捷命令
- 已配置检测：避免重复添加 PATH

**i18n 支持**:
- 新增 11 个中英文翻译键
- 支持中英文双语提示

**影响文件**:
- src/commands/init.ts
- src/i18n/index.ts
- package.json (v1.1.2 → v1.1.3)

**测试**:
- ✅ TypeScript 类型检查通过
- ✅ 构建成功
 2026-01-05 18:24:47 +08:00
li 6786513cb8 fix: 修复 codeagent-wrapper 未安装到 PATH 的问题 
**问题描述**:
- npm 包虽然包含了 bin/ 目录下的 codeagent-wrapper 预编译二进制文件
- 但安装脚本没有将其复制到用户 PATH 中
- 导致命令模板调用 codeagent-wrapper 时报"未找到命令"错误

**解决方案**:
1. 扩展 InstallResult 类型，添加 binPath 和 binInstalled 字段
2. 在 installWorkflows 函数中：
   - 根据平台自动选择正确的二进制文件（darwin-arm64/amd64, linux-amd64, windows-amd64.exe）
   - 复制到 ~/.claude/bin/ 目录
   - Unix 系统自动添加可执行权限 (chmod 755)
3. 在 init 命令中显示安装结果和 PATH 配置提示：
   - 显示二进制文件安装路径
   - 提示用户添加到 shell 配置文件
   - 根据 shell 类型推荐配置文件 (~/.zshrc 或 ~/.bashrc)
4. 添加 i18n 翻译（中英文）

**影响文件**:
- src/types/index.ts
- src/utils/installer.ts
- src/commands/init.ts
- src/i18n/index.ts
- package.json (v1.1.1 → v1.1.2)

**测试**:
- ✅ TypeScript 类型检查通过
- ✅ 构建成功

**后续步骤**:
用户需要手动添加 ~/.claude/bin 到 PATH：
\`\`\`bash
echo 'export PATH="$HOME/.claude/bin:\$PATH"' >> ~/.zshrc
source ~/.zshrc
\`\`\`
 2026-01-05 18:20:39 +08:00
li f1a66ba1ba docs: 更新 README 添加智能更新功能说明 v1.1.1 
更新内容:
- 在「最新更新」部分新增 v1.1.0 智能更新系统说明
- 在「交互式菜单」部分详细说明更新功能
- 新增独立「更新」章节，包含更新步骤和强制修复说明
- 优化文档结构，便于用户快速找到更新方法

版本: 1.1.0 → 1.1.1 (文档更新)
 2026-01-05 17:58:41 +08:00
li 6dc274e657 feat: 新增智能更新功能 v1.1.0 
核心功能:
- 自动检测 npm 最新版本
- 一键更新所有命令模板和提示词
- 强制重装选项（修复损坏文件）
- 无需 sudo 权限，无需全局安装

技术实现:
- 新增 src/utils/version.ts - 版本管理
- 新增 src/commands/update.ts - 更新命令
- 优化安装器支持强制覆盖（force=true）
- 更新菜单集成更新选项

用户体验:
- npx ccg-workflow 选择"更新工作流"即可
- 显示当前版本 vs 最新版本对比
- 自动更新 ~/.claude/commands/ccg/ 和 prompts/
- 更新配置文件版本号

修改文件:
- src/commands/update.ts (新增)
- src/utils/version.ts (新增)
- src/commands/menu.ts
- src/index.ts
- package.json (1.0.6 → 1.1.0)
 2026-01-05 17:56:27 +08:00
li db832a4292 feat: 新增智能功能开发工作流（/ccg:scan + /ccg:feat） 
核心变更：
- 新增 /ccg:scan 命令：智能仓库扫描，生成项目上下文报告
- 新增 /ccg:feat 命令：智能功能开发（需求规划 → 设计 → 实施）
- 新增 planner agent：使用 WBS 方法论进行任务分解
- 新增 ui-ux-designer agent：为前端功能生成 UI/UX 设计方案

技术细节：
- 集成 ace-tool search_context 进行语义代码检索
- 支持三种模式：需求规划、讨论迭代、执行实施
- 自动路由：前端→Gemini，后端→Codex，全栈→并行
- 计划版本控制：.claude/plan/功能名.md → 功能名-1.md
- 实施后自动调用 /ccg:review 进行双模型审查

文件变更：
- templates/commands/scan.md（新增）
- templates/commands/feat.md（新增）
- templates/commands/agents/planner.md（新增）
- templates/commands/agents/ui-ux-designer.md（新增）
- src/utils/installer.ts（新增 scan/feat 配置）
- CLAUDE.md（更新文档，命令数量 17→19）
- package.json（版本号 1.0.5→1.0.6）

发布信息：
- npm 包：ccg-workflow@1.0.6
- 包大小：8.9 MB（压缩），15.4 MB（解压）
- 总文件数：75
 2026-01-05 17:41:09 +08:00
li a4270a9e6e feat: 补充 init-project 命令所需的两个 subagent 
- 新增 templates/commands/agents/get-current-datetime.md（获取当前时间戳）
- 新增 templates/commands/agents/init-architect.md（初始化架构师）
- 修改 installer.ts，安装时自动复制 agents 目录到 ~/.claude/commands/ccg/agents/
- 更新 CLAUDE.md 文档，添加 agents 目录说明
- 版本号：1.0.4 → 1.0.5

修复来源：用户反馈 /ccg:init 命令缺少两个子智能体，参考 zcf 原始实现补全

修改文件：
- templates/commands/agents/get-current-datetime.md（新建）
- templates/commands/agents/init-architect.md（新建）
- src/utils/installer.ts
- CLAUDE.md
- package.json
 2026-01-05 16:40:05 +08:00
li 6e897cde81 feat: 为所有多模型命令添加 codeagent-wrapper 调用示例 
- 为 10 个命令添加具体的 Bash + codeagent-wrapper 调用示例
- 使用优化后的 ROLE_FILE 方式减少 token 消耗
- 命令列表:
  1. frontend.md - Gemini/Codex 前端原型生成
  2. backend.md - Codex/Gemini 后端原型生成
  3. code.md - 三模型并行原型生成和审查
  4. review.md - Codex/Gemini 双模型代码审查
  5. analyze.md - Codex/Gemini 双模型技术分析
  6. debug.md - Codex/Gemini 双模型调试诊断
  7. optimize.md - Codex/Gemini 性能优化
  8. test.md - Codex/Gemini 测试生成
  9. think.md - Codex/Gemini 深度分析
  10. bugfix.md - Codex/Gemini 双模型修复+验证
- 更新版本号 1.0.3 → 1.0.4

修改文件:
- templates/commands/{frontend,backend,code,review,analyze,debug,optimize,test,think,bugfix}.md
- package.json
 2026-01-05 16:25:42 +08:00
li 660c375db7 perf: 优化 token 消耗 - 改用子进程读取角色提示词文件 
- 将调用方式从"主会话读取并注入"改为"子进程自己读取文件"
- 修改 <ROLE>{{读取...}}</ROLE> 为 ROLE_FILE: ~/.claude/prompts/ccg/<model>/<role>.md
- 大幅减少主会话 token 消耗
- 更新版本号 1.0.2 → 1.0.3

修改文件:
- templates/commands/_config.md (基础模式示例 + 说明)
- templates/commands/dev.md (阶段 2、3、5 的三处调用示例)
- package.json
 2026-01-05 16:18:18 +08:00
li ed0683d617 fix: 修复命令模板调用方式，明确使用 codeagent-wrapper 
**问题**: 命令模板中没有明确的 codeagent-wrapper 调用示例，导致 Claude 使用了旧的 /collaborating-with-codex skill 方式

**修复**:
- 在 dev.md 的阶段 2/3/5 添加明确的 Bash + codeagent-wrapper 调用示例
- 在 _config.md 添加警告：不要使用 /collaborating-with-codex 或 /collaborating-with-gemini
- 提供完整的 HEREDOC 语法示例，包含 ROLE、TASK、OUTPUT 结构

**版本**: 1.0.1 → 1.0.2

修改文件:
- templates/commands/dev.md (添加调用示例)
- templates/commands/_config.md (添加警告)
- package.json (版本号)
 2026-01-05 16:05:50 +08:00
li d554587384 fix: 修复命令模板中的 MCP 工具参数缺失问题 
- 在所有命令模板中添加 mcp__ace-tool__search_context 完整参数说明
  - project_root_path: 项目根目录绝对路径
  - query: 自然语言描述
- 在 enhance/dev 模板中添加 mcp__ace-tool__enhance_prompt 参数说明
  - prompt: 原始 prompt
  - conversation_history: 最近对话历史(5-10轮)
  - project_root_path: 项目根目录(可选)
- 更新 _config.md 中的提示词路径引用为 ~/.claude/prompts/ccg/<model>/<role>.md
- 更新版本号 1.0.0 → 1.0.1

修改文件:
- templates/commands/{dev,enhance,analyze,backend,bugfix,code,debug,frontend,optimize,review,test,think}.md
- templates/commands/_config.md
- package.json
 2026-01-05 15:47:01 +08:00
li 53fcade330 feat: 新增 TypeScript CLI 安装系统，支持 npx 一键安装 
- 重构为 TypeScript + unbuild 构建系统
- 新增交互式安装菜单（初始化/更新/卸载）
- 支持 npx ccg-workflow 直接运行
- 已发布至 npm: ccg-workflow@1.0.0
- 新增 Claude 角色提示词（6个专家角色）
- 更新命令模板支持三模型协作（Claude + Codex + Gemini）
- 更新 README 文档
 2026-01-05 14:44:01 +08:00