前言
如果你在用 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:
- architect --- 生成技术方案,包含目录结构、API 设计、数据模型
- planner --- 将方案分解为可执行的任务列表
你会看到类似这样的输出:
diff
架构决策:
- 使用 Express + TypeScript
- 内存存储(满足 MVP 要求)
- RESTful 路由设计
- 错误处理中间件
任务分解:
□ 初始化项目结构
□ 实现 Todo 数据模型
□ 实现 CRUD 路由
□ 添加错误处理中间件
□ 编写单元测试
□ 集成测试
Step 3: 编码实现
bash
/cc-best:dev
这一步调用三个 Agent 协同工作:
- tdd-guide --- 先写测试,再写实现(红 → 绿 → 重构)
- code-simplifier --- 实现后自动简化代码
- 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 --forcegit 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。