claude-toolbox：为 Claude Code 和 Codex 打造的 dotfiles 式开发工作流工具箱

Skill超级捕获手 技术创作者 2026-09-07 14 阅读

claude-toolbox 是一款为 Claude Code 和 Codex 量身定制的 dotfiles 式配置与工作流工具箱。它把 MCP 服务器配置、Skills、命令、状态栏主题、权限基线等全部打包成一个随时可复用的配置集，让团队成员之间、跨项目之间的 AI 编程环境保持一致。核心理念：把”每次新建项目都要重新配置一遍”这件事，变成装一次、全局生效的标准化流程。

功能与原则

claude-toolbox 提供两大部分：一套极简但有主见的配置基线（权限、状态栏、MCP 接入、同步基础设施），以及一套结构化开发管线（13 个 workflow skills，覆盖从设计到文档的完整流程）。设计原则是”最小化但实用”——不做大而全的框架，而是解决真实开发中反复出现的配置碎片化问题。所有技能都有多语言精确支持：Go、Java、JS/TS、Kotlin、Kubernetes、Python 各自有独立的设计/实现/测试/审查指令。

认可度

  • GitHub Star：约 148 stars（截至 2026-09-07），今日新晋 trending
  • 作者定位：个人维护（@serpro69），项目文档明确标注”始终由人工审查和测试”，无 AI 垃圾内容
  • License：ELv2（比 MIT 更严格的弱开源协议）
  • 配套资源：独立文档站 https://serpro69.github.io/claude-toolbox/，含 Template Setup / Adopting / Plugin-Only 三种安装路径

链接

GitHub：https://github.com/serpro69/claude-toolbox

原作者

serpro69（GitHub @serpro69），个人开发者，文档站托管在 GitHub Pages。项目明确说明”借助 Claude Code 帮助创建，但所有代码由人工审查、测试和重构”，与当前泛滥的 AI 生成 Skill 拉开差异化。

介绍

claude-toolbox 的出发点很朴素：开发者每天在多个项目里切换，每次都要重新配置一遍 Claude Code 的权限、MCP 服务器和状态栏提示。这个 repo 最初只是存放跨项目复用配置的 dotfiles，随着使用中积累的重复 prompt 和工作流逐渐演变成 Skills 和 Sub-agents。

安装后的核心工作流是一个 6 步循环：/kk:design → /kk:review-design → /kk:implement → /kk:review-code → /kk:test → /kk:document。13 个 workflow skills 通过 /kk: 前缀命令触发，每个 skill 内部已经嵌入了跨语言精确指令（比如 Go 和 Python 的错误处理规范完全不同，工具箱分别处理）。

额外功能包括：多模型代码审查（通过 Sub-agents 调用 Gemini 等外部模型实现零偏差审查）、持久化知识库（通过 Capy 跨 Session 保留发现、决策和约定）、实时文档查询（通过 Context7 接入最新库文档）。

特点

  • dotfiles 式的即装即用：模板安装后即获得完整配置 + 插件预接 + 同步更新基础设施，新项目从第一天就用上统一配置
  • 13 个工作流 Skills：覆盖 design、review-design、implement、review-code、test、document 六大环节，命令行触发，无需每次写 prompt
  • 真正的多语言支持：Go/Java/JS-TS/Kotlin/K8s/Python 各自有独立的精准指令集，不是笼统的”最佳实践”
  • 多模型审查：通过 Sub-agents + 外部模型实现独立审查，消除自身 bias（/kk:review-code:isolated）
  • Battle-tested：作者明确标注”每日在多个真实项目中使用并测试”，非概念验证类项目

使用方法

方式一：模板安装（推荐新项目）

# 访问文档站获取最新安装命令
https://serpro69.github.io/claude-toolbox/latest/getting-started/template-setup/

方式二：接入已有项目

https://serpro69.github.io/claude-toolbox/latest/getting-started/adopting/

方式三：仅装 Skill（不装模板）

/plugin marketplace add https://github.com/serpro69/claude-toolbox
/plugin install kk@serpro69

核心工作流示例：

/kk:design  # 输入想法，Claude 提问澄清后输出设计文档到 docs/wip/
/kk:review-design your-feature  # 审查设计漏洞
/kk:implement  # 按任务列表执行，批量间有代码审查检查点
/kk:review-code  # SOLID 违规、安全风险、质量问题审查
/kk:test  # 测试覆盖验证
/kk:document  # 生成项目文档

使用场景与人群

  • 适用场景：多项目并行开发团队；需要在团队内统一 Claude Code 配置的企业；希望摆脱”每次新项目都重新配一遍”困境的个人开发者
  • 目标用户：Claude Code/Codex 重度用户；追求工程化 AI 编程流程的开发者；有多个项目需要统一代码规范和文档规范的技术负责人

输入与输出案例

案例一：新功能设计

  • Input：/kk:design + 描述”我要一个支持 Redis 缓存的用户 Session 模块”
  • Output：Claude 提出 5 个澄清问题（缓存失效策略？TTL 设计？Redis 集群支持？），确认后生成 docs/wip/session-cache.md（含接口设计、数据流图、任务列表）

案例二：代码审查

  • Input：/kk:review-code:isolated 在某 PR 页面触发
  • Output：启动独立 Sub-agent，以第三方视角审查代码，输出包含 SOLID 违规项、安全风险点、测试覆盖率缺口的结构化报告，全程无自身代码 authorship bias

claude-toolbox 的价值不在于某个炫酷的单点功能，而在于把 AI 编程环境从”随机配置”变成”可复制的基础设施”。如果你有多个项目正在用 Claude Code，想让团队成员都用同一套配置、同一套工作流，它是一个非常务实的选择。

GitHub: https://github.com/serpro69/claude-toolbox

评论区

0 条评论

登录后可评论。

Skill超级捕获手 14 阅读