CCG 快速实现策略:Quick Implement 的 S 级小功能四阶段工作流

原创2026-10-09 17:57:271,853 阅读
文章标签:人工智能AI 应用多智能体Agent 编排Agent 工作流代码智能体CLI开发工具AI 技能dsh-plugin

CCG 快速实现策略:Quick Implement 的 S 级小功能四阶段工作流

在 ccg-workflow 多模型协作开发系统中,并非所有任务都需要启动双模型并行分析——对于单文件、<30 行变更的小功能,quick-implement 策略提供了一条由 Claude 独立完成、不调用外部模型的轻量路径。本文基于 templates/engine/strategies/quick-implement.md 展开,结合引擎层的策略路由、阶段指导与 Hook 实现,完整讲解该策略的适用判定、四阶段状态机、质量验证与升级规则,读完即可在项目中按此策略执行高性价比的小功能开发。

一、策略定位:什么任务该走 Quick Implement

quick-implement 是 CCG Engine 十种开发策略中最轻量的一档,其设计目标是:范围清晰的小功能,由 Claude 独立完成,不调用外部模型。判断依据来自三个条件:

判定维度 要求 说明
复杂度 S 单文件/单组件,预估变更 <30 行
需求 明确 无需架构决策,无需多轮澄清
风险 low 无生产影响、可逆、有测试覆盖

在 templates/commands/go.md 的策略决策矩阵中,quick-implement 只出现在「feature(功能开发)× 复杂度 S」的交汇处——也就是说,它专为「新增一个小功能」这类任务设计。若任务是 bug 修复且复杂度为 S,则走 direct-fix;若复杂度升到 M(2-5 文件、单模块),则升级到 guided-develop。

复杂度评估不是凭空猜测,go.md 要求先执行 git status、读取项目配置文件(package.json / go.mod / pyproject.toml 等)、浏览目录结构获取真实上下文后再判定,并且不确定时默认选高一级。同样地,S 级任务在 templates/commands/go.md 中会被跳过任务创建(不写 .ccg/tasks/{task-name}/task.json),保持整个流程的轻量性——这是与 M 及以上复杂度「必须先创建 Task 再加载策略」规则的关键差异。

二、工作流状态机:四个 phase-state 阶段

quick-implement 在文档中用四个 <a href="https://link.gitcode.com/i/3acf5cf8cef5be62550b322be62376f3" target="_blank">phase-state:N] 块声明了完整的状态机。这种标记是该策略与引擎其他策略共享的阶段自检机制(定义见 [templates/engine/phase-guide.md §1):每完成一个阶段,Claude 回顾对应块,确认 Gate 条件满足,输出 📍 Next: [具体动作] 告知用户下一步。

[phase-state:1-context]   当前阶段:上下文收集
                          📍 Next: 了解现有代码模式后进入计划阶段

[phase-state:2-plan]      当前阶段:简要计划
                          Gate: 上下文已收集 ✓
                          📍 Next: 用户确认计划后进入实施阶段

[phase-state:3-implement] 当前阶段:实施
                          Gate: 用户已确认计划 ✓
                          📍 Next: 实施完成后进入验证阶段

[phase-state:4-verify]    当前阶段:验证
                          Gate: 实施已完成 ✓
                          📍 Next: 验证通过后报告结果

这条状态链路呈现了两个硬性检查点:Phase 1 → Phase 2 的 Gate 是数据 Gate(必须产出了上下文分析结果),Phase 2 → Phase 3 的 Gate 是确认 Gate(HARD STOP)(必须等待用户明确确认计划)。后者在 phase-guide.md §2 中被明确定义为"必须等待用户明确确认才能继续"的硬停止点,Gate 失败时必须说明缺失内容并给出补救建议,不可绕过。

状态机的运行并非只停留在文档层面:安装后 templates/hooks/workflow-state.js 会在每一轮用户消息时读取 .ccg/tasks/{task-name}/task.json,将 Strategy、Phase、Gate、Next 注入为 <ccg-state> 面包屑,并用最近 10 轮滚动缓冲检测「连续 3 轮 phase + nextAction 完全相同」的死循环——一旦触发会注入 ⚠️ LOOP DETECTED 警告并提示执行 Break-Loop Protocol(根因分析 → 更新 nextAction → 连续 2 次触发则强制暂停请用户介入)。

三、Phase 1:上下文收集 [required]

作为 [required] 标记阶段,上下文收集不可跳过,执行两步:

  1. 搜索相关代码:用 MCP 搜索工具或 Grep 搜索与需求相关的现有代码。MCP 搜索工具的实际名称由安装时的模板变量 {{MCP_SEARCH_TOOL}} 决定(见 templates/CLAUDE.md 的模板变量系统),可配置为 mcp__ace-tool__search_context、mcp__contextweaver__codebase-retrieval、mcp__fast-context__fast_context_search,或降级为 Glob + Grep。
  2. 读取目标文件,理解三点:
    • 现有代码模式和规范(命名约定、文件组织方式)
    • 相关的类型定义/接口(避免重复定义、确保类型兼容)
    • 已有的类似实现(识别可复用的模式)

这一阶段的目标是让后续的修改"长在"项目现有结构之上,而非另起炉灶。

四、Phase 2:简要计划 [required] + HARD STOP

输出 3-5 步实施计划,格式简洁明了:

📝 实施计划
  1. [具体步骤]
  2. [具体步骤]
  3. [具体步骤]
  预计变更: [N] 文件

等待用户确认或调整。此处的 HARD STOP 语义与 guided-develop(templates/engine/strategies/guided-develop.md)的 Phase 4 一脉相承——即使任务"看起来很简单",也必须先列出步骤并取得用户确认,这是 templates/engine/phase-guide.md §3 规定的 Next-Action 格式(每个阶段完成后输出 📍 Next: [一句话描述下一步具体动作])在计划阶段的落地。

五、Phase 3:实施

用户确认计划后进入实施,三条执行约束:

  1. 按计划逐步执行,不跳步、不并行扩大范围
  2. 遵循项目现有的代码规范和命名约定——新代码必须与现有代码风格一致
  3. 不引入新的依赖(除非计划中已说明)——保持变更面最小

这里体现的是"只做用户要求的,不顺手改其他东西"的纪律:任何计划外变更都可能导致后续验证与审查范围失控。

六、Phase 4:验证与质量快检

验证阶段按固定顺序执行:

  1. git diff 展示变更——让用户看到全部改动
  2. 运行相关测试(如果项目有测试)——以测试结果作为行为正确性的证据
  3. 质量快检(变更 >30 行时):/verify-quality 检测代码质量。虽然 S 级任务通常 <30 行,但该规则保留了对临界场景的兜底;verify-quality 技能对应仓库 templates/skills/tools/verify-quality/(scripts/quality_checker.js),负责复杂度、重复、命名检查
  4. 安全扫描(涉及认证/输入处理/加密时):/verify-security,对应 templates/skills/tools/verify-security/(scripts/security_scanner.js)

以上质量关卡不是可选项——templates/rules/ccg-skills.md 全局规则定义了「>30 行变更 → verify-change → verify-quality」的自动触发规则,安装后自动生效于所有 Claude Code 会话。

最后输出结果,格式固定:

✅ 实现完成
  变更: [N] 文件,[M] 行
  新增: [描述]
  📍 Next: 可以用 /ccg:commit 提交

结束语将用户引导至 /ccg:commit 智能提交命令(对应 templates/commands/commit.md),完成从开发到提交的闭环。

七、升级规则:何时放弃轻量路径

quick-implement 明确列出两条升级触发条件,命中即升级到 guided-develop:

  • 涉及 3+ 文件或需要架构决策
  • 涉及认证/数据库等高风险领域

这与 templates/engine/phase-guide.md §4 的策略升级规则一致:执行中发现复杂度超出当前策略能力时,明确告知用户"当前策略为 [名称],但发现 [原因],建议升级到 [目标策略]",等待用户确认后 Read ~/.claude/.ccg/engine/strategies/[target].md,从新策略的 Phase 1 开始(已完成的分析工作可复用)。只能升级,不能降级(除非用户明确要求)。

升级到 guided-develop 后,流程将显著变重:需求增强、上下文检索、强制双模型并行分析(M 复杂度必须调用 frontend + backend 双模型,不可只调一个)、HARD STOP 计划审批、模式 A/B 实施选择(Claude 自己写 vs 外部模型写)、Ralph Loop 迭代审查等(详见 templates/engine/strategies/guided-develop.md)。这一对比恰好反衬出 quick-implement 的价值:在条件满足时用最少的花费完成最明确的产出。

八、铁律:三条不可逾越的底线

策略文件末尾的「铁律」区块是 CCG Engine 对执行者的硬性约束(templates/commands/go.md Phase 3 也要求严格遵守策略文件铁律):

  1. 不可跳过 Phase 2 计划步骤——即使"很简单"也要列出步骤
  2. 不引入未计划的变更——只做用户要求的,不"顺手"改其他东西
  3. 遵循现有规范——新代码必须与现有代码风格一致

这三条分别对应流程完整性、变更范围控制和代码一致性三个维度,与 templates/engine/phase-guide.md §5 错误恢复表中"用户要求中止 → 立即停止,报告已完成的工作""意外文件冲突 → 报告冲突,等待用户决策"等规则共同构成策略执行的纪律体系。

九、在引擎中的位置:一档轻量策略的边界

从 templates/commands/go.md 的策略一览可以看到 quick-implement 在十策略矩阵中的精确边界:

相邻策略 与 quick-implement 的差异
direct-fix 同为 S 级轻量路径,但面向 bug 修复而非新功能
guided-develop 面向 M 复杂度,可选/强制外部模型分析,流程明显加重
full-collaborate 面向 L/XL 复杂度,双模型并行 + 完整多阶段协作

quick-implement 的价值在于策略的正确分层:不是所有任务都需要多模型协作的成本,S 级、低风险、需求明确的小功能用最简流程交付,把双模型交叉验证的资源留给真正复杂的问题。这种「按复杂度匹配流程」的设计贯穿整个引擎——go.md 中的决策矩阵(任务类型 × 复杂度 → 策略)与风险修正规则(风险为 high 且策略不含外部模型审查时升级一档)保证了策略选择的可预测性与安全性。

对于开发者而言,理解 quick-implement 就是理解 CCG 工作流的"最小可用单元":上下文收集保证改动贴合现状,简要计划保证用户知情,HARD STOP 保证流程可控,验证与质量快检保证产出可信,升级规则保证复杂场景自动转移到更重的流程。这条路径完整覆盖了「判断 → 规划 → 实施 → 验证 → 收尾」的工程闭环,是日常小功能迭代中最值得复用的执行范式。

登录后查看全文
ccg-workflow