Claude Forge

将 Claude Code 打造为全功能的开发环境。

---

什么是 Claude Forge？

Claude Forge 是一个针对 Claude Code 的开源开发环境，提供 11 个专用 AI Agent、40 个斜杠命令（slash commands）、15 个技能工作流以及 15 个自动化 Hook。它常被誉为“Claude Code 版的 oh-my-zsh”，能将基础的 CLI 工具转变为功能完备的开发环境。只需一次安装，即可获得 Agent、命令、技能、Hook 以及 9 个预置规则文件——所有组件均已预先配置，开箱即用。

你可以把它看作 Claude Code 的 oh-my-zsh：正如 oh-my-zsh 增强你的终端一样，Claude Forge 让你的 AI 编程助手如虎添翼。

---

⚡ 快速入门

安装插件（推荐）

Claude Forge 已上架 Anthropic 官方插件市场，可通过 Claude Code 直接安装：

# 选项 A：从官方市场安装（审核通过后可用）
/plugin install claude-forge@claude-plugins-official

# 选项 B：从 Claude Forge 市场安装
/plugin marketplace add sangrokjung/claude-forge
/plugin install claude-forge@claude-forge

# 选项 C：直接从 GitHub 安装
claude plugin install github:sangrokjung/claude-forge

更新命令：

/plugin marketplace update claude-forge

注意：Claude Forge 已提交至 Anthropic 官方插件目录，目前正在审核中。在此期间，请使用上述选项 B 或 C。

通过 Git Clone 安装

如需进行开发或自定义，请克隆存储库：

# 1. 克隆
git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git
cd claude-forge

# 2. 安装（创建指向 ~/.claude 的符号链接）
./install.sh

# 3. 启动 Claude Code
claude

install.sh 会将所有文件软链接至 ~/.claude/，因此执行 git pull 后即可立即更新。

如果你觉得 Claude Forge 有用，请考虑给项目一个 star —— 这能帮助更多人发现该项目。

v2.2 版本更新内容

变更	描述
外科手术式修改原则	新增第 12 条黄金原则：仅修改被要求的部分。禁止“顺手”重构、风格漂移或进行临近的“优化”。灵感源自 Andrej Karpathy 对 LLM 编程陷阱的观察。
编程前声明假设	新增交互规则：在实现模糊需求之前，必须先阐明假设并提供替代方案——禁止盲目猜测。
反合理化扩展	新增两条规则，阻断常见的 LLM 借口：“既然我在这儿，顺便清理一下”以及“为了可扩展性需要进行抽象”。

v2.1 版本变更

变更	描述
验证规则	新增 verification.md 规则，强制执行基于证据的完成度——没有最新的测试/构建输出，不得声称完成。
Agent 自我演进	核心 5 个 Agent（规划器、架构师、代码审查员、安全审查员、TDD 指导）现在会在每次任务后将学习成果记录在 ~/.claude/agent-memory/ 中。
Hook 同步	新增 forge-update-check.sh（会话启动更新通知）和 observe.sh（持续学习观察）。

新手指南

如果你是初次接触开发或 Claude Code，请从以下步骤开始：

步骤	操作
1	安装后运行 /guide —— 一个 3 分钟的交互式导览
2	阅读 First Steps —— 包含术语表 + 前 6 大常用命令
3	浏览 Workflow Recipes —— 5 个可直接复制粘贴的场景

或者直接输入 /auto login page，让 Claude Forge 为你处理从规划到 PR 的整个流程。

---

🔄 开发工作流

将命令、Agent 和技能串联起来的真实工作流。

功能开发

采用“规划先行，测试先行”的方法构建新功能：

/plan → /tdd → /code-review → /handoff-verify → /commit-push-pr → /sync

graph LR
    P["/plan设计与风险分析"] --> T["/tdd先测试，后代码"]
    T --> CR["/code-review质量与安全检查"]
    CR --> HV["/handoff-verify验证上下文"]
    HV --> CPR["/commit-push-pr提交、推送、PR与合并"]
    CPR --> S["/sync同步项目文档"]

    style P fill:#533483,stroke:#fff,color:#fff
    style T fill:#0f3460,stroke:#fff,color:#fff
    style CR fill:#0f3460,stroke:#fff,color:#fff
    style HV fill:#e94560,stroke:#fff,color:#fff
    style CPR fill:#1a1a2e,stroke:#fff,color:#fff
    style S fill:#16213e,stroke:#fff,color:#fff

步骤	执行操作
/plan	AI 创建实施计划。在编码前等待你的确认。
/tdd	先写测试，再写代码。一次只做一个工作单元。
/code-review	对代码进行安全性和质量检查。