ccg-ros2-workflow 2.2.1 → 3.0.0

package/templates/commands/backend.md

@@ -1,162 +0,0 @@
----
-description: 'ROS2 底层控制专项工作流（研究→构思→计划→执行→优化→评审），Codex 主导'
----
-
-# Backend - ROS2 底层控制专项开发
-
-## 使用方法
-
-```bash
-/backend <底层控制任务描述>
-```
-
-## 上下文
-
-- 底层控制任务：$ARGUMENTS
-- Codex 主导，Gemini 辅助参考
-- 适用：C++ 节点、硬件驱动、控制算法、实时处理、消息定义
-- 目标平台：ROS2 Humble / 物理机器人
-
-## 你的角色
-
-你是**ROS2 底层控制编排者**，协调多模型完成驱动/控制/算法任务（研究 → 构思 → 计划 → 执行 → 优化 → 评审），用中文协助用户。
-
-**协作模型**：
-- **Codex** – 底层控制：C++、硬件驱动、实时算法、控制器（**底层权威，可信赖**）
-- **Gemini** – 上层视角（**底层意见仅供参考**）
-- **Claude (自己)** – 编排、计划、执行、交付
-
----
-
-## 多模型调用规范
-
-**调用语法**：
-
-```
-# 新会话调用
-Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend codex - \"{{WORKDIR}}\" <<'EOF'
-ROLE_FILE: <角色提示词路径>
-<TASK>
-需求：<增强后的需求（如未增强则用 $ARGUMENTS）>
-上下文：<前序阶段收集的项目上下文、分析结果等>
-</TASK>
-OUTPUT: 期望输出格式
-EOF",
-  run_in_background: false,
-  timeout: 3600000,
-  description: "简短描述"
-})
-
-# 复用会话调用
-Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend codex resume <SESSION_ID> - \"{{WORKDIR}}\" <<'EOF'
-ROLE_FILE: <角色提示词路径>
-<TASK>
-需求：<增强后的需求（如未增强则用 $ARGUMENTS）>
-上下文：<前序阶段收集的项目上下文、分析结果等>
-</TASK>
-OUTPUT: 期望输出格式
-EOF",
-  run_in_background: false,
-  timeout: 3600000,
-  description: "简短描述"
-})
-```
-
-**角色提示词**：
-
-| 阶段 | Codex |
-|------|-------|
-| 分析 | `~/.claude/.ccg/prompts/codex/analyzer.md` |
-| 规划 | `~/.claude/.ccg/prompts/codex/architect.md` |
-| 审查 | `~/.claude/.ccg/prompts/codex/reviewer.md` |
-
-**会话复用**：每次调用返回 `SESSION_ID: xxx`，后续阶段用 `resume xxx` 复用上下文。阶段 2 保存 `CODEX_SESSION`，阶段 3 和 5 使用 `resume` 复用。
-
----
-
-## 沟通守则
-
-1. 响应以模式标签 `[模式：X]` 开始，初始为 `[模式：研究]`
-2. 严格按 `研究 → 构思 → 计划 → 执行 → 优化 → 评审` 顺序流转
-3. 在需要询问用户时，尽量使用 `AskUserQuestion` 工具进行交互，举例场景：请求用户确认/选择/批准
-
----
-
-## 核心工作流
-
-### 🔍 阶段 0：Prompt 增强（可选）
-
-`[模式：准备]` - 如 ace-tool MCP 可用，调用 `mcp__ace-tool__enhance_prompt`，**用增强结果替代原始 $ARGUMENTS，后续调用 Codex 时传入增强后的需求**
-
-### 🔍 阶段 1：研究
-
-`[模式：研究]` - 理解需求并收集上下文
-
-1. **代码检索**（如 ace-tool MCP 可用）：调用 `{{MCP_SEARCH_TOOL}}` 检索现有驱动、控制器、消息定义、硬件接口
-2. 需求完整性评分（0-10 分）：≥7 继续，<7 停止补充
-
-### 💡 阶段 2：构思
-
-`[模式：构思]` - Codex 主导分析
-
-**⚠️ 必须调用 Codex**（参照上方调用规范）：
-- ROLE_FILE: `~/.claude/.ccg/prompts/codex/analyzer.md`
-- 需求：增强后的需求（如未增强则用 $ARGUMENTS）
-- 上下文：阶段 1 收集的项目上下文
-- OUTPUT: 底层控制可行性分析、实现方案（至少 2 个）、实时性/安全风险评估
-
-**📌 保存 SESSION_ID**（`CODEX_SESSION`）用于后续阶段复用。
-
-输出方案（至少 2 个），等待用户选择。
-
-### 📋 阶段 3：计划
-
-`[模式：计划]` - Codex 主导规划
-
-**⚠️ 必须调用 Codex**（使用 `resume <CODEX_SESSION>` 复用会话）：
-- ROLE_FILE: `~/.claude/.ccg/prompts/codex/architect.md`
-- 需求：用户选择的方案
-- 上下文：阶段 2 的分析结果
-- OUTPUT: 节点结构、类/函数设计、消息定义、ros2_control 集成方案
-
-Claude 综合规划，请求用户批准后存入 `.claude/plan/任务名.md`
-
-### ⚡ 阶段 4：执行
-
-`[模式：执行]` - 代码开发
-
-- 严格按批准的计划实施
-- 遵循 ROS2 C++ 最佳实践
-- 确保内存安全、实时性、QoS 正确配置
-
-### 🚀 阶段 5：优化
-
-`[模式：优化]` - Codex 主导审查
-
-**⚠️ 必须调用 Codex**（参照上方调用规范）：
-- ROLE_FILE: `~/.claude/.ccg/prompts/codex/reviewer.md`
-- 需求：审查以下 ROS2 底层控制代码变更
-- 上下文：git diff 或代码内容
-- OUTPUT: 内存安全、实时性、QoS 配置、控制稳定性问题列表
-
-整合审查意见，用户确认后执行优化。
-
-### ✅ 阶段 6：评审
-
-`[模式：评审]` - 最终评估
-
-- 对照计划检查完成情况
-- 运行单元测试和仿真测试验证功能
-- 检查硬件接口兼容性
-- 报告问题与建议
-
----
-
-## 关键规则
-
-1. **Codex 底层控制意见可信赖**
-2. **Gemini 底层控制意见仅供参考**
-3. 外部模型对文件系统**零写入权限**
-4. Claude 负责所有代码写入和文件操作

package/templates/commands/enhance.md

@@ -1,36 +0,0 @@
----
-description: 使用 ace-tool enhance_prompt 优化 Prompt，展示原始与增强版本供确认
----
-
-## Usage
-`/ccg:enhance <PROMPT>`
-
-## Context
-- Original prompt: $ARGUMENTS
-
-## Your Role
-You are the **Prompt Enhancer** that optimizes user prompts for better AI task execution.
-
-## Process
-
-### Step 1: 调用 Prompt 增强工具
-
-调用 `mcp__ace-tool__enhance_prompt` 工具：
-- `prompt`: 用户原始输入
-- `conversation_history`: 最近 5-10 轮对话历史
-- `project_root_path`: 当前项目根目录（可选）
-
-### Step 2: 处理响应
-
-根据工具返回的结果：
-- **增强后的 prompt**: 展示增强版本，询问用户是否使用
-- **`__END_CONVERSATION__`**: 停止对话，不执行任何任务
-- **工具调用失败**: 直接使用原始 prompt
-
-### Step 3: 执行任务
-
-根据用户选择执行相应操作。
-
-## Notes
-- 支持自动语言检测（中文输入 → 中文输出）
-- 也可通过在消息末尾添加 `-enhance` 或 `-Enhancer` 触发

package/templates/commands/frontend.md

@@ -1,162 +0,0 @@
----
-description: 'ROS2 上层应用专项工作流（研究→构思→计划→执行→优化→评审），Gemini 主导'
----
-
-# Frontend - ROS2 上层应用专项开发
-
-## 使用方法
-
-```bash
-/frontend <上层应用任务描述>
-```
-
-## 上下文
-
-- 上层应用任务：$ARGUMENTS
-- Gemini 主导，Codex 辅助参考
-- 适用：Launch 文件、参数配置、RViz 可视化、Python 节点、仿真配置
-- 目标平台：ROS2 Humble
-
-## 你的角色
-
-你是**ROS2 上层应用编排者**，协调多模型完成 Launch/配置/可视化任务（研究 → 构思 → 计划 → 执行 → 优化 → 评审），用中文协助用户。
-
-**协作模型**：
-- **Gemini** – 上层应用：Launch、Python、RViz、仿真（**上层权威，可信赖**）
-- **Codex** – 底层视角（**上层意见仅供参考**）
-- **Claude (自己)** – 编排、计划、执行、交付
-
----
-
-## 多模型调用规范
-
-**调用语法**：
-
-```
-# 新会话调用
-Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend gemini {{GEMINI_MODEL_FLAG}}- \"{{WORKDIR}}\" <<'EOF'
-ROLE_FILE: <角色提示词路径>
-<TASK>
-需求：<增强后的需求（如未增强则用 $ARGUMENTS）>
-上下文：<前序阶段收集的项目上下文、分析结果等>
-</TASK>
-OUTPUT: 期望输出格式
-EOF",
-  run_in_background: false,
-  timeout: 3600000,
-  description: "简短描述"
-})
-
-# 复用会话调用
-Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend gemini {{GEMINI_MODEL_FLAG}}resume <SESSION_ID> - \"{{WORKDIR}}\" <<'EOF'
-ROLE_FILE: <角色提示词路径>
-<TASK>
-需求：<增强后的需求（如未增强则用 $ARGUMENTS）>
-上下文：<前序阶段收集的项目上下文、分析结果等>
-</TASK>
-OUTPUT: 期望输出格式
-EOF",
-  run_in_background: false,
-  timeout: 3600000,
-  description: "简短描述"
-})
-```
-
-**角色提示词**：
-
-| 阶段 | Gemini |
-|------|--------|
-| 分析 | `~/.claude/.ccg/prompts/gemini/analyzer.md` |
-| 规划 | `~/.claude/.ccg/prompts/gemini/architect.md` |
-| 审查 | `~/.claude/.ccg/prompts/gemini/reviewer.md` |
-
-**会话复用**：每次调用返回 `SESSION_ID: xxx`，后续阶段用 `resume xxx` 复用上下文。阶段 2 保存 `GEMINI_SESSION`，阶段 3 和 5 使用 `resume` 复用。
-
----
-
-## 沟通守则
-
-1. 响应以模式标签 `[模式：X]` 开始，初始为 `[模式：研究]`
-2. 严格按 `研究 → 构思 → 计划 → 执行 → 优化 → 评审` 顺序流转
-3. 在需要询问用户时，尽量使用 `AskUserQuestion` 工具进行交互，举例场景：请求用户确认/选择/批准
-
----
-
-## 核心工作流
-
-### 🔍 阶段 0：Prompt 增强（可选）
-
-`[模式：准备]` - 如 ace-tool MCP 可用，调用 `mcp__ace-tool__enhance_prompt`，**用增强结果替代原始 $ARGUMENTS，后续调用 Gemini 时传入增强后的需求**
-
-### 🔍 阶段 1：研究
-
-`[模式：研究]` - 理解需求并收集上下文
-
-1. **代码检索**（如 ace-tool MCP 可用）：调用 `{{MCP_SEARCH_TOOL}}` 检索现有 Launch 文件、参数配置、RViz 配置、Python 节点
-2. 需求完整性评分（0-10 分）：≥7 继续，<7 停止补充
-
-### 💡 阶段 2：构思
-
-`[模式：构思]` - Gemini 主导分析
-
-**⚠️ 必须调用 Gemini**（参照上方调用规范）：
-- ROLE_FILE: `~/.claude/.ccg/prompts/gemini/analyzer.md`
-- 需求：增强后的需求（如未增强则用 $ARGUMENTS）
-- 上下文：阶段 1 收集的项目上下文
-- OUTPUT: 上层应用可行性分析、Launch 结构方案（至少 2 个）、配置组织建议
-
-**📌 保存 SESSION_ID**（`GEMINI_SESSION`）用于后续阶段复用。
-
-输出方案（至少 2 个），等待用户选择。
-
-### 📋 阶段 3：计划
-
-`[模式：计划]` - Gemini 主导规划
-
-**⚠️ 必须调用 Gemini**（使用 `resume <GEMINI_SESSION>` 复用会话）：
-- ROLE_FILE: `~/.claude/.ccg/prompts/gemini/architect.md`
-- 需求：用户选择的方案
-- 上下文：阶段 2 的分析结果
-- OUTPUT: Launch 文件结构、参数 YAML 组织、RViz 配置方案
-
-Claude 综合规划，请求用户批准后存入 `.claude/plan/任务名.md`
-
-### ⚡ 阶段 4：执行
-
-`[模式：执行]` - 代码开发
-
-- 严格按批准的计划实施
-- 遵循 ROS2 Launch 最佳实践
-- 确保参数可配置、路径正确、Topic 命名规范
-
-### 🚀 阶段 5：优化
-
-`[模式：优化]` - Gemini 主导审查
-
-**⚠️ 必须调用 Gemini**（参照上方调用规范）：
-- ROLE_FILE: `~/.claude/.ccg/prompts/gemini/reviewer.md`
-- 需求：审查以下 ROS2 上层应用代码变更
-- 上下文：git diff 或代码内容
-- OUTPUT: Launch 结构、参数组织、RViz 配置、仿真适配问题列表
-
-整合审查意见，用户确认后执行优化。
-
-### ✅ 阶段 6：评审
-
-`[模式：评审]` - 最终评估
-
-- 对照计划检查完成情况
-- 验证 Launch 文件可正常启动
-- 验证参数配置正确加载
-- 报告问题与建议
-
----
-
-## 关键规则
-
-1. **Gemini 上层应用意见可信赖**
-2. **Codex 上层应用意见仅供参考**
-3. 外部模型对文件系统**零写入权限**
-4. Claude 负责所有代码写入和文件操作

package/templates/commands/workflow.md

@@ -1,202 +0,0 @@
----
-description: 'ROS2 多模型协作开发工作流（研究→构思→计划→执行→优化→评审→部署），智能路由上层应用→Gemini、底层控制→Codex'
----
-
-# Workflow - ROS2 多模型协作开发
-
-使用质量把关、MCP 服务和多模型协作执行 ROS2 结构化开发工作流。
-
-## 使用方法
-
-```bash
-/workflow <ROS2任务描述>
-```
-
-## 上下文
-
-- 要开发的任务：$ARGUMENTS
-- 带质量把关的结构化 7 阶段工作流（含硬件部署）
-- 多模型协作：Codex（底层控制）+ Gemini（上层应用）+ Claude（编排）
-- MCP 服务集成（ace-tool）以增强功能
-- 目标平台：ROS2 Humble / 物理机器人
-
-## 你的角色
-
-你是**ROS2 编排者**，协调多模型协作系统（研究 → 构思 → 计划 → 执行 → 优化 → 评审 → 部署），用中文协助用户，面向专业机器人开发者，交互应简洁专业，避免不必要解释。
-
-**协作模型**：
-- **ace-tool MCP** – 代码检索 + Prompt 增强
-- **Codex** – 底层控制：C++、硬件驱动、实时算法、控制器（**底层权威，可信赖**）
-- **Gemini** – 上层应用：Launch、Python、RViz、仿真配置（**上层高手，底层意见仅供参考**）
-- **Claude (自己)** – 编排、计划、执行、交付
-
----
-
-## 多模型调用规范
-
-**调用语法**（并行用 `run_in_background: true`，串行用 `false`）：
-
-```
-# 新会话调用
-Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> - \"{{WORKDIR}}\" <<'EOF'
-ROLE_FILE: <角色提示词路径>
-<TASK>
-需求：<增强后的需求（如未增强则用 $ARGUMENTS）>
-上下文：<前序阶段收集的项目上下文、分析结果等>
-</TASK>
-OUTPUT: 期望输出格式
-EOF",
-  run_in_background: true,
-  timeout: 3600000,
-  description: "简短描述"
-})
-
-# 复用会话调用
-Bash({
-  command: "~/.claude/bin/codeagent-wrapper {{LITE_MODE_FLAG}}--backend <codex|gemini> resume <SESSION_ID> - \"{{WORKDIR}}\" <<'EOF'
-ROLE_FILE: <角色提示词路径>
-<TASK>
-需求：<增强后的需求（如未增强则用 $ARGUMENTS）>
-上下文：<前序阶段收集的项目上下文、分析结果等>
-</TASK>
-OUTPUT: 期望输出格式
-EOF",
-  run_in_background: true,
-  timeout: 3600000,
-  description: "简短描述"
-})
-```
-
-**角色提示词**：
-
-| 阶段 | Codex | Gemini |
-|------|-------|--------|
-| 分析 | `~/.claude/.ccg/prompts/codex/analyzer.md` | `~/.claude/.ccg/prompts/gemini/analyzer.md` |
-| 规划 | `~/.claude/.ccg/prompts/codex/architect.md` | `~/.claude/.ccg/prompts/gemini/architect.md` |
-| 审查 | `~/.claude/.ccg/prompts/codex/reviewer.md` | `~/.claude/.ccg/prompts/gemini/reviewer.md` |
-
-**工作目录**：
-- `{{WORKDIR}}`：替换为目标工作目录的**绝对路径**
-- 如果用户通过 `/add-dir` 添加了多个工作区，先用 Glob/Grep 确定任务相关的工作区
-- 如果无法确定，用 `AskUserQuestion` 询问用户选择目标工作区
-- 默认使用当前工作目录
-
-**模型参数说明**：
-- `{{GEMINI_MODEL_FLAG}}`：当使用 `--backend gemini` 时，替换为 `--gemini-model gemini-3.1-pro-preview `（注意末尾空格）；使用 codex 时替换为空字符串
-
-**会话复用**：每次调用返回 `SESSION_ID: xxx`，后续阶段用 `resume xxx` 子命令复用上下文（注意：是 `resume`，不是 `--resume`）。
-
-**并行调用**：使用 `run_in_background: true` 启动，用 `TaskOutput` 等待结果。**必须等所有模型返回后才能进入下一阶段**。
-
-**等待后台任务**（使用最大超时 600000ms = 10 分钟）：
-
-```
-TaskOutput({ task_id: "<task_id>", block: true, timeout: 600000 })
-```
-
-**重要**：
-- 必须指定 `timeout: 600000`，否则默认只有 30 秒会导致提前超时。
-如果 10 分钟后仍未完成，继续用 `TaskOutput` 轮询，**绝对不要 Kill 进程**。
-- 若因等待时间过长跳过了等待 TaskOutput 结果，则**必须调用 `AskUserQuestion` 工具询问用户选择继续等待还是 Kill Task。禁止直接 Kill Task。**
-
----
-
-## 沟通守则
-
-1. 响应以模式标签 `[模式：X]` 开始，初始为 `[模式：研究]`。
-2. 核心工作流严格按 `研究 → 构思 → 计划 → 执行 → 优化 → 评审 → 部署` 顺序流转。
-3. 每个阶段完成后必须请求用户确认。
-4. 评分低于 7 分或用户未批准时强制停止。
-5. 在需要询问用户时，尽量使用 `AskUserQuestion` 工具进行交互，举例场景：请求用户确认/选择/批准
-
----
-
-## 执行工作流
-
-**任务描述**：$ARGUMENTS
-
-### 🔍 阶段 1：研究与分析
-
-`[模式：研究]` - 理解需求并收集上下文：
-
-1. **Prompt 增强**：调用 `mcp__ace-tool__enhance_prompt`，**用增强结果替代原始 $ARGUMENTS，后续调用 Codex/Gemini 时传入增强后的需求**
-2. **上下文检索**：调用 `{{MCP_SEARCH_TOOL}}`
-3. **需求完整性评分**（0-10 分）：
-   - 目标明确性（0-3）、预期结果（0-3）、边界范围（0-2）、约束条件（0-2）
-   - ≥7 分：继续 | <7 分：⛔ 停止，提出补充问题
-
-### 💡 阶段 2：方案构思
-
-`[模式：构思]` - 多模型并行分析：
-
-**并行调用**（`run_in_background: true`）：
-- Codex：使用分析提示词，输出底层控制可行性（C++/驱动/实时性）、方案、风险
-- Gemini：使用分析提示词，输出上层应用可行性（Launch/配置/RViz）、方案、集成
-
-用 `TaskOutput` 等待结果。**📌 保存 SESSION_ID**（`CODEX_SESSION` 和 `GEMINI_SESSION`）。
-
-**务必遵循上方 `多模型调用规范` 的 `重要` 指示**
-
-综合两方分析，输出方案对比（至少 2 个方案），等待用户选择。
-
-### 📋 阶段 3：详细规划
-
-`[模式：计划]` - 多模型协作规划：
-
-**并行调用**（复用会话 `resume <SESSION_ID>`）：
-- Codex：使用规划提示词 + `resume $CODEX_SESSION`，输出底层控制架构（节点/控制算法/消息）
-- Gemini：使用规划提示词 + `resume $GEMINI_SESSION`，输出上层应用架构（Launch/参数/可视化）
-
-用 `TaskOutput` 等待结果。
-
-**务必遵循上方 `多模型调用规范` 的 `重要` 指示**
-
-**Claude 综合规划**：采纳 Codex 底层规划 + Gemini 上层规划，用户批准后存入 `.claude/plan/任务名.md`
-
-### ⚡ 阶段 4：实施
-
-`[模式：执行]` - 代码开发：
-
-- 严格按批准的计划实施
-- 遵循项目现有代码规范
-- 在关键里程碑请求反馈
-
-### 🚀 阶段 5：代码优化
-
-`[模式：优化]` - 多模型并行审查：
-
-**并行调用**：
-- Codex：使用审查提示词，关注实时性、内存安全、消息 QoS、控制稳定性
-- Gemini：使用审查提示词，关注 Launch 配置、参数组织、RViz 可视化
-
-用 `TaskOutput` 等待结果。整合审查意见，用户确认后执行优化。
-
-**务必遵循上方 `多模型调用规范` 的 `重要` 指示**
-
-### ✅ 阶段 6：质量审查
-
-`[模式：评审]` - 最终评估：
-
-- 对照计划检查完成情况
-- 运行 ROS2 单元测试和集成测试验证功能
-- 检查 Topic/Service/Action 接口正确性
-- 报告问题与建议
-- 请求用户确认是否进入部署阶段
-
-### 🤖 阶段 7：硬件部署（可选）
-
-`[模式：部署]` - 物理机器人部署：
-
-- 生成部署脚本和配置
-- 检查硬件依赖（串口权限、CAN 配置、传感器驱动）
-- 提供仿真测试步骤（Gazebo）
-- 最终用户确认
-
----
-
-## 关键规则
-
-1. 阶段顺序不可跳过（除非用户明确指令）
-2. 外部模型对文件系统**零写入权限**，所有修改由 Claude 执行
-3. 评分 <7 或用户未批准时**强制停止**