Agent+Skills 全栈开发流水线

这是什么？适合谁？

这是一个使用 Claude Code Skills 生态构建的端到端开发流水线工作流。要解决的核心问题是：AI 编码工具从”单点辅助”进化到”流程编排”后，开发者需要一个标准化的方式把需求分析、TDD 编码、代码审查、Git 提交、部署验证五个阶段串成一条可复用的自动化流水线。通过 Claude Code 的 Skills 机制（每个 Skill 封装一套方法论 + 具体指令）+ MCP 工具集成（外部工具调用），实现”需求→编码→审查→提交→部署”全流程 Agent 驱动。核心价值在于：每个阶段都有明确的输入输出契约和 Skill 约束，Agent 不是在”自由发挥”而是在”按流程执行”。适合使用 Claude Code 的个人全栈开发者、小型团队标准化开发流程、开源项目自动化维护。前提是你已经熟悉 Claude Code 基本操作并安装了相关 Skills——本工作流是”编排层”，不是”入门教程”。

准备工作

1. Claude Code 账号（Anthropic Pro $20/月 或 Max $100/月，Max 版支持更长上下文和更高频率的工具调用）
2. 安装核心 Skills：brainstorming（需求分析）、test-driven-development（TDD 编码）、code-reviewer（代码审查）、git-commit-writer（规范化提交）、deploy-checklist（部署验证）
3. 可选安装运维 Skills：env-checker、migration-runner、rollback-handler、monitor-setup
4. Cursor 账号（$20/月，作为辅助编码工具，SWE-Bench 成绩领先）
5. OpenCode（开源免费，GitHub ★182K，作为 Claude Code 的开源备选方案）
6. MCP 工具配置：至少配置 GitHub MCP（自动创建 PR）和文件系统 MCP（代码读写）
7. 时间预算：总计 1-2 小时（需求分析 15-20 分钟 + TDD 编码 30-50 分钟 + 代码审查 10-15 分钟 + 提交 5 分钟 + 部署验证 10-15 分钟）
8. 前置知识：了解 TDD 的 RED-GREEN-REFACTOR 循环、Conventional Commits 规范、基本部署概念（环境变量/迁移/回滚）

流水线架构

需求分析 → 编码实现 → 代码审查 → Git提交 → 部署验证
↓          ↓          ↓         ↓         ↓
brain-    TDD Skill  code-    git-commit  deploy-
storming             reviewer  -writer    checklist

5 步核心流程

第 1 步：需求分析（brainstorming Skill）

工具：Claude Code

在 Claude Code 中激活 brainstorming Skill，输入你的功能需求描述。Agent 会自动枚举功能需求与边界条件、提出替代方案、生成结构化任务列表。关键是先让 Agent 把”可能出错的边界条件”全部列出来，再确认实施计划——而不是直接开始写代码。

Prompt 示例：

我要实现 [功能描述]。请用 brainstorming Skill：
1. 枚举所有功能需求和边界条件
2. 提出至少 2 个替代方案并对比优劣
3. 生成结构化任务列表（含优先级）
4. 标注哪些边界条件需要测试覆盖

预期产出：一份结构化需求文档 + 分步实施计划 + 边界条件清单。每个任务有明确的优先级标记（P0/P1/P2），边界条件清单将直接输入第 2 步的 TDD 测试设计。

第 2 步：TDD 编码实现

工具：Claude Code + Cursor

严格遵循 RED-GREEN-REFACTOR 循环。激活 test-driven-development Skill，Agent 会根据第 1 步的边界条件清单先写失败测试（RED），然后用最少代码通过测试（GREEN），最后重构优化（REFACTOR）。TDD Skill 强制执行测试先行——如果你试图跳过 RED 阶段直接写实现，Skill 会拒绝并提示先写测试。

Prompt 示例：

基于第 1 步的需求文档和边界条件清单，用 TDD Skill 实现：
1. RED: 先为每个边界条件写失败测试
2. GREEN: 用最少代码让所有测试通过
3. REFACTOR: 优化代码结构，确保测试仍通过
每完成一个循环暂停，等我确认后再进入下一个

预期产出：通过全部测试的功能代码 + 完整的测试套件。测试覆盖率应覆盖第 1 步列出的所有边界条件。Cursor 可作为辅助工具在编码过程中提供实时补全和快速重构建议。

第 3 步：代码审查（code-reviewer Skill）

工具：Claude Code

激活 code-reviewer Skill，Agent 会对第 2 步的代码做多维度审查：安全漏洞（SQL 注入/XSS）、逻辑错误、性能问题、代码风格。按 Critical > Warning > Suggestion 三级分类输出审查结果。

Prompt 示例：

用 code-reviewer Skill 审查刚才的代码，按以下维度：
- 安全：SQL注入、XSS、敏感信息泄露
- 逻辑：边界条件、空值处理、并发安全
- 性能：N+1查询、不必要的循环、内存泄漏
- 风格：命名规范、注释完整度、代码复杂度
输出格式：按 Critical > Warning > Suggestion 排序，每条附具体代码位置和修复建议

预期产出：分级审查报告，Critical 级别问题必须在本步修复，Warning 和 Suggestion 可记录为 TODO。如果集成 GitHub MCP，审查意见可自动创建为 PR comment。

第 4 步：规范化提交（git-commit-writer Skill）

工具：Claude Code

激活 git-commit-writer Skill，Agent 分析 git diff → 生成 Conventional Commits 格式的提交信息，自动检测 scope，标记 breaking changes。

Prompt 示例：

用 git-commit-writer Skill 生成提交信息：
1. 分析当前 git diff
2. 生成 Conventional Commits 格式（type(scope): subject）
3. 如果有 breaking change，加 ! 标记并在 body 中说明
4. body 中列出本次变更的关键点

预期产出：符合 Conventional Commits 规范的提交信息，可直接 git commit 使用。如果配置了 GitHub MCP，Agent 可自动执行 commit + push + 创建 PR。

第 5 步：部署验证（deploy-checklist Skill）

工具：Claude Code

激活 deploy-checklist Skill，Agent 检查环境变量完整性、数据库迁移状态、回滚方案、监控配置、健康检查端点。

Prompt 示例：

用 deploy-checklist Skill 做部署前检查：
1. 环境变量：列出所有必需变量，逐一确认已设置
2. 数据库迁移：检查待执行迁移，确认无破坏性变更
3. 回滚方案：确认回滚步骤已文档化，回滚脚本可用
4. 监控配置：确认关键指标已接入监控，告警规则已设置
5. 健康检查：确认 /health 端点返回 200

预期产出：部署检查清单（全绿/有警告/有阻断项），每个检查项附具体状态和说明。只有所有 Critical 项通过才能执行部署。

各阶段详解

第一步：需求分析（brainstorming Skill）

Agent 自动枚举功能需求与边界条件、提出替代方案、生成结构化任务列表。产出结构化需求文档+分步实施计划。

第二步：TDD 编码实现

严格遵循 RED-GREEN-REFACTOR 循环：先写失败测试 → 最少代码通过 → 重构优化。TDD Skill 强制执行测试先行。

第三步：代码审查（code-reviewer Skill）

多维度审查：安全漏洞(SQL注入/XSS)、逻辑错误、性能问题、代码风格。按 Critical/Warning/Suggestion 三级分类。

第四步：规范化提交（git-commit-writer Skill）

分析 git diff → 生成 Conventional Commits 格式，自动检测 scope，标记 breaking changes。

第五步：部署验证（deploy-checklist Skill）

检查环境变量完整性、数据库迁移状态、回滚方案、监控配置、健康检查端点。

扩展：集成 MCP 工具

Skills（知识） + MCP（工具） = 完整自动化。例如 code-reviewer + GitHub MCP → 自动创建 PR 并标记审查意见。

适用场景

• 个人全栈项目快速迭代
• 小型团队标准化开发流程
• 开源项目自动化维护

常见踩坑

1. 跳过 RED 阶段直接写实现——TDD Skill 的最大价值在于”先写失败测试”强制你思考边界条件。如果你跳过 RED 直接让 Agent 写实现，等于把 TDD 退化成”先写代码后补测试”，失去了测试驱动的设计价值。解决：严格按 Skill 流程执行，每完成一个 RED-GREEN-REFACTOR 循环暂停确认。

2. brainstorming Skill 枚举的边界条件不全——Agent 基于你的需求描述推断边界条件，如果描述太模糊（如”做个登录功能”），枚举出的边界条件会遗漏关键场景（如密码重置、账号锁定、并发登录）。解决：需求描述尽量具体，手动补充 Agent 遗漏的边界条件后再进入 TDD。

3. code-reviewer Skill 的审查结果被忽略——Agent 输出 Critical 级别问题后，开发者觉得”改起来太麻烦”直接跳过进入提交。这等于让代码审查流于形式。解决：Critical 级别必须在本步修复，Warning 至少记录为 TODO，不允许直接跳过。

4. deploy-checklist Skill 检查环境变量时遗漏了生产环境——Skill 默认检查当前环境变量文件（如 .env），但生产环境的变量可能和开发环境不同。直接用开发环境的检查结果部署到生产，会因缺少生产环境变量导致服务启动失败。解决：在 Skill 配置中指定生产环境变量文件路径，或手动确认生产环境变量清单。

5. git-commit-writer Skill 生成的 commit message scope 不准确——Agent 根据 git diff 推断 scope，但如果一次提交涉及多个模块，scope 可能只标注了第一个模块。解决：多模块变更时手动拆分为多个 commit，每个 commit 只涉及一个 scope。

6. MCP 工具配置错误导致 Skill 调用失败——Skills 依赖 MCP 工具完成外部操作（如创建 PR、读写文件），MCP 配置错误（如 token 过期、路径错误）会导致 Skill 在执行中途失败，且错误信息不直观。解决：每次使用前用简单命令测试 MCP 连通性，配置错误时先修复 MCP 再运行流水线。

7. 流水线绑定 Claude Code 平台导致迁移困难——整个流水线的 Skill 机制是 Claude Code 特有的，迁移到其他 AI 编码工具（如 Cursor、Aider）需要重写所有 Skill。解决：将 Skill 中的核心逻辑文档化，迁移时作为 prompt 模板移植到新平台。

FAQ

Q1: 没有 Claude Code Pro 怎么办？

Claude Code 的 Skills 机制需要 Pro 及以上版本。如果不想付费，替代方案：用 OpenCode（开源免费）+ 自定义 prompt 模板模拟 Skill 行为，但缺少 Skill 的强制约束机制（如 TDD Skill 会拒绝跳过 RED 阶段）。另一个选择是用 Cursor 的 Rules 功能定义类似流程，但 Rules 是”建议性”的，不像 Skill 有强制流程控制。

Q2: 必须按 5 步顺序执行吗？能跳过某些步骤吗？

5 步是推荐顺序，但不是强制的。如果项目已有测试套件，可以跳过第 2 步的 RED 阶段直接进入 GREEN-REFACTOR。如果变更很小（如改文案），可以跳过第 1 步 brainstorming 直接编码。但第 3 步代码审查和第 5 步部署验证不建议跳过——这两步是质量底线。

Q3: TDD Skill 和手动写测试有什么区别？

TDD Skill 的核心区别是”强制流程控制”——它会拒绝在 RED 阶段写实现代码，拒绝在测试未通过时进入 REFACTOR。手动写测试时开发者往往会”先写代码后补测试”，失去了 TDD 的设计价值。Skill 还会自动检查测试覆盖率是否覆盖了 brainstorming 阶段列出的所有边界条件，手动写测试容易遗漏。

Q4: 如何把这个流水线集成到 CI/CD 中？

两种方式：①用 Claude Code 的 CLI 模式在 CI pipeline 中调用 Skills（如 claude-code --skill deploy-checklist），实现自动化部署验证；②用 GitHub Actions + Claude Code API 把流水线触发条件绑定到 PR 创建事件，实现”PR 创建→自动审查→自动部署验证”。注意 CI/CD 中调用 Skill 时需要配置 API key 和超时策略，避免长时间运行导致 pipeline 超时。

Q5: 能用其他 AI 编码工具替代 Claude Code 吗？

可以部分替代但不能完全替代。Cursor 可以替代第 2 步的编码环节（SWE-Bench 成绩领先），但不支持 Skills 机制。OpenCode 可以作为开源替代方案，且支持自定义 prompt 模板。Aider 支持 Git 集成但没有 Skill 生态系统。完整流水线（5 步全覆盖）目前只有 Claude Code 的 Skills 机制能实现端到端编排。

参考资料

• Claude Code TDD 工作流：AI 辅助测试驱动开发指南 —— Claude Code 中实现 Red-Green-Refactor TDD 循环的完整实战教程。
• 开发者指南：掌握 Claude Code 的 Skills、Hooks 与 Tools —— Claude Code 三大扩展机制（Skills/Hooks/MCP Tools）的深度解析。
• Fullstack Dev Skills —— Claude Code 全栈开发插件 —— 将 Claude Code 转变为全栈开发助手的 19 个专业技能集合。
• Agent Skills Marketplace (SkillsMP) —— 兼容 Claude Code 的 170 万+ Agent Skills 开放市场。