sangrokjung/claude-forge

将 Claude Code 变成完整的开发环境

v3.0 新特性 • 快速开始 • 工作流 • 包含内容 • 安装 • 架构 • 自定义 • 한국어

## 什么是 Claude Forge？ Claude Forge 是一个为 Claude Code 打造的开源开发环境，提供了 11 个专业化 agent、33 个斜杠命令、24 个 skill 工作流、15 个自动化 hook（加上涵盖 21 个生命周期事件的可选示例 9 个），以及 9 个规则文件。它通常被称为“Claude Code 的 oh-my-zsh”，将 Claude Code 从基础的 CLI 转变为了一个功能齐全的开发环境。一次安装即可获得 agents、commands、skills、hooks 和 rules —— 全部预先配置好，开箱即用。 ## ⚡ 快速开始 ### 选项 1 — Claude Code 插件（部分覆盖，v3.0.1+） 在 Claude Code 内部，注册一次市场，然后安装插件： ``` /plugin marketplace add sangrokjung/claude-forge /plugin install claude-forge ``` 稍后可通过 `/plugin update claude-forge`（或从 `/plugin` UI）进行更新。 ### 选项 2 — 经典 `install.sh`（完整符号链接安装，推荐） ``` # 1. Clone（submodules 可选 — 仅 CC CHIPS 状态栏需要） git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git cd claude-forge # 2. Install（在 ~/.claude 下创建 symlinks） ./install.sh # 3. Launch Claude Code claude ``` `install.sh` 将每个资源通过符号链接连接到 `~/.claude/`，因此 `git pull` 即可瞬间完成更新， 并且这是唯一能够一次性交付 agents、hooks、rules、4 个 MCP 服务器和状态栏的安装路径。 不使用 `--recurse-submodules` 进行克隆同样有效：CC CHIPS 子模块是可选的，如果目录为空， 安装程序会干净地跳过它（会打印一行提示）。 ### 我应该选择哪个选项？ | 资源 | 选项 1 (`/plugin install`) | 选项 2 (`./install.sh`) | |----------|:----------------------------:|:-------------------------:| | 命令 (33) | ✅ | ✅ | | 技能 (24) | ⚠️ 部分¹ | ✅ | | 代理 (11) | ❌ | ✅ | | 钩子 (15 + 9 示例)| ❌² | ✅ | | 规则 (9) | ❌ | ✅ | | MCP 服务器 (4) | ❌³ | ✅ | | statusLine (CC CHIPS) | ❌ | ✅ (可选子模块) | | `settings.json` 环境变量 | ❌ | ✅ | ¹ 插件加载的 skills 受支持，但触及 `~/.claude/rules/` 或 `~/.claude/agents/` 的 QJC skill 功能假定使用的是符号链接布局。 ² 参见 `hooks/hooks.json`：Claude Code 不会加载单独的 `hooks.json`；所有的 hook 设置必须位于 `settings.json` 中，而选项 1 不会合并这些设置。 ³ `plugin.json` 目前并未以加载器能够采取行动的方式暴露 `mcpServers`。MCP 服务器来源于 `.mcp.json` / `mcp-servers.json`，只有选项 2 对其进行了配置。 **建议：** 除非您只需要 Commands 和部分 Skills，否则请使用选项 2。 ### 🎉 v3.0 中的新特性 | 变更 | 描述 | |:-------|:------------| | **Hooks 21 个事件** | 生命周期 hooks 从 5 个事件扩展到了 21 个。可选示例位于 [`hooks/examples/`](hooks/examples/)，完整目录在 [`hooks/README.md`](hooks/README.md)。 | | **子代理 Frontmatter v2** | 10 个可选字段：`isolation`、`background`、`memory`、`maxTurns`、`skills`、`mcpServers`、`effort`、`hooks`、`permissionMode`、`disallowedTools`。Schema：[`reference/agent-schema.json`](reference/agent-schema.json)。详情：[`docs/AGENT-FRONTMATTER-V2.md`](docs/AGENT-FRONTMATTER-V2.md)。 | | **技能/命令混合策略** | 在 [`docs/SKILLS-VS-COMMANDS.md`](docs/SKILLS-VS-COMMANDS.md) 中记录了清晰的边界。8 个目录形式的命令正在迁移到 `skills/`，并保留了符号链接兼容性。 | | **MCP 最小集 (4 个服务器, v3.0.1)** | 默认集：`playwright` · `context7` · `jina-reader` · `chrome-devtools-mcp@0.23.0` (Google ChromeDevTools org, Apache-2.0 — 在 v3.0.1 中为 Lighthouse / Core Web Vitals 审计而引入)。旧版的完整集位于 [`mcp-servers.optional.json`](mcp-servers.optional.json)。配方：[`docs/MCP-MIGRATION.md`](docs/MCP-MIGRATION.md)。决策理由：[`docs/adr/ADR-001-mcp-default-set.md`](docs/adr/ADR-001-mcp-default-set.md)。 | | **CLAUDE.md 模板 + @import** | 新的 [`setup/CLAUDE.md.template`](setup/CLAUDE.md.template) 和 [`docs/CLAUDE-MD-GUIDE.md`](docs/CLAUDE-MD-GUIDE.md)，包含 200 行原则和用于模块化项目指令的 `@import` 模式。 | | **settings.json 2026 字段** | 新字段：`tui` (无闪烁渲染)、`disableSkillShellExecution` (沙盒)、`enabledMcpjsonServers` (显式允许列表)。 | | **一行命令升级** | `./install.sh --upgrade` 可安全迁移现有的 v2.1 安装，并提供备份和 diff 预览。 | ### 🔧 v3.0.1 中的新特性 (补丁) | 变更 | 描述 | |:-------|:------------| | **已发布插件清单 (部分)** | `/plugin marketplace add sangrokjung/claude-forge` + `/plugin install claude-forge` 现可用于 Commands + Skills。[`.claude-plugin/plugin.json`](.claude-plugin/plugin.json) + [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) 均固定为 `3.0.1`；CI 通过新的 `marketplace-schema` 任务强制执行版本偏移检查。Agents / Hooks / Rules / MCP / statusLine 仍然需要 `./install.sh` —— 参见 [`docs/PLUGIN-VS-INSTALL-SH.md`](docs/PLUGIN-VS-INSTALL-SH.md)。 | | **Chrome DevTools 被引入** | Lighthouse / Core Web Vitals / 内存快照现随默认的 4 服务器 MCP 集提供。固定版本为 `chrome-devtools-mcp@0.23.0` (供应链强化)。 | | **`hooks/_lib/timing.sh`** | 新的包装器将 SessionEnd hook 计时记录到 `~/.claude/logs/hook-timing.jsonl` (模式 600) 中，以便可以事后审计 `async: true` hooks 的真实并行度。开销约 35 毫秒。 | | **CI 触发器已扩展** | [`.github/workflows/validate.yml`](.github/workflows/validate.yml) 现在会在每个 PR 以及 `main`/`feat/**`/`fix/**`/`chore/**`/`docs/**`/`ci/**` 推送时运行（以前仅在 `main` 分支上）。共计 6 个任务。 | | **Tier 0 规范修正** | Hook 类型对齐为 `command`/`http`/`prompt`/`agent` (以前是 `llm-prompt`/`mcp-tool`)。`timeout` 单位更正为**秒** (以前是毫秒)。自动记忆路径为 `~/.claude/projects//memory/` (以前是 ``)。 | | **新治理文档** | [`docs/adr/ADR-001-mcp-default-set.md`](docs/adr/ADR-001-mcp-default-set.md) (MCP 默认决策，MADR) · [`docs/SETTINGS-COMPATIBILITY.md`](docs/SETTINGS-COMPATIBILITY.md) (未验证字段追踪) · [`docs/MARKETPLACE-SUBMISSION.md`](docs/MARKETPLACE-SUBMISSION.md) (官方目录提交包)。 | | **四方独立审查** | super-research (Tier 0 文档) · security-reviewer · architect · codex-reviewer 在补丁上并行运行。在合并前关闭了 11 个阻塞问题。 | ### 🚨 破坏性变更 - **MCP 默认集缩减** — `memory`、`exa`、`github` 和 `fetch` 已从 `mcp-servers.json` 中移除。如果需要，可以从 [`mcp-servers.optional.json`](mcp-servers.optional.json) 恢复其中的任何一个。内置替代方案：Auto Memory、`gh` CLI、`WebSearch` 和 `jina-reader` 回退机制涵盖了以前的大多数用例。 - **8 个命令已移至 `skills/`** — 符号链接兼容性将保留至 **2027-04-01**。受影响项：`debugging-strategies`、`dependency-upgrade`、`evaluating-code-models`、`evaluating-llms-harness`、`extract-errors`、`security-compliance`、`stride-analysis-patterns`、`summarize`。 - **settings.json 允许列表** — 移除了 `mcp__memory`、`mcp__exa`、`mcp__github`、`mcp__fetch`。添加了 `mcp__playwright`。 ### 为什么是 v3.0？ 2026 Anthropic Claude Code 标准发生了显著演进（Skills/Commands 集成、21 个 hook 事件、扩展的子代理 frontmatter）。v3.0 完全符合该标准，**将默认 MCP 依赖项从 6 个减少到了 4 个**（v3.0 发布了 3 个服务器的最小集；v3.0.1 将 `chrome-devtools-mcp@0.23.0` 提升至默认集），以降低新用户的门槛，并融入了 dotclaude 运维经验（安全允许列表、安全中断迁移）。现有的 v2.1 用户可以通过一行命令进行迁移：`./install.sh --upgrade`。 ### 新手入门？ 如果您是开发或 Claude Code 的新手，请从以下步骤开始： | 步骤 | 做什么 | |:-----|:-----------| | 1 | 安装后运行 `/guide` —— 这是一个交互式的 3 分钟导览 | | 2 | 阅读 [First Steps](docs/FIRST-STEPS.md) —— 词汇表 + TOP 6 命令 | | 3 | 浏览 [Workflow Recipes](docs/WORKFLOW-RECIPES.md) —— 5 个可复制粘贴的场景 | 或者直接输入 `/auto login page`，让 Claude Forge 为您处理从规划到 PR 的整个流程。 ## 🔄 开发工作流

将命令、代理和技能串联起来的真实世界工作流。 ### 功能开发 采用先计划、先测试的方法构建新功能： ``` /plan → /tdd → /code-review → /handoff-verify → /commit-push-pr → /sync ``` ``` graph LR P["/plan
Design & risk analysis"] --> T["/tdd
Tests first, then code"] T --> CR["/code-review
Quality & security check"] CR --> HV["/handoff-verify
Fresh-context validation"] HV --> CPR["/commit-push-pr
Commit, push, PR & merge"] CPR --> S["/sync
Sync project docs"] 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` | 对您刚刚编写的代码进行安全 + 质量检查。 | | `/handoff-verify` | 自动一次性验证 build/test/lint。 | | `/commit-push-pr` | 提交、推送、创建 PR，并可选择合并 —— 一步到位。 | | `/sync` | 同步项目文档 (prompt_plan.md, spec.md, CLAUDE.md, rules)。 | ### Bug 修复 具有自动重试机制的快速 Bug 修复： ``` /explore → /tdd → /verify-loop → /quick-commit → /sync ``` | 步骤 | 发生了什么 | |:-----|:-------------| | `/explore` | 导航代码库以找到 Bug 所在位置。 | | `/tdd` | 编写一个能重现 Bug 的测试，然后修复它。 | | `/verify-loop` | 自动重试 build/lint/test 最多 3 次，并在失败时自动修复。 | | `/quick-commit` | 对简单且经过良好测试的更改进行快速提交。 | | `/sync` | 提交后同步项目文档。 | ### 安全审计 结合 CWE 和 STRIDE 的综合安全分析： ``` /security-review → /stride-analysis-patterns → /security-compliance ``` | 步骤 | 发生了什么 | |:-----|:-------------| `/security-review` | CWE Top 25 漏洞扫描 + STRIDE 威胁建模。 | | `/stride-analysis-patterns` | 应用于系统架构的系统化 STRIDE 方法论。 | | `/security-compliance` | SOC2、ISO27001、GDPR、HIPAA 合规性验证。 | ### 团队协作

针对复杂任务的并行多代理执行： ``` /orchestrate → Agent Teams (parallel work) → /commit-push-pr ``` | 步骤 | 发生了什么 | |:-----|:-------------| | `/orchestrate` | 创建一个具有文件所有权分离和中心辐射式协调的代理团队。 | | 代理团队 | 多个代理并行处理前端、后端、测试等任务。 | | `/commit-push-pr` | 合并所有工作，验证并发布。 | ## 为什么选择 Claude Forge？ 大多数开发者要么直接使用 Claude Code 而不进行自定义，要么花费数小时组装单独的配置。Claude Forge 让您在 5 分钟内获得一套生产就绪的设置。 | 特性 | Claude Forge | 基础 `.claude/` 设置 | 单独插件 | |:--------|:------------|:-----------------------|:-------------------| | **代理** | 11 个预配置 (frontmatter v2) | 需手动设置 | 因插件而异 | | **斜杠命令** | 40 个即用型 (混合策略) | 无 | 基于单个插件 | | **技能工作流** | 15+ 多步骤流水线 | 无 | 基于单个插件 | | **钩子** | 15 个内置 + 9 个可选示例 (21 个事件) | 默认无 | 基于单个插件 | | **MCP 服务器** | 3 个最小集 (8+ 个可选) | 无 | 基于单个插件 | | **安装** | 5 分钟，一条命令 | 数小时的手动配置 | 按插件安装 | | **更新** | `git pull` + `./install.sh --upgrade` | 手动按文件更新 | 按插件更新 | | **工作流集成** | 端到端流水线 (从计划到 PR) | 孤立的工具 | 未集成 | ## 📦 Claude Forge 包含内容

| 类别 | 数量 | 亮点 | |:--------:|:-----:|:-----------| | **代理** | 11 | `planner` `architect` `code-reviewer` `security-reviewer` `tdd-guide` `database-reviewer` + 另外 5 个 (frontmatter v2) | | **命令** | 40 | `/commit-push-pr` `/handoff-verify` `/explore` `/tdd` `/plan` `/orchestrate` `/security-review` ... | | **技能** | 15+ | `build-system` `security-pipeline` `eval-harness` `team-orchestrator` `session-wrap` ... (+8 个从 commands/ 迁移而来) | | **钩子** | 15 + 9 示例 | 15 个内置 (秘密过滤、远程命令防护、数据库保护、安全自动触发、速率限制 ...) + 9 个涵盖 21 个生命周期事件的可选示例 | | **规则** | 9 | `coding-style` `security` `git-workflow` `golden-principles` `agents` `interaction` `verification` ... | | **MCP 服务器** | 4 (最小集) | `playwright` `context7` `jina-reader` `chrome-devtools@0.23.0` — 还有 7+ 个在 [`mcp-servers.optional.json`](mcp-servers.optional.json) 中可用 | ## 📥 Claude Forge 安装指南 ### 作为 Claude Code 插件 (v3.0.1+，部分覆盖) 自 v3.0.1 起，claude-forge 提供了标准的 Claude Code 插件清单 (`.claude-plugin/plugin.json` + `.claude-plugin/marketplace.json`)。通过标准的两步流程进行安装： ``` /plugin marketplace add sangrokjung/claude-forge /plugin install claude-forge ``` 通过 `/plugin update claude-forge`（或 `/plugin` UI）进行升级。目前此路径覆盖的内容（根据 Claude Code 当前的插件加载器）：**Commands + 大部分 Skills。** Agents、Hooks、Rules、4 个 MCP 服务器、statusLine 和 `settings.json` 环境变量块仍然需要下面经典 `./install.sh` 的支持。有关逐项资源的对比矩阵，请参见 [`docs/PLUGIN-VS-INSTALL-SH.md`](docs/PLUGIN-VS-INSTALL-SH.md)。大多数用户应将 `./install.sh` 作为主要安装方式。 ### 前置条件 | 依赖项 | 版本 | 检查命令 | |:-----------|:--------|:------| | Node.js | v22+ | `node -v` | | Git | 任意 | `git --version` | | jq | 任意 (macOS/Linux) | `jq --version` | | Claude Code CLI | ≥1.0 | `claude --version` | ### macOS / Linux ``` git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git cd claude-forge ./install.sh # fresh install # 或 ./install.sh --upgrade # safe v2.1 → v3.0 migration (backup + diff preview) ``` 安装程序将： 1. 检查依赖项 2. 初始化 git 子模块 (CC CHIPS status bar) 3. 如果存在，备份现有的 `~/.claude/` 4. 为 7 个目录 + `settings.json` 创建到 `~/.claude/` 的**符号链接** 5. 应用 CC CHIPS 自定义覆盖层 6. 可选安装 MCP 服务器和外部 skills 7. 添加 shell 别名 (`cc` → `claude`, `ccr` → `claude --resume`) 由于使用了符号链接，在仓库中执行 `git pull` 即可瞬间更新一切。拉取 v3.0 后，请使用 `--upgrade` 以原地应用 MCP/设置迁移。 ### Windows ``` # 以 Administrator 身份运行 PowerShell .\install.ps1 ``` Windows 使用**文件复制**而不是符号链接。在 `git pull` 之后重新运行 `install.ps1` 进行更新。 ### MCP 服务器设置 v3.0.1 附带 **4 个最小默认集**。其他可通过 [`mcp-servers.optional.json`](mcp-servers.optional.json) 选择启用。完整配方：[`docs/MCP-MIGRATION.md`](docs/MCP-MIGRATION.md)。决策理由：[`docs/adr/ADR-001-mcp-default-set.md`](docs/adr/ADR-001-mcp-default-set.md)。 | 服务器 | 默认？ | API 密钥 | 设置 | |:-------|:--------:|:--------|:------| | **playwright** | ✅ | 不需要 | 通过 `install.sh` 自动安装 | | **context7** | ✅ | 不需要 | 通过 `install.sh` 自动安装 | | **jina-reader** | ✅ | 不需要 | 通过 `install.sh` 自动安装 | | **chrome-devtools** | ✅ | 不需要 | 通过 `install.sh` 自动安装 (固定版本 `@0.23.0`，Google ChromeDevTools org, Apache-2.0) | | **memory** | 可选 | 不需要 | 从 `mcp-servers.optional.json` 合并 | | **fetch** | 可选 | 不需要 | 需要 `uvx` (Python) | | **exa** | 可选 | OAuth | `claude mcp add exa --url https://mcp.exa.ai/mcp` | | **github** | 可选 | PAT | 设置 `GITHUB_PERSONAL_ACCESS_TOKEN` 环境变量 | ### 自定义 在不修改被追踪文件的情况下覆盖设置： ``` cp setup/settings.local.template.json ~/.claude/settings.local.json vim ~/.claude/settings.local.json ``` `settings.local.json` 会自动合并到 `settings.json` 之上。 ## 🏗 Claude Forge 架构

``` graph TB subgraph REPO["claude-forge (git repo)"] A["agents/ (11)"] C["commands/ (40)"] S["skills/ (15)"] H["hooks/ (15)"] R["rules/ (9)"] SC["scripts/"] CC["cc-chips/"] K["knowledge/"] REF["reference/"] SET["settings.json"] end INSTALL["./install.sh"] REPO --> INSTALL subgraph HOME["~/.claude/ (symlinked)"] HA["agents/"] HC["commands/"] HS["skills/"] HH["hooks/"] HR["rules/"] HSC["scripts/"] HCC["cc-chips/"] HSET["settings.json"] end INSTALL -->|symlink| HOME CLAUDE["claude (CLI)"] HOME --> CLAUDE style REPO fill:#1a1a2e,stroke:#e94560,color:#fff style HOME fill:#0f3460,stroke:#16213e,color:#fff style INSTALL fill:#e94560,stroke:#fff,color:#fff style CLAUDE fill:#533483,stroke:#fff,color:#fff ```

完整目录树

``` claude-forge/ ├── agents/ Agent definitions (11 .md files, frontmatter v2) ├── cc-chips/ Status bar submodule ├── cc-chips-custom/ Custom status bar overlay ├── commands/ Slash commands (32 .md, 8 dirs moved to skills/) ├── docs/ Screenshots, diagrams, policy docs (v3.0 guides) ├── hooks/ Event-driven shell scripts (18) │ └── examples/ Opt-in .example samples for 21 lifecycle events (9) ├── knowledge/ Knowledge base entries ├── reference/ Reference docs (+ agent-schema.json) ├── rules/ Auto-loaded rule files (9) ├── scripts/ Utility scripts ├── setup/ Installation guides + CLAUDE.md template ├── skills/ Multi-step skill workflows (15+, hybrid policy) ├── install.sh macOS/Linux installer (--upgrade supported) ├── install.ps1 Windows installer (--upgrade supported) ├── mcp-servers.json MCP server defaults (4 minimal) ├── mcp-servers.optional.json Optional MCP servers (memory/exa/github/fetch/time/...) ├── .claude-plugin/plugin.json Plugin manifest (3.0.2) ├── .claude-plugin/marketplace.json Marketplace entry (3.0.2) ├── settings.json Claude Code settings (2026 fields) ├── MIGRATION.md v2.1 → v3.0 migration guide (EN) ├── MIGRATION.ko.md v2.1 → v3.0 migration guide (KO) ├── CONTRIBUTING.md Contribution guide ├── SECURITY.md Security policy └── LICENSE MIT License ```

## 🛡 Claude Code 自动化钩子 ### 安全钩子

| 钩子 | 触发条件 | 防护目标 | |:-----|:--------|:-----------------| | `output-secret-filter.sh` | PostToolUse | 输出中泄露的 API 密钥、token、密码 | | `remote-command-guard.sh` | PreToolUse (Bash) | 不安全的远程命令 (curl pipe, wget pipe) | | `db-guard.sh` | PreToolUse | 破坏性的 SQL (不带 WHERE 的 DROP, TRUNCATE, DELETE) | | `security-auto-trigger.sh` | PostToolUse (Edit/Write) | 代码更改中的漏洞 | | `rate-limiter.sh` | PreToolUse (MCP) | MCP 服务器滥用 / 过度调用 | | `mcp-usage-tracker.sh` | PreToolUse (MCP) | 跟踪 MCP 使用情况以供监控 | ### 实用工具钩子 | 钩子 | 触发条件 | 目的 | |:-----|:--------|:--------| | `code-quality-reminder.sh` | PostToolUse (Edit/Write) | 提醒不可变性、小文件、错误处理 | | `context-sync-suggest.sh` | SessionStart | 建议在会话开始时同步文档 | | `session-wrap-suggest.sh` | Stop | 建议在结束前进行会话总结 | | `work-tracker-prompt.sh` | UserPromptSubmit | 跟踪工作以供分析 | | `work-tracker-tool.sh` | PostToolUse | 跟踪工具使用情况以供分析 | | `work-tracker-stop.sh` | Stop | 敲定工作跟踪数据 | | `task-completed.sh` | TaskCompleted | 在子代理任务完成时发出通知 | | `expensive-mcp-warning.sh` | - | 警告成本高昂的 MCP 操作 | ### 可选示例 (v3.0) 9 个额外的 `.example` 示例涵盖了较新的生命周期事件（SessionEnd、PreCompact、SubagentStart/Stop、MessageStart/End、UserPromptReceived 等），它们位于 [`hooks/examples/`](hooks/examples/)。完整的 21 事件目录和配方在 [`hooks/README.md`](hooks/README.md)。将 `*.example` 重命名为 `*.sh` 并在 `settings.json` 中注册即可激活。 ## 🤖 Claude Code 代理 每个代理在 UI 中都有一个**颜色**，用于快速的视觉识别： ### Opus 代理 (6 个) -- 深度分析与规划 | 代理 | 颜色 | 目的 | |:------|:-----:|:--------| | **planner** | 蓝色 | 复杂功能和重构的实现规划 | | **architect** | 蓝色 | 系统设计、可扩展性决策、技术架构 | | **code-reviewer** | 蓝色 | 质量、安全性和可维护性审查 | | **security-reviewer** | 红色 | OWASP Top 10、秘密、SSRF、注入检测 | | **tdd-guide** | 青色 | 测试驱动开发强制执行 (RED → GREEN → IMPROVE) | | **database-reviewer** | 蓝色 | PostgreSQL/Supabase 查询优化，schema 设计 | ### Sonnet 代理 (5 个) -- 快速执行与自动化 | 代理 | 颜色 | 目的 | |:------|:-----:|:--------| | **build-error-resolver** | 青色 | 以最小的 diff 修复 build/TypeScript 错误 | | **e2e-runner** | 青色 | 生成并运行 Playwright E2E 测试 | | **refactor-cleaner** | 黄色 | 使用 knip、depcheck、ts-prune 清理死代码 | | **doc-updater** | 黄色 | 文档和代码地图更新 | | **verify-agent** | 青色 | 全新上下文的 build/lint/test 验证 | ### 颜色语义 | 颜色 | 含义 | |:------|:--------| | **蓝色** | 分析与审查 | | **青色** | 测试与验证 | | **黄色** | 维护与数据 | | **红色** | 安全与关键 | | **品红** | 创意与研究 | | **绿色** | 业务与成功 | ## 📋 所有 Claude Forge 命令

40 个命令 (点击展开)

#### 核心工作流 | 命令 | 描述 | |:--------|:------------| | `/plan` | AI 创建实现计划。在编码前等待确认。 | | `/tdd` | 先写测试，然后写代码。一次一个工作单元。 | | `/code-review` | 对您刚刚编写的代码进行安全 + 质量检查。 | | `/handoff-verify` | 自动一次性验证 build/test/lint。 | | `/commit-push-pr` | 提交、推送、创建 PR，可选择合并 —— 一步到位。 | | `/quick-commit` | 对简单、经过良好测试的更改进行快速提交。 | | `/verify-loop` | 自动重试 build/lint/test 最多 3 次，并在失败时自动修复。 | | `/auto` | 一键自动化：从计划到 PR，中间无需停止。 | | `/guide` | 为首次用户提供的交互式 3 分钟导览。 | #### 探索与分析 | 命令 | 描述 | |:--------|:------------| `/explore` | 导航并分析代码库结构。 | | `/build-fix` | 逐步修复 TypeScript 和构建错误。 | | `/next-task` | 根据项目状态推荐下一个任务。 | | `/suggest-automation` | 分析重复模式并建议自动化方案。 | #### 安全 | 命令 | 描述 | |:--------|:------------| | `/security-review` | CWE Top 25 + STRIDE 威胁建模。 | | `/stride-analysis-patterns` | 用于威胁识别的系统化 STRIDE 方法论。 | | `/security-compliance` | SOC2、ISO27001、GDPR、HIPAA 合规性检查。 | #### 测试与评估 | 命令 | 描述 | |:--------|:------------| | `/e2e` | 生成并运行 Playwright 端到端测试。 | | `/test-coverage` | 分析覆盖率差距并生成缺失的测试。 | | `/eval` | 评估驱动的开发工作流管理。 | | `/evaluating-code-models` | 基准代码生成模型 (HumanEval, MBPP)。 | | `/evaluating-llms-harness` | 跨 60+ 个学术基准测试对 LLM 进行基准测试。 | #### 文档与同步 | 命令 | 描述 | |:--------|:------------| | `/update-codemaps` | 分析代码库并更新架构文档。 | | `/update-docs` | 从真实数据源同步文档。 | | `/sync-docs` | 同步 prompt_plan.md, spec.md, CLAUDE.md + rules。 | | `/sync` | 拉取最新更改并同步所有项目文档 (prompt_plan.md, spec.md, CLAUDE.md, rules)。在任何工作流之后或会话开始时使用。 | | `/pull` | 快速 `git pull origin main`。 | #### 项目管理 | 命令 | 描述 | |:--------|:------------| | `/init-project` | 使用标准结构搭建新项目。 | | `/orchestrate` | 代理团队并行编排。 | | `/checkpoint` | 保存/恢复工作状态。 | | `/learn` | 记录经验教训 + 建议自动化。 | | `/web-checklist` | 合并后的 Web 测试清单。 | #### 重构与调试 | 命令 | 描述 | |:--------|:------------| | `/refactor-clean` | 在测试验证下识别并移除死代码。 | | `/debugging-strategies` | 系统化的调试技术和性能分析。 | | `/dependency-upgrade` | 兼容性分析下的主要依赖项升级。 | | `/extract-errors` | 提取并对错误消息进行分类。 | #### Git Worktree | 命令 | 描述 | |:--------|:------------| | `/worktree-start` | 创建用于并行开发的 git worktree。 | | `/worktree-cleanup` | 在 PR 完成后清理 worktrees。 | #### 实用工具 | 命令 | 描述 | |:--------|:------------| | `/summarize` | 总结 URL、播客、文字记录、本地文件。 |

## 🧩 所有 Claude Forge 技能

15 个技能 (点击展开)

| 技能 | 描述 | |:------|:------------| | **build-system** | 自动检测并运行项目构建系统。 | | **cache-components** | Next.js Cache Components 和部分预渲染 (PPR) 指南。 | | **cc-dev-agent** | Claude Code 开发工作流优化（上下文工程、子代理、TDD）。 | | **continuous-learning-v2** | 基于本能的学习：通过 hooks 观察会话，创建带有置信度评分的原子本能。 | | **eval-harness** | 用于评估驱动开发 (EDD) 的正式评估框架。 | | **frontend-code-review** | 带有清单规则的前端文件审查 (.tsx, .ts, .js)。 | | **manage-skills** | 分析会话更改，检测缺失的验证技能，创建/更新技能。 | | **prompts-chat** | 技能/提示词探索、搜索和改进。 | | **security-pipeline** | CWE Top 25 + STRIDE 自动化安全验证流水线。 | | **session-wrap** | 会话结束清理：4 个并行子代理检测文档、模式、学习心得、后续跟进。 | | **skill-factory** | 自动将可复用的会话模式转换为 Claude Code 技能。 | | **strategic-compact** | 在逻辑间隔点建议手动进行上下文压缩以保留上下文。 | | **team-orchestrator** | 代理团队引擎：团队组成、任务分配、依赖管理。 | | **verification-engine** | 集成验证引擎：全新上下文的子代理验证循环。 | | **verify-implementation** | 运行所有项目验证技能并生成统一的模式验证报告。 |

## 常见问题

什么是 Claude Forge？

Claude Forge 是一个为 Claude Code 打造的开源开发环境。它将 11 个专业化 agent、33 个斜杠命令、24 个 skill 工作流、15 个自动化 hook（加上涵盖 21 个生命周期事件的可选示例 9 个），以及 9 个规则文件打包为一次安装。把它想象成“Claude Code 的 oh-my-zsh”——它将基础的 Claude Code CLI 变成了一个装备齐全的编码环境，内置了用于规划、TDD、安全审查和部署的工作流。

Claude Forge 与其他 Claude Code 插件有什么不同？

大多数 Claude Code 插件一次只解决一个问题。Claude Forge 是一个**完整的开发环境** —— 11 个代理 (frontmatter v2)、33 个命令、24 个技能、15 个 hook（+9 个示例）和 9 个规则作为一个内聚系统协同工作。您无需组装单独的插件并逐一配置，Claude Forge 为您提供了一条预先连接好的流水线：`/plan` 传递给 `/tdd`，再传递给 `/code-review`，然后传递给 `/handoff-verify`，最后传递给 `/commit-push-pr`。6 层安全 hook 系统也会在无需额外配置的情况下自动运行。

Claude Forge 是否兼容官方的 Claude Code 插件系统？

是的。Claude Forge 通过符号链接安装到 `~/.claude/`，并与官方的 Claude Code 插件并存。您现有的 `settings.local.json` 覆盖设置会被保留，您可以添加或删除单个组件而不会影响系统的其余部分。

如何更新 Claude Forge？

在 claude-forge 目录中运行 `git pull`。因为安装程序使用的是符号链接（在 macOS/Linux 上），所以更新会立即生效 —— 无需重新安装。在 Windows 上，在拉取后重新运行 `install.ps1` 以复制更新的文件。

Claude Forge 可以在 Windows 上运行吗？

可以。在 PowerShell 中以管理员身份运行 `install.ps1`。Windows 使用文件复制而不是符号链接，因此您需要在每次 `git pull` 之后重新运行 `install.ps1` 以应用更新。所有的代理、命令、技能和 hooks 在 Windows、macOS 和 Linux 上的工作方式相同。

/sync 有什么作用？

`/sync` 会同步您项目的记忆和文档。它从远程仓库拉取最新的更改，然后同步所有的项目文档 —— `prompt_plan.md`、`spec.md`、`CLAUDE.md` 和规则文件。在完成任何工作流（功能、错误修复、重构）之后或在新的会话开始时运行它，以确保 Claude 拥有最新的上下文。

Claude Forge 如何处理跨会话的记忆？

Claude Forge 使用 4 层记忆系统： 1. **项目文档** (`CLAUDE.md`, `prompt_plan.md`, `spec.md`) —— 持久保存在仓库中的项目级指令和计划。`/sync` 保持这些内容是最新的。 2. **规则文件** (`rules/`) —— 每次会话自动加载的编码风格、安全性、工作流约定。 3. **MCP memory 服务器** —— 一个跨会话存储实体和关系的持久知识图谱。 4. **代理记忆** (`~/.claude/agent-memory/`) —— 核心代理在每次任务后记录学习经验，通过自我进化随时间改善其建议。 在会话开始时运行 `/sync` 可确保第 1 层和第 2 层是最新的。MCP memory 服务器（第 3 层）和代理记忆（第 4 层）会自动持久化。

## 🤝 贡献 有关添加代理、命令、技能和 hooks 的指南，请参见 [CONTRIBUTING.md](CONTRIBUTING.md)。 ## 使用 Claude Forge？展示它！ ``` [](https://github.com/sangrokjung/claude-forge) ``` 将此徽章添加到您项目的 README 中，让其他人知道您在使用 Claude Forge。 ## 贡献者 ## 📄 许可证 [MIT](LICENSE) —— 使用它，派生它，在它的基础上构建。 如果 Claude Forge 改善了您的工作流，给个 [星标](https://github.com/sangrokjung/claude-forge/stargazers) 也有助于其他人发现它。

_{由 QJC (Quantum Jump Club) 用 ❤️ 制作}

标签：AI 编程, Claude, Claude Code, CLI, CVE检测, DLL 劫持, MITM代理, oh-my-zsh, WiFi技术, 人工智能, 大语言模型, 威胁情报, 安全钩子, 开发工作流, 开发环境, 开发者工具, 开源, 插件框架, 特征检测, 用户模式Hook绕过, 网络调试, 自动化, 防御加固