do 工作流概述

do 工作流是 PinableAgents 平台中最核心、最常用的工作流，专为功能交付场景设计。它将一个完整的开发任务拆解为七个有序阶段：澄清（Clarify）、探索（Explore）、规划（Plan）、实现（Implement）、测试（Test）、审查（Review）、总结（Summary）。每个阶段由特定的智能体负责，各阶段之间通过严格的质量门禁（Quality Gate）连接，确保只有满足标准的产出才能进入下一阶段。

do 工作流通过 /do slash 命令在 Claude Code 中启动。所有工作流本质上是 Claude Code 的技能模块，通过 slash 命令交互式引导执行。

启动方式

方式一：Claude Code slash 命令（推荐）

# 进入项目目录
cd ~/my-project

# 启动 Claude Code
claude

# 在交互式界面输入：
/do 为项目添加 JWT 认证功能

方式二：pinable 编排层

pinable --backend claude "为项目添加 JWT 认证功能"

pinable 作为编排层，协调多后端切换和会话管理，但最终调用的是原生 Claude Code / Codex 等 CLI。

七阶段详解

第一阶段：Clarify（澄清需求）

职责：将自然语言需求转化为结构化规格。

产出：功能点列表、验收标准、边界条件

[/do] Clarify — 分析需求中...
✓ 识别出 3 个功能点
✓ 澄清 2 个模糊点
✓ 验收标准已确认

第二阶段：Explore（探索代码库）

职责：深度扫描项目结构，理解相关代码区域。

产出：代码地图、涉及文件、依赖关系图

第三阶段：Plan（制定方案）

职责：基于需求和代码分析，制定详细实现方案。

产出：文件变更列表、API 设计、步骤规划

## 实现方案：JWT 认证
### 文件变更清单
1. [新建] src/middleware/auth.go
2. [新建] src/handlers/auth.go
3. [修改] src/routes/api.go
### API 设计
POST /api/v1/auth/register
POST /api/v1/auth/login

第四阶段：Implement（编码实现）

职责：按照方案编写代码，在 Git worktree 隔离环境中执行。

产出：代码变更（在独立的 worktree 分支中）

// src/middleware/auth.go - JWT 中间件示例
func AuthMiddleware(secretKey string) gin.HandlerFunc {
    return func(c *gin.Context) {
        token := extractBearerToken(c.GetHeader("Authorization"))
        if token == "" {
            c.AbortWithStatusJSON(401, gin.H{"error": "missing token"})
            return
        }
        claims, err := validateJWT(token, secretKey)
        if err != nil {
            c.AbortWithStatusJSON(401, gin.H{"error": "invalid token"})
            return
        }
        c.Set("userID", claims.UserID)
        c.Next()
    }
}

第五阶段：Test（自动化测试）

职责：生成需求驱动的测试用例。

产出：测试用例 + 覆盖率报告

第六阶段：Review（代码审查）

职责：五维评估框架全面审查。

维度	审查重点	通过标准
可维护性	代码结构、命名规范	15 分钟内理解模块
性能	算法复杂度、查询效率	无 N+1 风险
安全性	输入验证、SQL 注入	通过 OWASP Top 10
风格	与项目现有风格一致	无风格偏离
兼容性	API 契约、schema 变更	不破坏现有功能

第七阶段：Summary（交付总结）

职责：生成完整交付报告。

产出：变更文件 diff、测试覆盖率、后续建议

实战演练：用户认证功能

启动工作流

# 在 Claude Code 中
claude
> /do 为现有的 Go Gin API 项目添加 JWT 认证功能

Claude Code 自动完成 Clarify → Explore → Plan → Implement → Test → Review → Summary 全流程。

完成后操作

# 查看 worktree 列表
git worktree list

# 合并变更到主分支
git merge pinable/do-latest

何时选择 do 工作流

场景	推荐
需求明确的功能开发	✅ do
Bug 调查和根因分析	omo
企业级大型项目	bmad
快速原型验证	sparv
需求文档已完备	requirements

命令参考

Claude Code slash 命令

# 基本用法
/do 任务描述

# 指定工作目录
/do 任务描述 --workdir ./my-project

# 跳过特定阶段（需要已有产出）
/do 任务描述 --skip clarify,explore

pinable 编排层

# 通过 pinable 调用（编排层会自动选择后端）
pinable --backend claude "任务描述"

# 强制使用特定后端
pinable --backend codex "任务描述"

原生 CLI 直接调用

# Claude Code 快速任务
claude "解释 src/auth/login.go 的逻辑"

# Codex HEREDOC 批量任务
codex - <<'EOF'
为 src/auth/login.go 添加单元测试
EOF