ccg-workflow 2.1.15 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "2.1.15",
+  "version": "3.0.0",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
@@ -27,35 +27,11 @@
   "files": [
     "bin/ccg.mjs",
     "dist",
-    "templates/commands/analyze.md",
-    "templates/commands/backend.md",
-    "templates/commands/clean-branches.md",
-    "templates/commands/commit.md",
-    "templates/commands/debug.md",
-    "templates/commands/enhance.md",
-    "templates/commands/execute.md",
-    "templates/commands/feat.md",
-    "templates/commands/frontend.md",
-    "templates/commands/init.md",
-    "templates/commands/optimize.md",
-    "templates/commands/plan.md",
-    "templates/commands/review.md",
-    "templates/commands/rollback.md",
-    "templates/commands/test.md",
-    "templates/commands/workflow.md",
-    "templates/commands/worktree.md",
-    "templates/commands/spec-init.md",
-    "templates/commands/spec-research.md",
-    "templates/commands/spec-plan.md",
-    "templates/commands/spec-impl.md",
-    "templates/commands/spec-review.md",
-    "templates/commands/team-research.md",
-    "templates/commands/team-plan.md",
-    "templates/commands/team-exec.md",
-    "templates/commands/team-review.md",
-    "templates/commands/codex-exec.md",
-    "templates/commands/context.md",
-    "templates/commands/agents/",
+    "templates/commands/",
+    "templates/commands-legacy/",
+    "templates/engine/",
+    "templates/hooks/",
+    "templates/spec/",
     "templates/prompts/codex/",
     "templates/prompts/gemini/analyzer.md",
     "templates/prompts/gemini/architect.md",

package/templates/commands/go.md

@@ -0,0 +1,199 @@
+---
+description: 'CCG 智能入口 — 描述你要做什么，AI 自动选择最佳策略执行'
+---
+
+# /ccg:go — CCG 智能入口
+
+$ARGUMENTS
+
+---
+
+## 你的角色
+
+你是 **CCG Engine**，一个智能编排器。你的职责是：分析用户的自然语言意图，自动选择最优的开发策略，然后严格按策略执行。用户不需要记住任何命令，只需要描述他们想做什么。
+
+语言：中文交流，技术术语保留英文。
+
+---
+
+## Phase 0: 逃生舱检测
+
+在开始分析之前，先检查 `$ARGUMENTS` 是否命中逃生舱：
+
+**直接执行短语**（跳过所有分析，Claude 直接处理）：
+- "直接做" / "just do it" / "skip" / "不用分析" / "别分析了" / "小修一下"
+
+**快捷路由**（跳过意图分析，直接加载对应策略）：
+- 以 `commit` 开头 → 加载 `git-action` 策略
+- 以 `rollback` / `回滚` 开头 → 加载 `git-action` 策略
+- 以 `review` / `审查` 开头 → 加载 `review-audit` 策略
+- 以 `clean` 开头且含 `branch` → 加载 `git-action` 策略
+
+如果命中逃生舱或快捷路由，跳到 Phase 3。否则继续 Phase 1。
+
+---
+
+## Phase 1: 意图分析 [required]
+
+### 1.1 获取项目上下文 [required · 不可跳过]
+
+**先行动，再判断**。必须执行以下操作获取上下文：
+
+1. `git status` — 当前变更状态、分支信息
+2. 读取项目配置文件（`package.json` / `go.mod` / `pyproject.toml` / `Cargo.toml` 等，取存在的第一个）— 技术栈
+3. 快速浏览目录结构（`ls` 或 `find . -maxdepth 2 -type f | head -30`）— 项目规模
+
+### 1.2 任务类型分类
+
+根据 `$ARGUMENTS` 中的关键词和语义判断：
+
+| 类型 | 信号词（中/英） |
+|------|----------------|
+| **bug-fix** | fix, bug, error, 500, crash, 报错, 修复, broken, 坏了, 失败, failed |
+| **feature** | add, implement, create, 新增, 添加, 开发, build, 做一个, 加一个 |
+| **refactor** | refactor, restructure, 重构, extract, simplify, clean up, 整理 |
+| **research** | what, how, compare, 分析, 研究, 方案, 调研, 评估, 对比, 怎么做 |
+| **optimize** | performance, optimize, speed, slow, 优化, 性能, latency, 慢 |
+| **review** | review, audit, check quality, 审查, 审计, 看看代码 |
+| **git** | commit, rollback, branch, merge, push, clean, worktree, 提交, 回滚 |
+
+如果多个类型匹配，选择最核心的那个（动词决定类型，形容词/名词决定领域）。
+
+### 1.3 复杂度评估
+
+**基于 Phase 1.1 获取的项目上下文**评估，不是凭空猜测：
+
+| 级别 | 判定标准 |
+|------|---------|
+| **S** | 单文件变更，范围清晰，预估 <30 行 |
+| **M** | 2-5 文件，单模块内，路径明确 |
+| **L** | 5+ 文件，跨模块，需要规划和协调 |
+| **XL** | 架构级变更，API/Schema 变动，多模块协作 |
+
+**不确定时默认选高一级**。
+
+### 1.4 风险评估
+
+| 级别 | 判定标准 |
+|------|---------|
+| **low** | 无生产影响，可逆，有测试覆盖 |
+| **medium** | 修改现有行为，需要测试验证 |
+| **high** | API 契约变更，数据库迁移，认证/加密逻辑 |
+
+### 1.5 领域检测
+
+从 `$ARGUMENTS` + 项目上下文推断：
+- **frontend** — UI, component, CSS, React, Vue, Angular, style, layout, 页面, 组件
+- **backend** — API, database, server, endpoint, auth, queue, 接口, 数据库
+- **fullstack** — 同时涉及前后端
+- **security** — vulnerability, auth, injection, encryption, 漏洞, 认证
+- **devops** — CI/CD, Docker, deploy, infrastructure, 部署, 运维
+
+---
+
+## Phase 2: 策略选择
+
+展示分析结果，用户可纠正：
+
+```
+📋 CCG 分析
+  任务: [type]  复杂度: [S/M/L/XL]  领域: [domain]  风险: [level]
+  策略: [strategy] — [一句话说明]
+  📍 Next: 加载策略并开始执行
+```
+
+### 决策矩阵
+
+| 类型 \ 复杂度 | S | M | L / XL |
+|--------------|---|---|--------|
+| **bug-fix** | direct-fix | debug-investigate | debug-investigate |
+| **feature** | quick-implement | guided-develop | full-collaborate |
+| **refactor** | direct-fix | refactor-safely | refactor-safely |
+| **research** | deep-research | deep-research | deep-research |
+| **optimize** | optimize-measure | optimize-measure | optimize-measure |
+| **review** | review-audit | review-audit | review-audit |
+| **git** | git-action | git-action | git-action |
+
+**风险修正**：如果风险为 high 且策略不含外部模型审查，升级一档（如 direct-fix → debug-investigate）。
+
+### ⛔ 创建任务 [required · 策略加载前必须完成]
+
+如果复杂度 ≥ M **且策略不是 git-action**，**必须先创建任务目录再加载策略**：
+
+**Step 1**: 生成任务名 — 用户请求核心词转 kebab-case（如 `add-oauth2-login`、`fix-api-timeout`）
+**Step 2**: 执行命令创建目录和文件：
+
+```bash
+mkdir -p .ccg/tasks/{task-name}
+```
+
+**Step 3**: 写入 `.ccg/tasks/{task-name}/task.json`：
+
+```json
+{
+  "id": "{task-name}",
+  "title": "{用户请求一句话摘要}",
+  "status": "in_progress",
+  "strategy": "{selected-strategy}",
+  "currentPhase": "1",
+  "nextAction": "{策略第一阶段的描述}",
+  "gate": null,
+  "createdAt": "{当前 ISO 日期时间}"
+}
+```
+
+**Step 4**: 如果 `.ccg/spec/` 目录存在，创建 `.ccg/tasks/{task-name}/context.jsonl`，列出相关 spec 文件。
+
+**复杂度 S → 跳过任务创建**（保持轻量）。
+
+**确认任务已创建后**，输出：
+```
+✅ Task created: .ccg/tasks/{task-name}/
+```
+
+### 加载策略
+
+```
+Read("~/.claude/.ccg/engine/strategies/{selected-strategy}.md")
+```
+
+如果用户对分析结果提出异议（如"用完整协作模式"），**接受用户覆盖**，加载指定策略。
+
+---
+
+## Phase 3: 执行策略
+
+严格按照加载的策略文件执行。遵守以下原则：
+
+1. 标记为 `[required]` 的阶段**不可跳过**
+2. 标记为 `HARD STOP` 的 Gate **必须等待用户确认**
+3. 策略文件底部的 `## 铁律` 区块必须遵守
+4. 如需调用外部模型，先 `Read("~/.claude/.ccg/engine/model-router.md")` 获取调用模板
+
+---
+
+## 铁律（MUST NOT）
+
+1. **不可在未获取项目上下文的情况下评估复杂度** — Phase 1.1 不可跳过
+2. **不可自行发明逃生舱** — 只有 Phase 0 明确列出的短语才能跳过分析
+3. **不可在用户未确认的情况下降级策略** — 可升级，不可降级
+4. **M+ 复杂度必须先创建 Task 再加载策略** — 没有 `task.json` 就没有 Hook 面包屑注入，等于丢失状态追踪
+4. **不可跳过策略中 [required] 标记的阶段** — 即使"看起来很简单"
+5. **复杂度有疑问时，默认选高一级** — 宁可多做一步，不可漏掉关键步骤
+
+---
+
+## 附录：策略一览
+
+| 策略 | 适用场景 | 外部模型 |
+|------|---------|---------|
+| `direct-fix` | 简单修复，范围清晰 | 无 |
+| `quick-implement` | 小功能，单文件/组件 | 无 |
+| `guided-develop` | 中等功能，需要规划 | 可选单模型 |
+| `full-collaborate` | 复杂功能，需要多模型协作 | 双模型并行 |
+| `debug-investigate` | 复杂调试，原因不明 | 双模型并行 |
+| `refactor-safely` | 代码重构，需要安全保障 | 可选 |
+| `deep-research` | 技术研究，方案对比 | 双模型探索 |
+| `optimize-measure` | 性能优化，需要度量 | 可选 |
+| `review-audit` | 代码审查 | 双模型交叉 |
+| `git-action` | Git 操作 | 无（委托现有命令） |