sangrokjung/claude-forge

oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in one install. v4.0 adds an adversarial review loop: a second agent that never sees the first one's reasoning. MIT.

Claude Forge – Claude Code 的插件包

是什么 – Claude Forge 是一个预先配置好的代理、命令、技能、钩子、规则和工具集成的集合,可将基础的 Claude Code 终端编码助手转变为功能齐全的开发工作站。可以将其类比为 oh‑my‑zsh 对于 Shell:核心助手保持不变,但该插件包添加了数十个专业“同事”、安全网检查和一键快捷方式。

为何重要 – Claude Code 可以生成代码,但仅靠它自己,你必须记得运行测试、进行安全审查、保持文档同步等。Claude Forge 自动将这些最佳实践步骤串联起来,添加了一个 6 层钩子系统,可阻止高风险操作(例如,泄露密钥、运行不安全命令),并提供一个验证循环,要求第二个独立代理在批准前审查每个变更。


主要组件(如 README 所列)

组件 数量 作用(通俗语言)
代理 16 专业 AI「同事」(规划者、架构师、安全审查员、测试优先引导员、数据库审查员等),在合适任务中自动调用。
命令 35 你在 Claude Code 会话中输入的斜杠快捷方式(/plan, /tdd, /code‑review, /e2e, …),单击一次即可启动完整工作流。
技能 33 无需进一步提示,Claude 即可遵循的预写剧本(例如 loop‑forge, review‑loop, harness‑diet)。
钩子 22(另加 9 个可选示例) 在每个 Claude 操作前后静默运行的安全检查——阻止密钥泄露、危险数据库命令、API 错误后自动恢复、报告会话时长等。
规则 14 会话启动时读取的文本文件,定义编码风格、安全策略、Git 工作流、何时必须进行验证等。
MCP 连接 4 外部工具桥接——Playwright 浏览器自动化、实时文档查询、Jina 网页阅读器、Chrome DevTools 集成。

安装方式

方法 你将获得的内容
选项 A – Claude Code 插件 安装 35 个命令和大部分技能。代理、钩子、规则和外部工具连接不会被安装。
选项 B – 完整安装(推荐) 运行一行 `curl …

两种方法均可通过 /plugin update claude-forge(选项 A)或 ./install.sh --upgrade(选项 B)后续更新。


如何使用

  1. 在终端中启动一个 Claude Code 会话。
  2. 输入斜杠命令,例如 /plan → Claude 会要求你确认生成的实现计划。
  3. 运行 /tdd → 先写测试,再写代码,tdd‑guide 代理确保 RED‑GREEN‑REFactor 循环。
  4. 完成变更后,调用 /code‑review → code‑reviewer 和 security‑reviewer 代理运行,同时 22 个钩子静默阻止任何不安全操作。
  5. 以 /handoff‑verify 或 /verify‑loop 结束——一个全新上下文的 adversarial‑reviewer 检查变更,返回 APPROVE 或 REQUEST_CHANGES,然后可通过 /commit‑push‑pr 自动提交。

上述所有操作均由内置的 team‑orchestrator 代理协调,可并行运行多个代理,并将任务路由给最合适的专家。


架构快照(如 README 所述)

  • 核心 – 解释斜杠命令和技能的 Claude Code 运行时。
  • 代理层 – 16 个专用 LLM 代理,分为 deep‑analysis(高容量模型)和 fast‑execution(轻量模型)组。
  • 钩子系统 – 22 个事件驱动的安全检查,在 21 个生命周期时刻(命令前、命令后、错误、会话开始/结束等)触发。
  • 规则引擎 – 会话启动时加载的静态 Markdown 文件(CLAUDE.md + 规则文件),用于引导模型行为。
  • MCP(多通道插件)连接 – 通过 Playwright、Jina‑reader、Chrome DevTools 等访问外部服务,将其暴露为子代理。
  • 验证循环 – 制作者 ≠ 检查者模式,adversarial‑reviewer(从不查看制作者的推理)必须明确 APPROVE 才能认为变更完成。

哪些人可能用得上?

  • 已使用 Claude Code 但不想手动构建安全网的开发者。
  • 需要可复现、可审计的 AI 生成代码的团队(安全、合规、SOC2/ISO27001、GDPR、HIPAA 环境)。
  • 希望从规划到 PR 实现“一键式”流程的独立工程师。

快速入门检查清单

  1. 打开 Claude Code。
  2. 运行两个插件命令(选项 A)或 执行 install.sh 脚本(选项 B)。
  3. 尝试一个演示命令:/plan → 确认 → /tdd → 观察生成的测试和代码。
  4. 满意后,运行 /commit‑push‑pr 自动创建 PR。
  5. 通过 ./install.sh --upgrade 或 /plugin update claude‑forge 保持插件更新。

许可与社区

  • MIT 许可证 – 个人或商业用途免费。
  • 仓库显示活跃维护(最新 v4.3.0 发布于 2026 年 9 月)和不断增长的贡献者基础(星标、分叉、近期提交)。
  • 文档包含多语言安装指南(13 种语言)和详细的 验证循环 说明。

总结:Claude Forge 是对 Claude Code AI 编码助手的全面、即插即用的增强,提供专业代理、安全钩子、预设命令和工具集成,让你能将 Claude 视为一个完全就绪的开发团队成员,而非仅是基础代码生成器。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目