用一个插件让 Claude Code 自动走完开发全流程 | CC-Best 实战

前言

如果你在用 Claude Code,大概率遇到过这些情况:

  • 让它加个功能,直接就开始写代码了,没有需求分析,没有架构设计
  • 写完了不做测试,不做 Code Review,直接告诉你"完成了"
  • 有时候不小心覆盖了重要文件,或者把 .env 里的密钥提交了
  • 上下文越来越长,AI 开始"忘事"

这些问题的根源不在 AI 的能力,而在于 没有流程约束

今天介绍的 CC-Best 插件,就是给 Claude Code 加上一套完整的软件工程流程。

安装(10 秒)

bash 复制代码
claude plugin add https://github.com/xiaobei930/cc-best

没了。不需要额外配置,不需要改你的 settings.json,不需要手动下载任何东西。

安装完成后,执行 /cc-best:status 确认:

bash 复制代码
/cc-best:status

你应该看到插件的版本信息和组件加载状态。

核心概念:角色工作流

CC-Best 的核心设计是 角色驱动

bash 复制代码
/cc-best:pm        →  产品经理:需求分析、生成 REQ 文档
/cc-best:clarify   →  需求澄清:解决 REQ 中的待澄清项
/cc-best:lead      →  研发经理:架构设计、任务分解
/cc-best:designer  →  设计师:UI/UX 审查
/cc-best:dev       →  开发工程师:编码实现(TDD)
/cc-best:qa        →  测试工程师:代码审查、质量保证
/cc-best:verify    →  安全审计:OWASP Top 10 检查
/cc-best:commit    →  提交代码

每个角色背后有对应的 Agent 和 Skills。你不需要关心这些细节,只需要按角色顺序执行命令。

实战演示:从零实现一个 TODO API

让我们用一个真实的例子走一遍完整流程。

Step 1: 需求分析

bash 复制代码
/cc-best:pm

我需要一个 TODO 待办事项的 RESTful API,支持增删改查,用 TypeScript + Express。

PM Agent 会输出一份结构化的需求文档(REQ),包含:

  • 功能需求清单
  • 技术约束
  • 验收标准
  • 待澄清项(如果有的话)

如果有待澄清项,它会自动建议执行 /cc-best:clarify

Step 2: 架构设计

bash 复制代码
/cc-best:lead

Lead 会调用两个 Agent:

  1. architect --- 生成技术方案,包含目录结构、API 设计、数据模型
  2. planner --- 将方案分解为可执行的任务列表

你会看到类似这样的输出:

diff 复制代码
架构决策:
- 使用 Express + TypeScript
- 内存存储(满足 MVP 要求)
- RESTful 路由设计
- 错误处理中间件
​
任务分解:
□ 初始化项目结构
□ 实现 Todo 数据模型
□ 实现 CRUD 路由
□ 添加错误处理中间件
□ 编写单元测试
□ 集成测试

Step 3: 编码实现

bash 复制代码
/cc-best:dev

这一步调用三个 Agent 协同工作:

  1. tdd-guide --- 先写测试,再写实现(红 → 绿 → 重构)
  2. code-simplifier --- 实现后自动简化代码
  3. code-reviewer --- 实时代码审查

你会注意到一个关键区别:先出现测试文件,再出现实现文件。 这不是巧合,是 TDD 流程的体现。

Step 4: 质量保证

bash 复制代码
/cc-best:qa

QA Agent 会:

  • 运行测试套件
  • 检查测试覆盖率
  • 审查代码质量
  • 验证边界条件
  • 检查错误处理

Step 5: 安全审计

bash 复制代码
/cc-best:verify

security-reviewer Agent 按照 OWASP Top 10 逐项检查:

  • 注入攻击防护
  • 身份认证
  • 敏感数据暴露
  • XSS 防护
  • 安全配置
  • ...

Step 6: 提交

bash 复制代码
/cc-best:commit

自动生成符合 Conventional Commits 规范的 commit message。

一键全流程

如果你觉得逐步执行太麻烦,可以用:

bash 复制代码
/cc-best:iterate

这会自动走完 PM → Lead → Dev → QA → Verify → Commit 的全流程,中间无需干预。

Hook 系统详解

CC-Best 内置 18 个 Hook 脚本,覆盖 8 个生命周期事件。这是我认为最有价值的部分。

1. 密钥泄露防护

check-secrets.js 在每次 Shell 命令执行前扫描,支持 30+ 提供商的密钥模式:

  • AWS Access Key
  • GitHub Token
  • OpenAI API Key
  • Stripe Secret Key
  • 数据库连接字符串
  • ...

被检测到时,命令会被 阻止执行,并提示你处理。

2. 重要文件保护

protect-files.js 保护关键文件不被意外覆盖:

  • package.json / package-lock.json
  • .env / .env.local
  • CI/CD 配置文件
  • 数据库迁移文件

当 AI 试图覆盖这些文件时,Hook 会发出警告。

3. Force Push 拦截

pause-before-push.js 自动检测并阻止:

  • git push --force
  • git push -f
  • 任何对 main/master 分支的 force push

这个 Hook 已经救过我好几次了。

4. 自动格式化

format-file.js 在每次文件写入/编辑后自动运行 Prettier 或项目配置的格式化工具。

5. TypeScript 类型检查

typescript-check.js 在编辑 .ts / .tsx 文件后自动运行 tsc --noEmit,确保类型安全。

自学习管线

CC-Best 有三个知识管理命令:

bash 复制代码
/cc-best:learn     # 从当前会话提取模式
/cc-best:analyze   # 从 Git 历史发现规律
/cc-best:evolve    # 生成新的 Skills/Agents

/learn 工作流

bash 复制代码
会话结束时执行 /learn
        ↓
扫描本次会话的所有操作
        ↓
提取可复用的模式和决策
        ↓
保存到 memory-bank/
        ↓
下次会话自动加载

比如你这次调试了一个棘手的 TypeScript 类型错误,/learn 会记录你的调试路径和最终方案。下次遇到类似问题,这个知识会自动注入到上下文中。

/evolve 工作流

bash 复制代码
积累足够的 /learn 数据后执行 /evolve
        ↓
分析所有已学习的模式
        ↓
聚类相似模式
        ↓
生成新的 Skill 文件或 Agent 定义
        ↓
自动集成到插件中

这意味着你的插件会随着使用而进化,越来越贴合你的项目。

33 条规则系统

规则按目录组织,按文件类型自动匹配:

bash 复制代码
rules/
├── common/          # 通用规则(所有文件生效)
├── python/          # 编辑 .py 文件时加载
├── frontend/        # 编辑 .tsx/.vue/.svelte 文件时加载
├── java/            # 编辑 .java 文件时加载
├── csharp/          # 编辑 .cs 文件时加载
├── cpp/             # 编辑 .cpp/.h 文件时加载
├── embedded/        # 编辑嵌入式相关文件时加载
└── ui/              # 编辑 UI 相关文件时加载

每条规则都用自然语言写成,包含:

  • 命名约定
  • 错误处理模式
  • 性能最佳实践
  • 安全注意事项

不需要手动配置,编辑文件时自动生效。

进阶用法

结对编程模式

arduino 复制代码
/cc-best:pair

进入交互式结对编程,AI 每一步都会询问你的意见,适合学习和复杂决策。

GitHub Issue 端到端修复

bash 复制代码
/cc-best:fix-issue #42

自动完成:分析 Issue → 定位代码 → 修复 → 测试 → 提交 → 关闭 Issue。

版本发布

arduino 复制代码
/cc-best:release

自动同步版本号、更新 CHANGELOG、创建 Git Tag。

构建错误快速修复

bash 复制代码
/cc-best:fix

调用 build-error-resolver Agent,分析构建错误并生成最小化修复。

与其他方案对比

特性 原生 Claude Code Cursor Rules CC-Best
角色工作流 ✅ PM→Lead→Dev→QA→Verify
安全 Hooks ✅ 18 个自动化脚本
TDD 流程 ✅ 红→绿→重构
代码审查 ✅ 自动触发
安全审计 ✅ OWASP Top 10
自学习 ✅ learn→analyze→evolve
多语言规则 部分 ✅ 6 语言 8 框架
安装方式 --- 手动复制 ✅ 一行命令

总结

CC-Best 把软件工程的最佳实践打包成了一个 Claude Code 插件:

  • 角色工作流:PM → Lead → Dev → QA → Verify
  • 8 个 Agent:每个角色有专门的 AI 助手
  • 18 个 Hook:安全防护、自动格式化、类型检查
  • 33 条规则:6 种语言的编码规范
  • 自学习管线:越用越聪明

一行命令安装,零配置开始:

bash 复制代码
claude plugin add https://github.com/xiaobei930/cc-best

官网 : xiaobei930.github.io/cc-best/ GitHub : github.com/xiaobei930/... 版本 : v0.6.3 | 协议: MIT

如果觉得有用,请给个 ⭐ Star,这对开源项目真的很重要。

更多信息请访问 CC-Best 官网,有问题欢迎在评论区讨论,或直接到 GitHub 提 Issue。

相关推荐
恋猫de小郭6 小时前
AI 在提高你工作效率的同时,也一直在增加你的疲惫和焦虑
前端·人工智能·ai编程
程序员鱼皮11 小时前
我用 GLM-5 做了个 AI 女友,能发自拍、发语音、还能帮我干活!
程序员·aigc·ai编程
Invincible_12 小时前
🌟 Pi:藏在 OpenClaw 里的“最小”AI 编程助手
ai编程
小碗细面12 小时前
AI 编程三剑客:Spec-Kit、OpenSpec、Superpowers 深度对比与实战指南
aigc·ai编程
Vibe_Bloom12 小时前
最新!Claude Code 之父的 12 个配置分享
ai编程·claude
送梦想一个微笑25112 小时前
spring ai框架引入spring cloud alibaba2025.0.0后的修改
ai编程·mcp
小林攻城狮13 小时前
效率翻倍!TRAE 快速搞定项目规则与技能初始化
ai编程·vibecoding
Invincible_13 小时前
Codex Cli 在Windows 系统中 `AGENTS.md` 文件完整读取流程总结
ai编程
子昕13 小时前
老外吹爆的Pony就是它!让国产GLM-5写分布式系统,我验证了下,真行
ai编程
HashTang13 小时前
【AI 编程实战】第 11 篇:让小程序飞起来 - 性能优化实战指南
前端·uni-app·ai编程