Cluade Code的workflow

claude code
杂记
发布日期:   2026-03-18
字数:   1.9k
阅读时间:   6 分钟

Cluade Code的workflow

workflow就是ai深度嵌入研发流程中的的一套人机合作的流程,用于是一种研发流程级别的框架;

Cluade Code的workflow目前主流的有OpenSpec、Superpowers、GSD(get-shit-done)、oh-my-claudecode、everything-claude-code,
这五个工具都是基于规范驱动开发 (Spec-Driven Development)的理念出发,对Cli进行增强的工具;
下面依次对这些工具进行使用的一个笔记;

Superpowers

适用于追求极致代码质量、需要大规模重构的场景,缺点:极其消耗Token,且有时流程过于死板,小任务不适合

执行命令

  1. /superpowers:brainstorm - 启动结构化头脑风暴会话进行问题探索
    superpowers:brainstorm
    通过对话引导式的方式澄清需求

  2. /superpowers:write-plan - 生成包含任务分解的详细实现计划
    superpowers:write-plan
    通过需求生成执行计划,默认执行计划是在~/.claude/plans下,记得挪到项目中

  3. /superpowers:execute-plan - 执行带质量检查的系统化实现
    superpowers:execute-plan-result

superpowers:execute-plan-result
按计划进行执行,并且每次执行完成计划后都会验证代码

常用命令

  1. brainstorming
    在编写代码之前启动。通过提问完善初步想法，探索各种方案，分段展示设计以供验证。保存设计文档。

  2. using-git-worktrees
    设计方案获批后激活。在新分支上创建隔离工作区，运行项目设置，验证测试基线是否干净。

  3. writing-plans
    根据已批准的设计方案启动。将工作分解成易于处理的小任务（每个任务耗时 2-5 分钟）。每个任务都包含精确的文件路径、完整的代码和验证步骤。

  4. subagent-driven-development or executing-plans
    根据计划激活。为每个任务派遣新的子代理，并进行两阶段审查（先检查规范符合性，再检查代码质量），或者分批执行，并设置人工检查点。

  5. test-driven-development
    在实现阶段激活。强制执行红绿重构流程：编写失败的测试，观察其失败，编写最小代码，观察其通过，然后提交。删除测试之前编写的代码。

  6. requesting-code-review
    在任务间隙激活。根据计划进行审查，并按严重程度报告问题。严重问题会阻碍进度。

  7. finishing-a-development-branch
    当任务完成后激活。验证测试，提供选项（合并/PR/保留/丢弃），清理工作树。

经验

使用过程中brainstorm、debugging比较好用,其他的命令有时候会过于死板,不适合小任务,而且消耗Token较多,需要根据实际情况选择使用;

GSD(get-shit-done)

GSD主要是想要解决context容量被填满的问题,context填满后会带来模型幻觉问题;

常用命令

  1. /gsd:map-codebase 理解现有代码库

gsd:map-codebase

gsd:map-codebase-result

gsd:map-codebase-result_1

  1. /gsd:new-project 初始化项目/需求
一个命令，一条完整流程。系统会：
提问：一直问到它彻底理解你的想法（目标、约束、技术偏好、边界情况）
研究：并行拉起代理调研领域知识（可选，但强烈建议）
需求梳理：提取哪些属于 v1、v2，哪些不在范围内
路线图：创建与需求映射的阶段规划
你审核并批准路线图后，就可以开始构建

gsd:new-project

  1. /gsd:discuss-phase 讨论阶段

gsd:discuss-phase


系统会分析该阶段，并根据要构建的内容识别灰区：

视觉功能：布局、信息密度、交互、空状态
API / CLI：返回格式、flags、错误处理、详细程度
内容系统：结构、语气、深度、流转方式
组织型任务：分组标准、命名、去重、例外情况
对每个你选择的区域，系统都会持续追问，直到你满意为止。最终产物 CONTEXT.md 会直接喂给后续两个步骤：

研究代理会读取它：知道该研究哪些模式（例如“用户想要卡片布局” → 去研究卡片组件库）
规划代理会读取它：知道哪些决策已经锁定（例如“已决定使用无限滚动” → 计划里就会包含滚动处理）

gsd-discuss-phase_result

规划阶段完成后得到01-CONTEXT.md文件

  1. /gsd:plan-phase 规划阶段
    根据discuss讨论出的规划方案,分解成具体的任务,然后检查任务和需求是否一致;
    gsd:plan-phase

  2. /gsd:execute-phase 执行阶段
    根据plan计划阶段的任务列表进行执行
    gsd:execute-phase

  3. /gsd:verify-work 验证阶段
    验证阶段自动执行不需要手动触发

gsd:verify-phase

执行过程

执行过程就是不断的重复gsd:discuss-phase -> gsd:plan-phase -> gsd:execute-phase -> gsd:execute-phase

quick 快速模型

对于小需求,实际上是不需要用到完整的GSD workflow,因此可以GSD也提供了/gsd:quick来完成

适用于不需要完整规划的临时任务。

快速模式保留 GSD 的核心保障（原子提交、状态跟踪），但路径更短：

相同的代理体系：同样是 planner + executor，质量不降
跳过可选步骤：默认不启用 research、plan checker、verifier
独立跟踪：数据存放在 .planning/quick/，不和 phase 混在一起
--discuss 参数： 在规划前先进行轻量讨论，理清灰区。

--research 参数： 在规划前拉起研究代理。调查实现方式、库选型和潜在坑点。适合你不确定怎么下手的场景。

--full 参数： 启用计划检查（最多 2 轮迭代）和执行后验证。

参数可组合使用：--discuss --research --full 可同时获得讨论 + 研究 + 计划检查 + 验证。

小结

和superpower一样太重了,步骤和文档太多,适合团队项目,但是用起来总有一种过渡阶段的过度&过渡工具的感觉

OpenSpec

OpenSpec的设计理念

fluid not rigid → iterative not waterfall → easy not complex → built for brownfield not just greenfield → scalable from personal projects to enterprises

  • opsx-explore
    仔细思考想法，调查问题，明确需求
    opsx-explore

  • opsx-propose
    一步完成变更创建和规划工件生成（默认快速路径）
    opsx-propose

  • opsx-apply
    执行任务，并根据需要更新工件
    opsx-apply

  • opsx-archive
    完成后归档
    opsx-archive

开启opsx扩展命令

# 开启配置
openspec config profile
# 更新配置
openspec update

everything-claude-code

太复杂了,不想用

agent teams

使用teams对于小需求并不能提高效率,反而由于来回交流导致效率下降
agent teams适用于大型项目,明确分工的需求

推荐

默认小需求修复Bug直接使用Claude Code的Plan mode即可,新项目&团队协助使用OpenSpec,目前使用感受来看SDD的实际是想要解决上下文管理问题带来的幻觉和指挥模型做什么的问题,因此中间过程中生成的数据或者文档,并不适合人来进行审查,太多了,但是如果不审查,到了后续阶段在来修正的代价有比较大,因此比较好的工作流是需要审核的文档不需要太多并且能管理上下文的workflow是更好的选择;
目前还有一些workflow,例如Spec Kit以及国产的Trellis等,后续在进行研究

参考资料

项目地址

https://github.com/gsd-build/get-shit-done
https://github.com/obra/superpowers
https://github.com/affaan-m/everything-claude-code
https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main

项目文档

https://github.com/Fission-AI/OpenSpec/blob/main/docs/commands.md
https://docs.trytrellis.app/zh

参考资料

GSD工作原理
trytrellis

claude code
  TOC