[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-sangrokjung--claude-forge":3,"tool-sangrokjung--claude-forge":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",150037,2,"2026-04-10T23:33:47",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":74,"owner_location":75,"owner_email":74,"owner_twitter":74,"owner_website":76,"owner_url":77,"languages":78,"stars":95,"forks":96,"last_commit_at":97,"license":98,"difficulty_score":32,"env_os":99,"env_gpu":100,"env_ram":100,"env_deps":101,"category_tags":110,"github_topics":111,"view_count":32,"oss_zip_url":74,"oss_zip_packed_at":74,"status":17,"created_at":132,"updated_at":133,"faqs":134,"releases":135},6571,"sangrokjung\u002Fclaude-forge","claude-forge","Supercharge Claude Code with 11 AI agents, 36 commands & 15 skills — the claude-code plugin framework inspired by oh-my-zsh. 6-layer security hooks included. 5-min install.","claude-forge 是一款专为 Claude Code 打造的开源增强框架，旨在将基础的命令行 AI 助手升级为功能完备的开发环境。常被比作\"AI 界的 oh-my-zsh\"，它通过预置的 11 个专用智能体、40 条斜杠命令、15 种技能工作流以及自动化钩子，大幅扩展了原生工具的能力边界。\n\n对于经常使用 Claude Code 进行编程的开发者而言，claude-forge 解决了原生功能较为单一、缺乏标准化工作流的问题。它让用户无需重复配置，即可直接调用复杂任务流程，例如代码重构、测试生成或系统架构分析，从而显著提升开发效率与一致性。此外，其内置的六层安全钩子和“精准修改”原则（仅改动请求内容，避免意外重构），为代码操作提供了可靠的安全保障。\n\n该工具主要面向软件工程师、技术研究人员及高级开发者，特别适合希望深度定制 AI 编码体验、追求高效工作流的极客用户。安装过程十分简便，支持通过插件市场一键部署或从 GitHub 克隆源码，几分钟内即可完成环境搭建。无论是日常编码辅助还是复杂项目维护，claude-forge 都能让 Claude Code 变得更加强大且得心应手。","\u003Cpicture>\n  \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_d68a36d9c6b8.jpg\">\n  \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"docs\u002Fbanner-light.jpg\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_d68a36d9c6b8.jpg\" alt=\"Claude Forge\" width=\"100%\">\n\u003C\u002Fpicture>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>Turn Claude Code into a full development environment\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLICENSE-MIT-blue?style=for-the-badge\" alt=\"MIT License\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fclaude.com\u002Fclaude-code\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCLAUDE_CODE-%E2%89%A51.0-blueviolet?style=for-the-badge\" alt=\"Claude Code\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fstargazers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fsangrokjung\u002Fclaude-forge?style=for-the-badge&color=yellow\" alt=\"Stars\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fnetwork\u002Fmembers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fsangrokjung\u002Fclaude-forge?style=for-the-badge&color=orange\" alt=\"Forks\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fgraphs\u002Fcontributors\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fsangrokjung\u002Fclaude-forge?style=for-the-badge&color=green\" alt=\"Contributors\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fcommits\u002Fmain\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fsangrokjung\u002Fclaude-forge?style=for-the-badge\" alt=\"Last Commit\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#-quick-start\">Quick Start\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-development-workflows\">Workflows\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-whats-inside-claude-forge\">What's Inside\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-claude-forge-installation-guide\">Installation\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-claude-forge-architecture\">Architecture\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-customization\">Customization\u003C\u002Fa> &bull;\n  \u003Ca href=\"README.ko.md\">한국어\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n## What is Claude Forge?\n\nClaude Forge is an open-source development environment for Claude Code that provides 11 specialized agents, 40 slash commands, 15 skill workflows, and 15 automation hooks. Often described as \"oh-my-zsh for Claude Code\", it transforms Claude Code from a basic CLI into a full-featured development environment. One install gives you agents, commands, skills, hooks, and 9 rule files -- all pre-wired and ready to go.\n\n> Think of it as **oh-my-zsh for Claude Code**: the same way oh-my-zsh enhances your terminal, Claude Forge supercharges your AI coding assistant.\n\n---\n\n## ⚡ Quick Start\n\n### Install as Plugin (Recommended)\n\nClaude Forge is available on the **Anthropic Official Plugin Marketplace** and can be installed directly from Claude Code:\n\n```bash\n# Option A: Install from Official Marketplace (after approval)\n\u002Fplugin install claude-forge@claude-plugins-official\n\n# Option B: Install from Claude Forge Marketplace\n\u002Fplugin marketplace add sangrokjung\u002Fclaude-forge\n\u002Fplugin install claude-forge@claude-forge\n\n# Option C: Install directly from GitHub\nclaude plugin install github:sangrokjung\u002Fclaude-forge\n```\n\nTo update:\n```bash\n\u002Fplugin marketplace update claude-forge\n```\n\n> **Note**: Claude Forge has been submitted to the [Anthropic Official Plugin Directory](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-plugins-official) and is pending review. In the meantime, use Option B or C above.\n\n### Install via Git Clone\n\nFor development or customization, clone the repository:\n\n```bash\n# 1. Clone\ngit clone --recurse-submodules https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge.git\ncd claude-forge\n\n# 2. Install (creates symlinks to ~\u002F.claude)\n.\u002Finstall.sh\n\n# 3. Launch Claude Code\nclaude\n```\n\n`install.sh` symlinks everything to `~\u002F.claude\u002F`, so `git pull` updates instantly.\n\n> If you find Claude Forge useful, please consider giving it a [star](https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fstargazers) -- it helps others discover this project.\n\n### What's New in v2.2\n\n| Change | Description |\n|:-------|:------------|\n| **Surgical Changes Principle** | New 12th golden principle: only change what was requested. No drive-by refactoring, style drift, or adjacent \"improvements\". Inspired by [Andrej Karpathy's observations](https:\u002F\u002Fx.com\u002Fkarpathy\u002Fstatus\u002F2015883857489522876) on LLM coding pitfalls. |\n| **State Assumptions Before Coding** | New interaction rule: surface assumptions and present alternatives before implementing ambiguous requirements -- don't guess silently. |\n| **Anti-Rationalization Expansion** | Two new entries block common LLM excuses: \"while I'm here, let me clean up\" and \"need abstraction for extensibility\". |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>v2.1 Changes\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n| Change | Description |\n|:-------|:------------|\n| **Verification Rules** | New `verification.md` rule enforces evidence-based completion -- no claims without fresh test\u002Fbuild output. |\n| **Agent Self-Evolution** | Core 5 agents (planner, architect, code-reviewer, security-reviewer, tdd-guide) now record learnings in `~\u002F.claude\u002Fagent-memory\u002F` after each task. |\n| **Hook Sync** | Added `forge-update-check.sh` (session start update notification) and `observe.sh` (continuous learning observation). |\n\n\u003C\u002Fdetails>\n\n### New here?\n\nIf you're new to development or Claude Code, start with these:\n\n| Step | What to do |\n|:-----|:-----------|\n| 1 | Run `\u002Fguide` after install -- an interactive 3-minute tour |\n| 2 | Read [First Steps](docs\u002FFIRST-STEPS.md) -- glossary + TOP 6 commands |\n| 3 | Browse [Workflow Recipes](docs\u002FWORKFLOW-RECIPES.md) -- 5 copy-paste scenarios |\n\nOr just type `\u002Fauto login page` and let Claude Forge handle the entire plan-to-PR pipeline for you.\n\n---\n\n## 🔄 Development Workflows\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_c407c4380bfb.jpg\" alt=\"Feature Development Workflow\" width=\"720\">\n\u003C\u002Fp>\n\nReal-world workflows that chain commands, agents, and skills together.\n\n### Feature Development\n\nBuild new features with a plan-first, test-first approach:\n\n```\n\u002Fplan → \u002Ftdd → \u002Fcode-review → \u002Fhandoff-verify → \u002Fcommit-push-pr → \u002Fsync\n```\n\n```mermaid\ngraph LR\n    P[\"\u002Fplan\u003Cbr>\u003Csmall>Design & risk analysis\u003C\u002Fsmall>\"] --> T[\"\u002Ftdd\u003Cbr>\u003Csmall>Tests first, then code\u003C\u002Fsmall>\"]\n    T --> CR[\"\u002Fcode-review\u003Cbr>\u003Csmall>Quality & security check\u003C\u002Fsmall>\"]\n    CR --> HV[\"\u002Fhandoff-verify\u003Cbr>\u003Csmall>Fresh-context validation\u003C\u002Fsmall>\"]\n    HV --> CPR[\"\u002Fcommit-push-pr\u003Cbr>\u003Csmall>Commit, push, PR & merge\u003C\u002Fsmall>\"]\n    CPR --> S[\"\u002Fsync\u003Cbr>\u003Csmall>Sync project docs\u003C\u002Fsmall>\"]\n\n    style P fill:#533483,stroke:#fff,color:#fff\n    style T fill:#0f3460,stroke:#fff,color:#fff\n    style CR fill:#0f3460,stroke:#fff,color:#fff\n    style HV fill:#e94560,stroke:#fff,color:#fff\n    style CPR fill:#1a1a2e,stroke:#fff,color:#fff\n    style S fill:#16213e,stroke:#fff,color:#fff\n```\n\n| Step | What happens |\n|:-----|:-------------|\n| `\u002Fplan` | AI creates an implementation plan. Waits for your confirmation before coding. |\n| `\u002Ftdd` | Write tests first, then code. One unit of work at a time. |\n| `\u002Fcode-review` | Security + quality check on the code you just wrote. |\n| `\u002Fhandoff-verify` | Auto-verify build\u002Ftest\u002Flint all at once. |\n| `\u002Fcommit-push-pr` | Commit, push, create PR, and optionally merge -- all in one. |\n| `\u002Fsync` | Sync project docs (prompt_plan.md, spec.md, CLAUDE.md, rules). |\n\n### Bug Fix\n\nFast turnaround for bug fixes with automatic retry:\n\n```\n\u002Fexplore → \u002Ftdd → \u002Fverify-loop → \u002Fquick-commit → \u002Fsync\n```\n\n| Step | What happens |\n|:-----|:-------------|\n| `\u002Fexplore` | Navigate the codebase to find where the bug lives. |\n| `\u002Ftdd` | Write a test that reproduces the bug, then fix it. |\n| `\u002Fverify-loop` | Auto-retry build\u002Flint\u002Ftest up to 3 times with auto-fix on failure. |\n| `\u002Fquick-commit` | Fast commit for simple, well-tested changes. |\n| `\u002Fsync` | Sync project docs after commit. |\n\n### Security Audit\n\nComprehensive security analysis combining CWE and STRIDE:\n\n```\n\u002Fsecurity-review → \u002Fstride-analysis-patterns → \u002Fsecurity-compliance\n```\n\n| Step | What happens |\n|:-----|:-------------|\n| `\u002Fsecurity-review` | CWE Top 25 vulnerability scan + STRIDE threat modeling. |\n| `\u002Fstride-analysis-patterns` | Systematic STRIDE methodology applied to system architecture. |\n| `\u002Fsecurity-compliance` | SOC2, ISO27001, GDPR, HIPAA compliance verification. |\n\n### Team Collaboration\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_4c5129345e80.jpg\" alt=\"Agent Teams Hub-and-Spoke\" width=\"600\">\n\u003C\u002Fp>\n\nParallel multi-agent execution for complex tasks:\n\n```\n\u002Forchestrate → Agent Teams (parallel work) → \u002Fcommit-push-pr\n```\n\n| Step | What happens |\n|:-----|:-------------|\n| `\u002Forchestrate` | Create an Agent Team with file-ownership separation and hub-and-spoke coordination. |\n| Agent Teams | Multiple agents work in parallel on frontend, backend, tests, etc. |\n| `\u002Fcommit-push-pr` | Merge all work, verify, and ship. |\n\n---\n\n## Why Claude Forge?\n\nMost developers either use Claude Code with no customization or spend hours assembling individual configs. Claude Forge gives you a production-ready setup in 5 minutes.\n\n| Feature | Claude Forge | Basic `.claude\u002F` Setup | Individual Plugins |\n|:--------|:------------|:-----------------------|:-------------------|\n| **Agents** | 11 pre-configured (Opus + Sonnet) | Manual setup required | Varies by plugin |\n| **Slash Commands** | 40 ready-to-use | None | Per-plugin basis |\n| **Skill Workflows** | 15 multi-step pipelines | None | Per-plugin basis |\n| **Security** | 6-layer automated hooks | None by default | Per-plugin basis |\n| **Installation** | 5 min, one command | Hours of manual config | Per-plugin install |\n| **Updates** | `git pull` (instant) | Manual per-file | Per-plugin update |\n| **Workflow Integration** | End-to-end pipelines (plan to PR) | Disconnected tools | Not integrated |\n\n---\n\n## 📦 What's Inside Claude Forge\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_6929f0ad93dc.jpg\" alt=\"Claude Forge Components\" width=\"720\">\n\u003C\u002Fp>\n\n| Category | Count | Highlights |\n|:--------:|:-----:|:-----------|\n| **Agents** | 11 | `planner` `architect` `code-reviewer` `security-reviewer` `tdd-guide` `database-reviewer` + 5 more |\n| **Commands** | 40 | `\u002Fcommit-push-pr` `\u002Fhandoff-verify` `\u002Fexplore` `\u002Ftdd` `\u002Fplan` `\u002Forchestrate` `\u002Fsecurity-review` ... |\n| **Skills** | 15 | `build-system` `security-pipeline` `eval-harness` `team-orchestrator` `session-wrap` ... |\n| **Hooks** | 15 | Secret filtering, remote command guard, DB protection, security auto-trigger, rate limiting ... |\n| **Rules** | 9 | `coding-style` `security` `git-workflow` `golden-principles` `agents` `interaction` `verification` ... |\n| **MCP Servers** | 6 | `context7` `memory` `exa` `github` `fetch` `jina-reader` |\n\n---\n\n## 📥 Claude Forge Installation Guide\n\n### Prerequisites\n\n| Dependency | Version | Check |\n|:-----------|:--------|:------|\n| Node.js | v22+ | `node -v` |\n| Git | any | `git --version` |\n| jq | any (macOS\u002FLinux) | `jq --version` |\n| Claude Code CLI | ≥1.0 | `claude --version` |\n\n### macOS \u002F Linux\n\n```bash\ngit clone --recurse-submodules https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge.git\ncd claude-forge\n.\u002Finstall.sh\n```\n\nThe installer:\n1. Checks dependencies (node, git, jq)\n2. Initializes git submodules (CC CHIPS status bar)\n3. Backs up existing `~\u002F.claude\u002F` if present\n4. Creates **symlinks** for 7 directories + `settings.json` to `~\u002F.claude\u002F`\n5. Applies CC CHIPS custom overlay\n6. Optionally installs MCP servers and external skills\n7. Adds shell aliases (`cc` → `claude`, `ccr` → `claude --resume`)\n\nBecause it uses symlinks, `git pull` in the repo updates everything instantly.\n\n### Windows\n\n```powershell\n# Run PowerShell as Administrator\n.\\install.ps1\n```\n\nWindows uses **file copies** instead of symlinks. Re-run `install.ps1` after `git pull` to update.\n\n### MCP Server Setup\n\n| Server | API Key | Setup |\n|:-------|:--------|:------|\n| **context7** | Not required | Auto-installed via `install.sh` |\n| **memory** | Not required | Auto-installed via `install.sh` |\n| **fetch** | Not required | Requires `uvx` (Python) |\n| **jina-reader** | Not required | Auto-installed via `install.sh` |\n| **exa** | OAuth | `claude mcp add exa --url https:\u002F\u002Fmcp.exa.ai\u002Fmcp` |\n| **github** | PAT | Set `GITHUB_PERSONAL_ACCESS_TOKEN` env var |\n\n### Customization\n\nOverride settings without modifying tracked files:\n\n```bash\ncp setup\u002Fsettings.local.template.json ~\u002F.claude\u002Fsettings.local.json\nvim ~\u002F.claude\u002Fsettings.local.json\n```\n\n`settings.local.json` merges on top of `settings.json` automatically.\n\n---\n\n## 🏗 Claude Forge Architecture\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_05e3598ff082.jpg\" alt=\"Symlink Architecture\" width=\"720\">\n\u003C\u002Fp>\n\n```mermaid\ngraph TB\n    subgraph REPO[\"claude-forge (git repo)\"]\n        A[\"agents\u002F (11)\"]\n        C[\"commands\u002F (40)\"]\n        S[\"skills\u002F (15)\"]\n        H[\"hooks\u002F (15)\"]\n        R[\"rules\u002F (9)\"]\n        SC[\"scripts\u002F\"]\n        CC[\"cc-chips\u002F\"]\n        K[\"knowledge\u002F\"]\n        REF[\"reference\u002F\"]\n        SET[\"settings.json\"]\n    end\n\n    INSTALL[\".\u002Finstall.sh\"]\n    REPO --> INSTALL\n\n    subgraph HOME[\"~\u002F.claude\u002F (symlinked)\"]\n        HA[\"agents\u002F\"]\n        HC[\"commands\u002F\"]\n        HS[\"skills\u002F\"]\n        HH[\"hooks\u002F\"]\n        HR[\"rules\u002F\"]\n        HSC[\"scripts\u002F\"]\n        HCC[\"cc-chips\u002F\"]\n        HSET[\"settings.json\"]\n    end\n\n    INSTALL -->|symlink| HOME\n\n    CLAUDE[\"claude (CLI)\"]\n    HOME --> CLAUDE\n\n    style REPO fill:#1a1a2e,stroke:#e94560,color:#fff\n    style HOME fill:#0f3460,stroke:#16213e,color:#fff\n    style INSTALL fill:#e94560,stroke:#fff,color:#fff\n    style CLAUDE fill:#533483,stroke:#fff,color:#fff\n```\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Full Directory Tree\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```\nclaude-forge\u002F\n  ├── agents\u002F               Agent definitions (11 .md files)\n  ├── cc-chips\u002F             Status bar submodule\n  ├── cc-chips-custom\u002F      Custom status bar overlay\n  ├── commands\u002F             Slash commands (32 .md + 8 SKILL dirs)\n  ├── docs\u002F                 Screenshots, diagrams\n  ├── hooks\u002F                Event-driven shell scripts (15)\n  ├── knowledge\u002F            Knowledge base entries\n  ├── reference\u002F            Reference documentation\n  ├── rules\u002F                Auto-loaded rule files (9)\n  ├── scripts\u002F              Utility scripts\n  ├── setup\u002F                Installation guides + templates\n  ├── skills\u002F               Multi-step skill workflows (15)\n  ├── install.sh            macOS\u002FLinux installer (symlinks)\n  ├── install.ps1           Windows installer (copies)\n  ├── mcp-servers.json      MCP server configurations\n  ├── settings.json         Claude Code settings\n  ├── CONTRIBUTING.md       Contribution guide\n  ├── SECURITY.md           Security policy\n  └── LICENSE               MIT License\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 🔀 Agent Router System\n\nThe Agent Router is a **forced delegation system** that ensures specialized agents handle their domain tasks instead of Claude doing everything directly. Without this, Claude defaults to handling all tasks itself -- even when a specialized agent would produce better results.\n\n### How It Works\n\n```mermaid\ngraph LR\n    U[\"User Message\"] --> SP[\"using-superpowers\u003Cbr>\u003Csmall>1% rule: MUST check skills\u003C\u002Fsmall>\"]\n    SP --> AR[\"agent-router\u003Cbr>\u003Csmall>Domain match check\u003C\u002Fsmall>\"]\n    AR -->|\"Match found\"| A[\"Agent Tool\u003Cbr>\u003Csmall>Spawn specialist\u003C\u002Fsmall>\"]\n    AR -->|\"No match\"| D[\"Direct Response\"]\n    A --> R[\"Specialist Result\"]\n\n    style U fill:#1a1a2e,stroke:#fff,color:#fff\n    style SP fill:#e94560,stroke:#fff,color:#fff\n    style AR fill:#533483,stroke:#fff,color:#fff\n    style A fill:#0f3460,stroke:#fff,color:#fff\n    style D fill:#16213e,stroke:#fff,color:#fff\n    style R fill:#0f3460,stroke:#fff,color:#fff\n```\n\n### The Forcing Chain\n\n| Layer | Mechanism | Role |\n|:------|:----------|:-----|\n| **system-reminder** | Lists `agent-router` skill description every turn | Visibility |\n| **using-superpowers** | \"1% chance a skill applies? You MUST invoke it\" | Forcing |\n| **agent-router** | Routing table: keyword → agent mapping | Delegation |\n| **agents-v2.md** | Priority rules and team management | Orchestration |\n\n### Routing Table (33 Agents)\n\n| Domain | Keywords | Agent |\n|:-------|:---------|:------|\n| Planning | implementation plan, complex feature | `planner` |\n| Code Review | code review, review this | `code-reviewer` |\n| Architecture | architecture, tech debt, scalability | `architect` |\n| TDD | test first, TDD, red-green | `tdd-guide` |\n| Legal | contract, NDA, law, court ruling | `contract-legal` |\n| Finance | tax, accounting, VAT, income tax | `financial-accountant` |\n| Patent | patent, invention, trademark, IP | `patent-attorney` |\n| SEO | SEO, GEO, AEO, search ranking | `seo-geo-aeo-strategist` |\n| Strategy | product strategy, business plan, roadmap | `product-strategist` |\n| Copywriting | copy, headline, CTA, ad copy | `copywriting` |\n| Quotation | estimate, quote, pricing | `quotation` |\n| Gov Support | government grant, subsidy, TIPS | `gov-support-strategist` |\n| Ads | ad optimization, ROAS | `ad-optimizer-team` |\n| Growth | marketing strategy, growth | `performance-growth-marketer` |\n| Content | content planning, YouTube | `qjc-content` |\n| CRM | sales, leads, CRM, pipeline | `crm-manager` |\n| Design | UI, UX, landing page, dashboard | `web-designer` |\n| Video | Remotion, video production | `remotion-creator` |\n| Research | research, market analysis | `researcher` |\n| AI Research | AI research, paper survey, SOTA | `ai-researcher` |\n| Storytelling | brand story, narrative, pitch deck | `storyteller` |\n\n> **Team sub-agents** (ad-compass, ad-scout-google, ad-scout-meta, action-architect, folder-hunter, mail-scout) are managed by their parent team agents and are not directly routed.\n\n### Anti-Recursion Guard\n\nBoth `using-superpowers` and `agent-router` include `\u003CSUBAGENT-STOP>` guards to prevent infinite recursion when an agent is already running inside a subagent context.\n\n### Customization\n\nEdit `commands\u002Fagent-router.md` to add your own agents to the routing table:\n\n```markdown\n| my custom keyword | my-custom-agent |\n```\n\nThe router will automatically delegate matching requests to your agent.\n\n---\n\n## 🛡 Claude Code Automation Hooks\n\n### Security Hooks\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_5d80d766f976.jpg\" alt=\"6-Layer Security Defense\" width=\"480\">\n\u003C\u002Fp>\n\n| Hook | Trigger | Protects Against |\n|:-----|:--------|:-----------------|\n| `output-secret-filter.sh` | PostToolUse | Leaked API keys, tokens, passwords in output |\n| `remote-command-guard.sh` | PreToolUse (Bash) | Unsafe remote commands (curl pipe, wget pipe) |\n| `db-guard.sh` | PreToolUse | Destructive SQL (DROP, TRUNCATE, DELETE without WHERE) |\n| `security-auto-trigger.sh` | PostToolUse (Edit\u002FWrite) | Vulnerabilities in code changes |\n| `rate-limiter.sh` | PreToolUse (MCP) | MCP server abuse \u002F excessive calls |\n| `mcp-usage-tracker.sh` | PreToolUse (MCP) | Tracks MCP usage for monitoring |\n\n### Utility Hooks\n\n| Hook | Trigger | Purpose |\n|:-----|:--------|:--------|\n| `code-quality-reminder.sh` | PostToolUse (Edit\u002FWrite) | Reminds about immutability, small files, error handling |\n| `context-sync-suggest.sh` | SessionStart | Suggests syncing docs at session start |\n| `session-wrap-suggest.sh` | Stop | Suggests session wrap-up before ending |\n| `work-tracker-prompt.sh` | UserPromptSubmit | Tracks work for analytics |\n| `work-tracker-tool.sh` | PostToolUse | Tracks tool usage for analytics |\n| `work-tracker-stop.sh` | Stop | Finalizes work tracking data |\n| `task-completed.sh` | TaskCompleted | Notifies on subagent task completion |\n| `expensive-mcp-warning.sh` | - | Warns about costly MCP operations |\n\n---\n\n## 🤖 Claude Code Agents\n\nEach agent has a **color** in the UI for quick visual identification:\n\n### Opus Agents (6) -- Deep analysis & planning\n\n| Agent | Color | Purpose |\n|:------|:-----:|:--------|\n| **planner** | blue | Implementation planning for complex features and refactoring |\n| **architect** | blue | System design, scalability decisions, technical architecture |\n| **code-reviewer** | blue | Quality, security, and maintainability review |\n| **security-reviewer** | red | OWASP Top 10, secrets, SSRF, injection detection |\n| **tdd-guide** | cyan | Test-driven development enforcement (RED → GREEN → IMPROVE) |\n| **database-reviewer** | blue | PostgreSQL\u002FSupabase query optimization, schema design |\n\n### Sonnet Agents (5) -- Fast execution & automation\n\n| Agent | Color | Purpose |\n|:------|:-----:|:--------|\n| **build-error-resolver** | cyan | Fix build\u002FTypeScript errors with minimal diffs |\n| **e2e-runner** | cyan | Generate and run Playwright E2E tests |\n| **refactor-cleaner** | yellow | Dead code cleanup using knip, depcheck, ts-prune |\n| **doc-updater** | yellow | Documentation and codemap updates |\n| **verify-agent** | cyan | Fresh-context build\u002Flint\u002Ftest verification |\n\n### Color Semantics\n\n| Color | Meaning |\n|:------|:--------|\n| **blue** | Analysis & review |\n| **cyan** | Testing & verification |\n| **yellow** | Maintenance & data |\n| **red** | Security & critical |\n| **magenta** | Creative & research |\n| **green** | Business & success |\n\n---\n\n## 📋 All Claude Forge Commands\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>40 Commands (click to expand)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n#### Core Workflow\n\n| Command | Description |\n|:--------|:------------|\n| `\u002Fplan` | AI creates implementation plan. Waits for confirmation before coding. |\n| `\u002Ftdd` | Write tests first, then code. One unit of work at a time. |\n| `\u002Fcode-review` | Security + quality check on code you just wrote. |\n| `\u002Fhandoff-verify` | Auto-verify build\u002Ftest\u002Flint all at once. |\n| `\u002Fcommit-push-pr` | Commit, push, create PR, optionally merge -- all in one. |\n| `\u002Fquick-commit` | Fast commit for simple, well-tested changes. |\n| `\u002Fverify-loop` | Auto-retry build\u002Flint\u002Ftest up to 3x with auto-fix. |\n| `\u002Fauto` | One-button automation: plan to PR without stopping. |\n| `\u002Fguide` | Interactive 3-minute tour for first-time users. |\n\n#### Exploration & Analysis\n\n| Command | Description |\n|:--------|:------------|\n| `\u002Fexplore` | Navigate and analyze codebase structure. |\n| `\u002Fbuild-fix` | Incrementally fix TypeScript and build errors. |\n| `\u002Fnext-task` | Recommend next task based on project state. |\n| `\u002Fsuggest-automation` | Analyze repetitive patterns and suggest automation. |\n\n#### Security\n\n| Command | Description |\n|:--------|:------------|\n| `\u002Fsecurity-review` | CWE Top 25 + STRIDE threat modeling. |\n| `\u002Fstride-analysis-patterns` | Systematic STRIDE methodology for threat identification. |\n| `\u002Fsecurity-compliance` | SOC2, ISO27001, GDPR, HIPAA compliance checks. |\n\n#### Testing & Evaluation\n\n| Command | Description |\n|:--------|:------------|\n| `\u002Fe2e` | Generate and run Playwright end-to-end tests. |\n| `\u002Ftest-coverage` | Analyze coverage gaps and generate missing tests. |\n| `\u002Feval` | Eval-driven development workflow management. |\n| `\u002Fevaluating-code-models` | Benchmark code generation models (HumanEval, MBPP). |\n| `\u002Fevaluating-llms-harness` | Benchmark LLMs across 60+ academic benchmarks. |\n\n#### Documentation & Sync\n\n| Command | Description |\n|:--------|:------------|\n| `\u002Fupdate-codemaps` | Analyze codebase and update architecture docs. |\n| `\u002Fupdate-docs` | Sync documentation from source-of-truth. |\n| `\u002Fsync-docs` | Sync prompt_plan.md, spec.md, CLAUDE.md + rules. |\n| `\u002Fsync` | Pull latest changes and sync all project docs (prompt_plan.md, spec.md, CLAUDE.md, rules). Use after any workflow or at session start. |\n| `\u002Fpull` | Quick `git pull origin main`. |\n\n#### Project Management\n\n| Command | Description |\n|:--------|:------------|\n| `\u002Finit-project` | Scaffold new project with standard structure. |\n| `\u002Forchestrate` | Agent Teams parallel orchestration. |\n| `\u002Fcheckpoint` | Save\u002Frestore work state. |\n| `\u002Flearn` | Record lessons learned + suggest automation. |\n| `\u002Fweb-checklist` | Post-merge web testing checklist. |\n\n#### Refactoring & Debugging\n\n| Command | Description |\n|:--------|:------------|\n| `\u002Frefactor-clean` | Identify and remove dead code with test verification. |\n| `\u002Fdebugging-strategies` | Systematic debugging techniques and profiling. |\n| `\u002Fdependency-upgrade` | Major dependency upgrades with compatibility analysis. |\n| `\u002Fextract-errors` | Extract and catalog error messages. |\n\n#### Git Worktree\n\n| Command | Description |\n|:--------|:------------|\n| `\u002Fworktree-start` | Create git worktree for parallel development. |\n| `\u002Fworktree-cleanup` | Clean up worktrees after PR completion. |\n\n#### Utilities\n\n| Command | Description |\n|:--------|:------------|\n| `\u002Fsummarize` | Summarize URLs, podcasts, transcripts, local files. |\n\n\u003C\u002Fdetails>\n\n---\n\n## 🧩 All Claude Forge Skills\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>15 Skills (click to expand)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n| Skill | Description |\n|:------|:------------|\n| **build-system** | Auto-detect and run project build systems. |\n| **cache-components** | Next.js Cache Components and Partial Prerendering (PPR) guidance. |\n| **cc-dev-agent** | Claude Code development workflow optimization (context engineering, sub-agents, TDD). |\n| **continuous-learning-v2** | Instinct-based learning: observe sessions via hooks, create atomic instincts with confidence scoring. |\n| **eval-harness** | Formal evaluation framework for eval-driven development (EDD). |\n| **frontend-code-review** | Frontend file review (.tsx, .ts, .js) with checklist rules. |\n| **manage-skills** | Analyze session changes, detect missing verification skills, create\u002Fupdate skills. |\n| **prompts-chat** | Skill\u002Fprompt exploration, search, and improvement. |\n| **security-pipeline** | CWE Top 25 + STRIDE automated security verification pipeline. |\n| **session-wrap** | End-of-session cleanup: 4 parallel subagents detect docs, patterns, learnings, follow-ups. |\n| **skill-factory** | Convert reusable session patterns into Claude Code skills automatically. |\n| **strategic-compact** | Suggest manual context compaction at logical intervals to preserve context. |\n| **team-orchestrator** | Agent Teams engine: team composition, task distribution, dependency management. |\n| **verification-engine** | Integrated verification engine: fresh-context subagent verification loop. |\n| **verify-implementation** | Run all project verify skills and generate unified pattern verification report. |\n\n\u003C\u002Fdetails>\n\n---\n\n## Frequently Asked Questions\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>What is Claude Forge?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nClaude Forge is an open-source development environment for Claude Code. It bundles 11 specialized agents, 40 slash commands, 15 skill workflows, 15 automation hooks, and 9 rule files into a single install. Think of it as \"oh-my-zsh for Claude Code\" -- it turns the basic Claude Code CLI into a fully equipped coding environment with built-in workflows for planning, TDD, security review, and deployment.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>How is Claude Forge different from other Claude Code plugins?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nMost Claude Code plugins solve one problem at a time. Claude Forge is a **complete development environment** -- 11 agents, 40 commands, 15 skills, 15 hooks, and 9 rules that work together as a cohesive system. Instead of assembling individual plugins and configuring each one, Claude Forge gives you a pre-wired pipeline: `\u002Fplan` feeds into `\u002Ftdd`, which feeds into `\u002Fcode-review`, which feeds into `\u002Fhandoff-verify`, which feeds into `\u002Fcommit-push-pr`. The 6-layer security hook system also runs automatically without extra configuration.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Is Claude Forge compatible with the official Claude Code plugin system?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nYes. Claude Forge installs via symlinks to `~\u002F.claude\u002F` and works alongside official Claude Code plugins. Your existing `settings.local.json` overrides are preserved, and you can add or remove individual components without affecting the rest of the system.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>How do I update Claude Forge?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nRun `git pull` in the claude-forge directory. Because the installer uses symlinks (on macOS\u002FLinux), updates take effect immediately -- no re-install needed. On Windows, re-run `install.ps1` after pulling to copy the updated files.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Does Claude Forge work on Windows?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nYes. Run `install.ps1` in PowerShell as Administrator. Windows uses file copies instead of symlinks, so you need to re-run `install.ps1` after each `git pull` to apply updates. All agents, commands, skills, and hooks work the same on Windows, macOS, and Linux.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>What does \u002Fsync do?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n`\u002Fsync` synchronizes your project's memory and documentation. It pulls the latest changes from the remote repository and then syncs all project docs -- `prompt_plan.md`, `spec.md`, `CLAUDE.md`, and rule files. Run it after completing any workflow (feature, bug fix, refactor) or at the start of a new session to ensure Claude has the latest context.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>How does Claude Forge handle memory across sessions?\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nClaude Forge uses a 4-layer memory system:\n\n1. **Project docs** (`CLAUDE.md`, `prompt_plan.md`, `spec.md`) -- Project-level instructions and plans that persist in the repository. `\u002Fsync` keeps these up to date.\n2. **Rule files** (`rules\u002F`) -- Coding style, security, workflow conventions loaded automatically each session.\n3. **MCP memory server** -- A persistent knowledge graph that stores entities and relations across sessions.\n4. **Agent memory** (`~\u002F.claude\u002Fagent-memory\u002F`) -- Core agents record learnings after each task, improving their recommendations over time through Self-Evolution.\n\nRunning `\u002Fsync` at session start ensures layers 1 and 2 are current. The MCP memory server (layer 3) and agent memory (layer 4) persist automatically.\n\n\u003C\u002Fdetails>\n\n---\n\n## 🤝 Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding agents, commands, skills, and hooks.\n\n---\n\n---\n\n## Use Claude Forge? Show it!\n\n```markdown\n[![Built with Claude Forge](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBuilt_with-Claude_Forge-orange?style=flat-square)](https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge)\n```\n\nAdd this badge to your project's README to let others know you use Claude Forge.\n\n---\n\n## Contributors\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_f5e25509321f.png\" \u002F>\n\u003C\u002Fa>\n\n---\n\n## 📄 License\n\n[MIT](LICENSE) -- use it, fork it, build on it.\n\nIf Claude Forge improved your workflow, a [star](https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fstargazers) helps others find it too.\n\n---\n\n\u003Cp align=\"center\">\n  \u003Csub>Made with ❤️ by \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\">QJC (Quantum Jump Club)\u003C\u002Fa>\u003C\u002Fsub>\n\u003C\u002Fp>\n","\u003Cpicture>\n  \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_d68a36d9c6b8.jpg\">\n  \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"docs\u002Fbanner-light.jpg\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_d68a36d9c6b8.jpg\" alt=\"Claude Forge\" width=\"100%\">\n\u003C\u002Fpicture>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>将 Claude Code 转变为完整的开发环境\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLICENSE-MIT-blue?style=for-the-badge\" alt=\"MIT License\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fclaude.com\u002Fclaude-code\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCLAUDE_CODE-%E2%89%A51.0-blueviolet?style=for-the-badge\" alt=\"Claude Code\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fstargazers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fsangrokjung\u002Fclaude-forge?style=for-the-badge&color=yellow\" alt=\"星标数\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fnetwork\u002Fmembers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fsangrokjung\u002Fclaude-forge?style=for-the-badge&color=orange\" alt=\"复刻数\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fgraphs\u002Fcontributors\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fsangrokjung\u002Fclaude-forge?style=for-the-badge&color=green\" alt=\"贡献者数\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fcommits\u002Fmain\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fsangrokjung\u002Fclaude-forge?style=for-the-badge\" alt=\"最近一次提交\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#-quick-start\">快速入门\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-development-workflows\">开发工作流\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-whats-inside-claude-forge\">Claude Forge 包含什么\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-claude-forge-installation-guide\">安装指南\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-claude-forge-architecture\">架构\u003C\u002Fa> &bull;\n  \u003Ca href=\"#-customization\">自定义\u003C\u002Fa> &bull;\n  \u003Ca href=\"README.ko.md\">韩语\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n## Claude Forge 是什么？\n\nClaude Forge 是一个面向 Claude Code 的开源开发环境，提供了 11 个专用代理、40 条斜杠命令、15 种技能工作流以及 15 个自动化钩子。它常被形容为“Claude Code 的 oh-my-zsh”，能够将 Claude Code 从一个基础的命令行界面转变为功能齐全的开发环境。只需一次安装，你就能获得代理、命令、技能、钩子以及 9 个规则文件——全部预先配置好，开箱即用。\n\n> 可以把它想象成 **Claude Code 的 oh-my-zsh**：就像 oh-my-zsh 能够增强你的终端体验一样，Claude Forge 也能大幅提升你的 AI 编程助手的功能。\n\n---\n\n## ⚡ 快速入门\n\n### 作为插件安装（推荐）\n\nClaude Forge 已在 **Anthropic 官方插件市场** 上架，可以直接从 Claude Code 中安装：\n\n```bash\n# 方案 A：从官方市场安装（待审核通过后）\n\u002Fplugin install claude-forge@claude-plugins-official\n\n# 方案 B：从 Claude Forge 市场安装\n\u002Fplugin marketplace add sangrokjung\u002Fclaude-forge\n\u002Fplugin install claude-forge@claude-forge\n\n# 方案 C：直接从 GitHub 安装\nclaude plugin install github:sangrokjung\u002Fclaude-forge\n```\n\n更新时：\n```bash\n\u002Fplugin marketplace update claude-forge\n```\n\n> **注意**：Claude Forge 已提交至 [Anthropic 官方插件目录](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-plugins-official)，目前正处于审核中。在此期间，请使用上述方案 B 或 C。\n\n### 通过 Git 克隆安装\n\n若需进行开发或自定义，可克隆仓库：\n\n```bash\n# 1. 克隆\ngit clone --recurse-submodules https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge.git\ncd claude-forge\n\n# 2. 安装（创建到 ~\u002F.claude 的符号链接）\n.\u002Finstall.sh\n\n# 3. 启动 Claude Code\nclaude\n```\n\n`install.sh` 会将所有内容符号链接到 `~\u002F.claude\u002F` 目录下，因此执行 `git pull` 即可即时更新。\n\n> 如果你觉得 Claude Forge 很有用，请考虑给它点个 [星标](https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fstargazers)——这有助于更多人发现这个项目。\n\n### v2.2 新增内容\n\n| 变更 | 描述 |\n|:-------|:------------|\n| **手术式变更原则** | 新增第 12 条黄金原则：仅修改请求的内容，不进行随意重构、风格调整或无关的“改进”。灵感来源于 Andrej Karpathy 关于 LLM 编码陷阱的观察 ([x.com\u002Fkarpathy\u002Fstatus\u002F2015883857489522876](https:\u002F\u002Fx.com\u002Fkarpathy\u002Fstatus\u002F2015883857489522876))。 |\n| **编码前的状态假设** | 新交互规则：在实现模糊需求之前，先明确假设并提出替代方案——不要默默猜测。 |\n| **反合理化扩展** | 新增两条规则，用于阻止常见的 LLM 借口：“既然在这里，就顺便清理一下”和“为了可扩展性需要抽象”。 |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>v2.1 变更\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n| 变更 | 描述 |\n|:-------|:------------|\n| **验证规则** | 新增 `verification.md` 规则，强制基于证据完成任务——没有新的测试或构建输出，不得声称已完成。 |\n| **代理自我进化** | 核心 5 个代理（规划者、架构师、代码审查员、安全审查员、TDD 指南）现在会在每次任务完成后，将学习成果记录到 `~\u002F.claude\u002Fagent-memory\u002F` 目录中。 |\n| **钩子同步** | 新增 `forge-update-check.sh`（会话启动时的更新通知）和 `observe.sh`（持续学习观察）。 |\n\n\u003C\u002Fdetails>\n\n### 刚接触 Claude Forge？\n\n如果你是开发新手或刚接触 Claude Code，可以从以下步骤开始：\n\n| 步骤 | 操作 |\n|:-----|:-----------|\n| 1 | 安装后运行 `\u002Fguide`——一个互动式的 3 分钟导览 |\n| 2 | 阅读 [第一步](docs\u002FFIRST-STEPS.md)——术语表 + TOP 6 命令 |\n| 3 | 浏览 [工作流配方](docs\u002FWORKFLOW-RECIPES.md)——5 个可直接复制粘贴的场景 |\n\n或者直接输入 `\u002Fauto login page`，让 Claude Forge 为你处理从计划到 PR 提交的完整流程。\n\n---\n\n## 🔄 开发工作流\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_c407c4380bfb.jpg\" alt=\"功能开发工作流\" width=\"720\">\n\u003C\u002Fp>\n\n将命令、代理和技能串联起来的真实世界工作流。\n\n### 功能开发\n\n采用先规划、再测试的方法构建新功能：\n\n```\n\u002Fplan → \u002Ftdd → \u002Fcode-review → \u002Fhandoff-verify → \u002Fcommit-push-pr → \u002Fsync\n```\n\n```mermaid\ngraph LR\n    P[\"\u002Fplan\u003Cbr>\u003Csmall>设计与风险分析\u003C\u002Fsmall>\"] --> T[\"\u002Ftdd\u003Cbr>\u003Csmall>先写测试，再写代码\u003C\u002Fsmall>\"]\n    T --> CR[\"\u002Fcode-review\u003Cbr>\u003Csmall>质量与安全检查\u003C\u002Fsmall>\"]\n    CR --> HV[\"\u002Fhandoff-verify\u003Cbr>\u003Csmall>全新上下文验证\u003C\u002Fsmall>\"]\n    HV --> CPR[\"\u002Fcommit-push-pr\u003Cbr>\u003Csmall>提交、推送、创建PR并合并\u003C\u002Fsmall>\"]\n    CPR --> S[\"\u002Fsync\u003Cbr>\u003Csmall>同步项目文档\u003C\u002Fsmall>\"]\n\n    style P fill:#533483,stroke:#fff,color:#fff\n    style T fill:#0f3460,stroke:#fff,color:#fff\n    style CR fill:#0f3460,stroke:#fff,color:#fff\n    style HV fill:#e94560,stroke:#fff,color:#fff\n    style CPR fill:#1a1a2e,stroke:#fff,color:#fff\n    style S fill:#16213e,stroke:#fff,color:#fff\n```\n\n| 步骤 | 发生什么 |\n|:-----|:-------------|\n| `\u002Fplan` | AI生成实现计划。在开始编码前等待您的确认。 |\n| `\u002Ftdd` | 先编写测试，再编写代码。一次完成一个工作单元。 |\n| `\u002Fcode-review` | 对您刚刚编写的代码进行安全和质量检查。 |\n| `\u002Fhandoff-verify` | 自动验证构建、测试和代码风格检查。 |\n| `\u002Fcommit-push-pr` | 提交、推送、创建拉取请求，并可选择直接合并——全部一步完成。 |\n| `\u002Fsync` | 同步项目文档（prompt_plan.md、spec.md、CLAUDE.md、rules）。 |\n\n### Bug修复\n\n通过自动重试实现快速的Bug修复流程：\n\n```\n\u002Fexplore → \u002Ftdd → \u002Fverify-loop → \u002Fquick-commit → \u002Fsync\n```\n\n| 步骤 | 发生什么 |\n|:-----|:-------------|\n| `\u002Fexplore` | 导航代码库以找到Bug所在的位置。 |\n| `\u002Ftdd` | 编写能够复现Bug的测试用例，然后修复Bug。 |\n| `\u002Fverify-loop` | 自动重试构建、代码风格检查和测试，失败时自动修复，最多重试3次。 |\n| `\u002Fquick-commit` | 对简单且经过充分测试的更改进行快速提交。 |\n| `\u002Fsync` | 提交后同步项目文档。 |\n\n### 安全审计\n\n结合CWE和STRIDE进行全面的安全分析：\n\n```\n\u002Fsecurity-review → \u002Fstride-analysis-patterns → \u002Fsecurity-compliance\n```\n\n| 步骤 | 发生什么 |\n|:-----|:-------------|\n| `\u002Fsecurity-review` | 执行CWE Top 25漏洞扫描以及STRIDE威胁建模。 |\n| `\u002Fstride-analysis-patterns` | 将系统的STRIDE方法论应用于系统架构。 |\n| `\u002Fsecurity-compliance` | 验证SOC2、ISO27001、GDPR、HIPAA等合规性要求。 |\n\n### 团队协作\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_4c5129345e80.jpg\" alt=\"Agent Teams Hub-and-Spoke\" width=\"600\">\n\u003C\u002Fp>\n\n针对复杂任务的多代理并行执行：\n\n```\n\u002Forchestrate → Agent Teams (并行工作) → \u002Fcommit-push-pr\n```\n\n| 步骤 | 发生什么 |\n|:-----|:-------------|\n| `\u002Forchestrate` | 创建一个文件所有权分离、采用中心辐射式协调的Agent团队。 |\n| Agent Teams | 多个代理并行处理前端、后端、测试等工作。 |\n| `\u002Fcommit-push-pr` | 合并所有工作成果，验证并通过后发布。 |\n\n---\n\n## 为什么选择Claude Forge？\n\n大多数开发者要么不加任何定制就使用Claude Code，要么花费数小时手动配置各个插件。而Claude Forge只需5分钟即可为您提供生产就绪的环境。\n\n| 特性 | Claude Forge | 基本`.claude\u002F`设置 | 单独插件 |\n|:--------|:------------|:-----------------------|:-------------------|\n| **代理** | 11个预配置（Opus + Sonnet） | 需手动设置 | 因插件而异 |\n| **斜杠命令** | 40个即用型 | 无 | 每个插件单独提供 |\n| **技能工作流** | 15个多步骤流水线 | 无 | 每个插件单独提供 |\n| **安全** | 6层自动化钩子 | 默认无 | 每个插件单独提供 |\n| **安装** | 5分钟，一条命令 | 数小时的手动配置 | 每个插件单独安装 |\n| **更新** | `git pull`（即时） | 需逐文件手动更新 | 每个插件单独更新 |\n| **工作流集成** | 端到端流水线（从计划到PR） | 工具之间互不相连 | 未集成 |\n\n---\n\n## 📦 Claude Forge包含哪些内容？\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_6929f0ad93dc.jpg\" alt=\"Claude Forge组件\" width=\"720\">\n\u003C\u002Fp>\n\n| 类别 | 数量 | 亮点 |\n|:--------:|:-----:|:-----------|\n| **代理** | 11 | `planner` `architect` `code-reviewer` `security-reviewer` `tdd-guide` `database-reviewer` 等 |\n| **命令** | 40 | `\u002Fcommit-push-pr` `\u002Fhandoff-verify` `\u002Fexplore` `\u002Ftdd` `\u002Fplan` `\u002Forchestrate` `\u002Fsecurity-review` 等 |\n| **技能** | 15 | `build-system` `security-pipeline` `eval-harness` `team-orchestrator` `session-wrap` 等 |\n| **钩子** | 15 | 秘密过滤、远程命令防护、数据库保护、安全自动触发、速率限制等 |\n| **规则** | 9 | `coding-style` `security` `git-workflow` `golden-principles` `agents` `interaction` `verification` 等 |\n| **MCP服务器** | 6 | `context7` `memory` `exa` `github` `fetch` `jina-reader` |\n\n---\n\n## 📥 Claude Forge安装指南\n\n### 前置条件\n\n| 依赖项 | 版本 | 检查 |\n|:-----------|:--------|:------|\n| Node.js | v22+ | `node -v` |\n| Git | 任意版本 | `git --version` |\n| jq | 任意版本（macOS\u002FLinux） | `jq --version` |\n| Claude Code CLI | ≥1.0 | `claude --version` |\n\n### macOS \u002F Linux\n\n```bash\ngit clone --recurse-submodules https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge.git\ncd claude-forge\n.\u002Finstall.sh\n```\n\n安装程序：\n1. 检查依赖项（Node.js、Git、jq）\n2. 初始化Git子模块（CC CHIPS状态栏）\n3. 如果存在，则备份现有的`~\u002F.claude\u002F`\n4. 为7个目录及`settings.json`创建指向`~\u002F.claude\u002F`的符号链接\n5. 应用CC CHIPS自定义覆盖层\n6. 可选地安装MCP服务器和外部技能\n7. 添加Shell别名（`cc` → `claude`，`ccr` → `claude --resume`）\n\n由于使用符号链接，因此在仓库中执行`git pull`即可立即更新所有内容。\n\n### Windows\n\n```powershell\n# 以管理员身份运行PowerShell\n.\\install.ps1\n```\n\nWindows使用**文件副本**而非符号链接。在执行`git pull`后，请重新运行`install.ps1`以更新。\n\n### MCP服务器设置\n\n| 服务器 | API密钥 | 设置 |\n|:-------|:--------|:------|\n| **context7** | 不需要 | 通过`install.sh`自动安装 |\n| **memory** | 不需要 | 通过`install.sh`自动安装 |\n| **fetch** | 不需要 | 需要`uvx`（Python） |\n| **jina-reader** | 不需要 | 通过`install.sh`自动安装 |\n| **exa** | OAuth | `claude mcp add exa --url https:\u002F\u002Fmcp.exa.ai\u002Fmcp` |\n| **github** | PAT | 设置`GITHUB_PERSONAL_ACCESS_TOKEN`环境变量 |\n\n### 自定义\n\n无需修改受版本控制的文件即可覆盖设置：\n\n```bash\ncp setup\u002Fsettings.local.template.json ~\u002F.claude\u002Fsettings.local.json\nvim ~\u002F.claude\u002Fsettings.local.json\n```\n\n`settings.local.json`会自动与`settings.json`合并。\n\n---\n\n## 🏗 Claude Forge 架构\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_05e3598ff082.jpg\" alt=\"符号链接架构\" width=\"720\">\n\u003C\u002Fp>\n\n```mermaid\ngraph TB\n    subgraph REPO[\"claude-forge (git 仓库)\"]\n        A[\"agents\u002F (11)\"]\n        C[\"commands\u002F (40)\"]\n        S[\"skills\u002F (15)\"]\n        H[\"hooks\u002F (15)\"]\n        R[\"rules\u002F (9)\"]\n        SC[\"scripts\u002F\"]\n        CC[\"cc-chips\u002F\"]\n        K[\"knowledge\u002F\"]\n        REF[\"reference\u002F\"]\n        SET[\"settings.json\"]\n    end\n\n    INSTALL[\".\u002Finstall.sh\"]\n    REPO --> INSTALL\n\n    subgraph HOME[\"~\u002F.claude\u002F (符号链接)\"]\n        HA[\"agents\u002F\"]\n        HC[\"commands\u002F\"]\n        HS[\"skills\u002F\"]\n        HH[\"hooks\u002F\"]\n        HR[\"rules\u002F\"]\n        HSC[\"scripts\u002F\"]\n        HCC[\"cc-chips\u002F\"]\n        HSET[\"settings.json\"]\n    end\n\n    INSTALL -->|符号链接| HOME\n\n    CLAUDE[\"claude (CLI)\"]\n    HOME --> CLAUDE\n\n    style REPO fill:#1a1a2e,stroke:#e94560,color:#fff\n    style HOME fill:#0f3460,stroke:#16213e,color:#fff\n    style INSTALL fill:#e94560,stroke:#fff,color:#fff\n    style CLAUDE fill:#533483,stroke:#fff,color:#fff\n```\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>完整目录结构\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```\nclaude-forge\u002F\n  ├── agents\u002F               代理定义 (11 个 .md 文件)\n  ├── cc-chips\u002F             状态栏子模块\n  ├── cc-chips-custom\u002F      自定义状态栏叠加层\n  ├── commands\u002F             斜杠命令 (32 个 .md + 8 个技能目录)\n  ├── docs\u002F                 截图、示意图\n  ├── hooks\u002F                事件驱动的 Shell 脚本 (15 个)\n  ├── knowledge\u002F            知识库条目\n  ├── reference\u002F            参考文档\n  ├── rules\u002F                自动加载的规则文件 (9 个)\n  ├── scripts\u002F              实用脚本\n  ├── setup\u002F                安装指南 + 模板\n  ├── skills\u002F               多步骤技能流程 (15 个)\n  ├── install.sh            macOS\u002FLinux 安装程序 (符号链接)\n  ├── install.ps1           Windows 安装程序 (复制)\n  ├── mcp-servers.json      MCP 服务器配置\n  ├── settings.json         Claude Code 设置\n  ├── CONTRIBUTING.md       贡献指南\n  ├── SECURITY.md           安全策略\n  └── LICENSE               MIT 许可证\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 🔀 代理路由系统\n\n代理路由是一个**强制委托系统**，它确保由专门的代理处理其领域的任务，而不是让 Claude 直接处理所有事情。如果没有这个系统，Claude 默认会自行处理所有任务——即使有专门的代理能够产生更好的结果。\n\n### 工作原理\n\n```mermaid\ngraph LR\n    U[\"用户消息\"] --> SP[\"using-superpowers\u003Cbr>\u003Csmall>1% 规则：必须检查技能\u003C\u002Fsmall>\"]\n    SP --> AR[\"agent-router\u003Cbr>\u003Csmall>领域匹配检查\u003C\u002Fsmall>\"]\n    AR -->|\"匹配找到\"| A[\"Agent Tool\u003Cbr>\u003Csmall>启动专家代理\u003C\u002Fsmall>\"]\n    AR -->|\"未匹配\"| D[\"直接响应\"]\n    A --> R[\"专家代理结果\"]\n\n    style U fill:#1a1a2e,stroke:#fff,color:#fff\n    style SP fill:#e94560,stroke:#fff,color:#fff\n    style AR fill:#533483,stroke:#fff,color:#fff\n    style A fill:#0f3460,stroke:#fff,color:#fff\n    style D fill:#16213e,stroke:#fff,color:#fff\n    style R fill:#0f3460,stroke:#fff,color:#fff\n```\n\n### 强制链条\n\n| 层级 | 机制 | 作用 |\n|:------|:----------|:-----|\n| **system-reminder** | 每轮列出 `agent-router` 技能描述 | 提高可见性 |\n| **using-superpowers** | “1% 的几率适用某项技能？你必须调用它” | 强制执行 |\n| **agent-router** | 路由表：关键词 → 代理映射 | 委托任务 |\n| **agents-v2.md** | 优先级规则和团队管理 | 协调调度 |\n\n### 路由表（33 个代理）\n\n| 领域 | 关键词 | 代理 |\n|:-------|:---------|:------|\n| 规划 | 实施计划、复杂功能 | `planner` |\n| 代码审查 | 代码审查、评审 | `code-reviewer` |\n| 架构 | 架构、技术债务、可扩展性 | `architect` |\n| TDD | 先写测试、TDD、红绿灯 | `tdd-guide` |\n| 法律 | 合同、保密协议、法律、法院判决 | `contract-legal` |\n| 金融 | 税务、会计、增值税、所得税 | `financial-accountant` |\n| 专利 | 专利、发明、商标、知识产权 | `patent-attorney` |\n| SEO | SEO、GEO、AEO、搜索排名 | `seo-geo-aeo-strategist` |\n| 战略 | 产品战略、商业计划、路线图 | `product-strategist` |\n| 文案写作 | 文案、标题、CTA、广告文案 | `copywriting` |\n| 报价 | 估算、报价、定价 | `quotation` |\n| 政府支持 | 政府拨款、补贴、TIPS | `gov-support-strategist` |\n| 广告 | 广告优化、ROAS | `ad-optimizer-team` |\n| 增长 | 营销策略、增长 | `performance-growth-marketer` |\n| 内容 | 内容策划、YouTube | `qjc-content` |\n| CRM | 销售、潜在客户、CRM、销售管道 | `crm-manager` |\n| 设计 | UI、UX、着陆页、仪表盘 | `web-designer` |\n| 视频 | Remotion、视频制作 | `remotion-creator` |\n| 研究 | 研究、市场分析 | `researcher` |\n| AI 研究 | AI 研究、论文综述、SOTA | `ai-researcher` |\n| 故事讲述 | 品牌故事、叙事、演示文稿 | `storyteller` |\n\n> **团队子代理**（ad-compass、ad-scout-google、ad-scout-meta、action-architect、folder-hunter、mail-scout）由其父团队代理管理，不会直接被路由。\n\n### 防止递归保护\n\n`using-superpowers` 和 `agent-router` 都包含 `\u003CSUBAGENT-STOP>` 保护措施，以防止在代理已经运行于子代理上下文中时发生无限递归。\n\n### 自定义\n\n编辑 `commands\u002Fagent-router.md`，将您自己的代理添加到路由表中：\n\n```markdown\n| 我的自定义关键词 | 我的自定义代理 |\n```\n\n路由器会自动将匹配的请求委派给您的代理。\n\n---\n\n## 🛡 Claude Code 自动化钩子\n\n### 安全钩子\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_5d80d766f976.jpg\" alt=\"六层安全防御\" width=\"480\">\n\u003C\u002Fp>\n\n| 钩子 | 触发条件 | 防护内容 |\n|:-----|:--------|:-----------------|\n| `output-secret-filter.sh` | 工具使用后 | 防止 API 密钥、令牌、密码等敏感信息泄露 |\n| `remote-command-guard.sh` | 工具使用前 (Bash) | 防止不安全的远程命令（curl 管道、wget 管道） |\n| `db-guard.sh` | 工具使用前 | 防止破坏性 SQL（DROP、TRUNCATE、DELETE without WHERE） |\n| `security-auto-trigger.sh` | 工具使用后 (编辑\u002F写入) | 检测代码变更中的漏洞 |\n| `rate-limiter.sh` | 工具使用前 (MCP) | 防止滥用 MCP 服务器或过度调用 |\n| `mcp-usage-tracker.sh` | 工具使用前 (MCP) | 跟踪 MCP 使用情况以便监控 |\n\n### 实用钩子\n\n| 钩子 | 触发条件 | 用途 |\n|:-----|:--------|:--------|\n| `code-quality-reminder.sh` | PostToolUse（编辑\u002F编写） | 提醒代码的不可变性、文件大小以及错误处理 |\n| `context-sync-suggest.sh` | SessionStart | 建议在会话开始时同步文档 |\n| `session-wrap-suggest.sh` | Stop | 建议在结束会话前进行收尾工作 |\n| `work-tracker-prompt.sh` | UserPromptSubmit | 跟踪工作以用于分析 |\n| `work-tracker-tool.sh` | PostToolUse | 跟踪工具使用情况以用于分析 |\n| `work-tracker-stop.sh` | Stop | 完成工作跟踪数据的最终记录 |\n| `task-completed.sh` | TaskCompleted | 通知子代理任务已完成 |\n| `expensive-mcp-warning.sh` | - | 警告昂贵的 MCP 操作 |\n\n---\n\n## 🤖 Claude 代码代理\n\n每个代理在 UI 中都有一个 **颜色**，以便快速视觉识别：\n\n### Opus 代理（6 个）——深度分析与规划\n\n| 代理 | 颜色 | 用途 |\n|:------|:-----:|:--------|\n| **planner** | 蓝色 | 复杂功能和重构的实现规划 |\n| **architect** | 蓝色 | 系统设计、可扩展性决策和技术架构 |\n| **code-reviewer** | 蓝色 | 质量、安全性和可维护性审查 |\n| **security-reviewer** | 红色 | OWASP Top 10、机密信息、SSRF 和注入检测 |\n| **tdd-guide** | 青色 | 测试驱动开发的执行（RED → GREEN → IMPROVE） |\n| **database-reviewer** | 蓝色 | PostgreSQL\u002FSupabase 查询优化和模式设计 |\n\n### Sonnet 代理（5 个）——快速执行与自动化\n\n| 代理 | 颜色 | 用途 |\n|:------|:-----:|:--------|\n| **build-error-resolver** | 青色 | 使用最小差异修复构建\u002FTypeScript 错误 |\n| **e2e-runner** | 青色 | 生成并运行 Playwright 端到端测试 |\n| **refactor-cleaner** | 黄色 | 使用 knip、depcheck 和 ts-prune 清理无用代码 |\n| **doc-updater** | 黄色 | 文档和代码地图更新 |\n| **verify-agent** | 青色 | 新上下文构建\u002F lint\u002F测试验证 |\n\n### 颜色语义\n\n| 颜色 | 含义 |\n|:------|:--------|\n| **蓝色** | 分析与审查 |\n| **青色** | 测试与验证 |\n| **黄色** | 维护与数据 |\n| **红色** | 安全与关键 |\n| **洋红** | 创意与研究 |\n| **绿色** | 商业与成功 |\n\n---\n\n## 📋 所有 Claude Forge 命令\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>40 个命令（点击展开）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n#### 核心工作流程\n\n| 命令 | 描述 |\n|:--------|:------------|\n| `\u002Fplan` | AI 创建实施计划。等待确认后再进行编码。 |\n| `\u002Ftdd` | 先写测试，再写代码。一次完成一项工作。 |\n| `\u002Fcode-review` | 对您刚刚编写的代码进行安全和质量检查。 |\n| `\u002Fhandoff-verify` | 自动一次性验证构建\u002F lint\u002F测试。 |\n| `\u002Fcommit-push-pr` | 一次完成提交、推送、创建 PR，可选合并。 |\n| `\u002Fquick-commit` | 适用于简单且经过充分测试的更改的快速提交。 |\n| `\u002Fverify-loop` | 自动重试构建\u002F lint\u002F测试最多 3 次，并自动修复。 |\n| `\u002Fauto` | 一键自动化：从计划到 PR，无需中断。 |\n| `\u002Fguide` | 针对首次使用的用户提供的互动式 3 分钟导览。 |\n\n#### 探索与分析\n\n| 命令 | 描述 |\n|:--------|:------------|\n| `\u002Fexplore` | 导航并分析代码库结构。 |\n| `\u002Fbuild-fix` | 逐步修复 TypeScript 和构建错误。 |\n| `\u002Fnext-task` | 根据项目状态推荐下一个任务。 |\n| `\u002Fsuggest-automation` | 分析重复性模式并建议自动化。 |\n\n#### 安全\n\n| 命令 | 描述 |\n|:--------|:------------|\n| `\u002Fsecurity-review` | CWE Top 25 + STRIDE 威胁建模。 |\n| `\u002Fstride-analysis-patterns` | 系统化的 STRIDE 方法论用于威胁识别。 |\n| `\u002Fsecurity-compliance` | SOC2、ISO27001、GDPR、HIPAA 合规检查。 |\n\n#### 测试与评估\n\n| 命令 | 描述 |\n|:--------|:------------|\n| `\u002Fe2e` | 生成并运行 Playwright 端到端测试。 |\n| `\u002Ftest-coverage` | 分析覆盖率缺口并生成缺失的测试。 |\n| `\u002Feval` | 基于评估的开发工作流管理。 |\n| `\u002Fevaluating-code-models` | 代码生成模型基准测试（HumanEval、MBPP）。 |\n| `\u002Fevaluating-llms-harness` | 在 60 多项学术基准测试中对 LLM 进行基准测试。 |\n\n#### 文档与同步\n\n| 命令 | 描述 |\n|:--------|:------------|\n| `\u002Fupdate-codemaps` | 分析代码库并更新架构文档。 |\n| `\u002Fupdate-docs` | 从源文档同步文档。 |\n| `\u002Fsync-docs` | 同步 prompt_plan.md、spec.md、CLAUDE.md 和规则。 |\n| `\u002Fsync` | 拉取最新更改并同步所有项目文档（prompt_plan.md、spec.md、CLAUDE.md、规则）。在任何工作流程之后或会话开始时使用。 |\n| `\u002Fpull` | 快速执行 `git pull origin main`。 |\n\n#### 项目管理\n\n| 命令 | 描述 |\n|:--------|:------------|\n| `\u002Finit-project` | 使用标准结构搭建新项目。 |\n| `\u002Forchestrate` | 并行协调代理团队。 |\n| `\u002Fcheckpoint` | 保存\u002F恢复工作状态。 |\n| `\u002Flearn` | 记录经验教训并建议自动化。 |\n| `\u002Fweb-checklist` | 合并后 Web 测试检查清单。 |\n\n#### 重构与调试\n\n| 命令 | 描述 |\n|:--------|:------------|\n| `\u002Frefactor-clean` | 识别并移除无用代码，同时进行测试验证。 |\n| `\u002Fdebugging-strategies` | 系统化的调试技术和性能分析。 |\n| `\u002Fdependency-upgrade` | 进行主要依赖项升级，并分析兼容性。 |\n| `\u002Fextract-errors` | 提取并编目错误信息。 |\n\n#### Git 工作树\n\n| 命令 | 描述 |\n|:--------|:------------|\n| `\u002Fworktree-start` | 为并行开发创建 Git 工作树。 |\n| `\u002Fworktree-cleanup` | 在 PR 完成后清理工作树。 |\n\n#### 实用工具\n\n| 命令 | 描述 |\n|:--------|:------------|\n| `\u002Fsummarize` | 总结 URL、播客、文字稿和本地文件。 |\n\n\u003C\u002Fdetails>\n\n---\n\n## 🧩 所有 Claude Forge 技能\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>15 项技能（点击展开）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n| 技能 | 描述 |\n|:------|:------------|\n| **build-system** | 自动检测并运行项目构建系统。 |\n| **cache-components** | Next.js 缓存组件与部分预渲染 (PPR) 指导。 |\n| **cc-dev-agent** | Claude Code 开发工作流优化（上下文工程、子代理、TDD）。 |\n| **continuous-learning-v2** | 基于本能的学习：通过钩子观察会话，创建带有置信度评分的原子本能。 |\n| **eval-harness** | 面向评估驱动开发 (EDD) 的正式评估框架。 |\n| **frontend-code-review** | 前端文件审查（.tsx、.ts、.js），附带检查清单规则。 |\n| **manage-skills** | 分析会话变化，检测缺失的验证技能，创建\u002F更新技能。 |\n| **prompts-chat** | 技能\u002F提示探索、搜索与改进。 |\n| **security-pipeline** | CWE 前 25 名 + STRIDE 自动化安全验证流水线。 |\n| **session-wrap** | 会话结束清理：4 个并行子代理分别检测文档、模式、学习内容及后续跟进事项。 |\n| **skill-factory** | 将可重用的会话模式自动转换为 Claude Code 技能。 |\n| **strategic-compact** | 在逻辑间隔处建议手动压缩上下文，以保持上下文完整性。 |\n| **team-orchestrator** | 代理团队引擎：团队构成、任务分配、依赖管理。 |\n| **verification-engine** | 集成式验证引擎：全新上下文子代理验证循环。 |\n| **verify-implementation** | 运行所有项目验证技能，并生成统一的模式验证报告。 |\n\n\u003C\u002Fdetails>\n\n---\n\n## 常见问题解答\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Forge 是什么？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nClaude Forge 是一个面向 Claude Code 的开源开发环境。它将 11 个专用代理、40 条斜杠命令、15 个工作流技能、15 个自动化钩子以及 9 个规则文件整合到一个单一的安装包中。可以把它想象成“Claude Code 版的 oh-my-zsh”——它将基础的 Claude Code CLI 转变为一个功能齐全的编码环境，内置用于规划、TDD、安全审查和部署的工作流程。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Forge 与其他 Claude Code 插件有何不同？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n大多数 Claude Code 插件一次只解决一个问题。而 Claude Forge 则是一个**完整的开发环境**——包含 11 个代理、40 条命令、15 项技能、15 个钩子和 9 个规则，它们作为一个 cohesive 系统协同工作。你无需单独组装各个插件并逐一配置，Claude Forge 已经为你搭建好了一条预设的流水线：`\u002Fplan` 输入到 `\u002Ftdd`，再输入到 `\u002Fcode-review`，接着进入 `\u002Fhandoff-verify`，最后到达 `\u002Fcommit-push-pr`。此外，6 层安全钩子系统也会自动运行，无需额外配置。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Forge 是否兼容官方的 Claude Code 插件系统？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n是的。Claude Forge 通过符号链接安装到 `~\u002F.claude\u002F` 目录下，能够与官方 Claude Code 插件共存。你现有的 `settings.local.json` 覆盖设置将被保留，你可以添加或移除单个组件，而不会影响整个系统的其他部分。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>如何更新 Claude Forge？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n在 claude-forge 目录下运行 `git pull`。由于安装程序使用符号链接（在 macOS\u002FLinux 上），更新会立即生效——无需重新安装。而在 Windows 上，拉取代码后需要重新运行 `install.ps1` 来复制更新后的文件。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Forge 是否适用于 Windows？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n是的。以管理员身份在 PowerShell 中运行 `install.ps1`。Windows 使用文件拷贝而非符号链接，因此每次执行 `git pull` 后都需要重新运行 `install.ps1` 来应用更新。所有代理、命令、技能和钩子在 Windows、macOS 和 Linux 上的功能完全相同。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>\u002Fsync 命令的作用是什么？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n`\u002Fsync` 会同步你的项目内存和文档。它会从远程仓库拉取最新更改，然后同步所有项目文档——`prompt_plan.md`、`spec.md`、`CLAUDE.md` 以及规则文件。在完成任何工作流程（功能开发、Bug 修复、重构）后，或在新会话开始时运行此命令，以确保 Claude 具备最新的上下文信息。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Forge 如何跨会话管理记忆？\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nClaude Forge 使用 4 层记忆系统：\n\n1. **项目文档**（`CLAUDE.md`、`prompt_plan.md`、`spec.md`）——项目级别的指令和计划，持久保存在仓库中。`\u002Fsync` 会保持这些文档的最新状态。\n2. **规则文件**（`rules\u002F`）——编码风格、安全规范、工作流程约定，每次会话都会自动加载。\n3. **MCP 记忆服务器**——一个持久化的知识图谱，用于存储跨会话的实体和关系。\n4. **代理记忆**（`~\u002F.claude\u002Fagent-memory\u002F`）——核心代理会在每次任务后记录学习内容，通过自我进化不断提升其推荐质量。\n\n在会话开始时运行 `\u002Fsync` 可确保第 1 层和第 2 层处于最新状态。而 MCP 记忆服务器（第 3 层）和代理记忆（第 4 层）则会自动持续存在。\n\n\u003C\u002Fdetails>\n\n---\n\n## 🤝 贡献\n\n请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)，了解如何添加代理、命令、技能和钩子的指南。\n\n---\n\n---\n\n## 使用 Claude Forge？展示一下吧！\n\n```markdown\n[![由 Claude Forge 构建](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBuilt_with-Claude_Forge-orange?style=flat-square)](https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge)\n```\n\n将此徽章添加到你的项目 README 中，让其他人知道你正在使用 Claude Forge。\n\n---\n\n## 贡献者\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_readme_f5e25509321f.png\" \u002F>\n\u003C\u002Fa>\n\n---\n\n## 📄 许可证\n\n[MIT](LICENSE)——你可以自由使用、分叉或在此基础上进行开发。\n\n如果 Claude Forge 改善了你的工作流程，给它一颗星（[star](https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fstargazers)）可以帮助更多人发现它。\n\n---\n\n\u003Cp align=\"center\">\n  \u003Csub>由 \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsangrokjung\">QJC（量子跃迁俱乐部）\u003C\u002Fa> 用心打造\u003C\u002Fsub>\n\u003C\u002Fp>","# Claude Forge 快速上手指南\n\nClaude Forge 是一个专为 **Claude Code** 打造的开源开发环境增强工具。它被誉为\"Claude Code 的 oh-my-zsh\"，通过预置的 11 个智能体（Agents）、40 个斜杠命令、15 个技能工作流和自动化钩子，将基础的 CLI 升级为全功能的生产级开发环境。\n\n## 1. 环境准备\n\n在开始之前，请确保您的系统满足以下要求：\n\n| 依赖项 | 版本要求 | 验证命令 |\n| :--- | :--- | :--- |\n| **Node.js** | v22+ | `node -v` |\n| **Git** | 任意版本 | `git --version` |\n| **jq** | 任意版本 (macOS\u002FLinux) | `jq --version` |\n| **Claude Code CLI** | ≥1.0 | `claude --version` |\n\n> **注意**：如果您尚未安装 Claude Code CLI，请先前往官方渠道完成安装。\n\n## 2. 安装步骤\n\n您可以选择以下两种方式之一进行安装。推荐使用 **插件方式**（最简单），若需深度定制或开发则使用 **Git 克隆方式**。\n\n### 方式 A：作为插件安装（推荐）\n\n直接在 Claude Code 中运行以下命令即可安装。由于官方市场审核可能需要时间，建议优先使用 GitHub 源安装：\n\n```bash\n# 直接从 GitHub 安装（最快生效）\nclaude plugin install github:sangrokjung\u002Fclaude-forge\n```\n\n*更新插件命令：*\n```bash\n\u002Fplugin marketplace update claude-forge\n```\n\n### 方式 B：通过 Git 克隆安装（适合开发者）\n\n此方式通过软链接将配置映射到本地，便于通过 `git pull` 实时更新。\n\n**macOS \u002F Linux:**\n```bash\n# 1. 克隆仓库（包含子模块）\ngit clone --recurse-submodules https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge.git\ncd claude-forge\n\n# 2. 运行安装脚本（自动创建 ~\u002F.claude 的软链接）\n.\u002Finstall.sh\n\n# 3. 启动 Claude Code\nclaude\n```\n\n**Windows (PowerShell):**\n```powershell\n# 以管理员身份运行 PowerShell\n.\\install.ps1\n```\n*注意：Windows 版本使用文件复制而非软链接，更新时需重新运行 `install.ps1`。*\n\n## 3. 基本使用\n\n安装完成后，重启终端或运行 `claude` 进入交互界面。\n\n### 🚀 新手入门\n输入以下命令开启交互式引导（约 3 分钟）：\n```text\n\u002Fguide\n```\n\n### ⚡ 核心工作流示例\n\nClaude Forge 的核心优势在于将复杂的开发流程简化为单个命令。\n\n**场景 1：从零开发一个新功能 (Plan-to-PR)**\n只需一条命令，AI 将自动执行规划、测试驱动开发 (TDD)、代码审查、验证并提交 PR：\n```text\n\u002Fauto login page\n```\n*(上述命令将自动处理从需求分析到生成 Pull Request 的全流程)*\n\n**场景 2：手动分步执行标准开发流**\n如果您希望控制每个环节，可以按顺序执行：\n```text\n\u002Fplan              # 生成实施计划并等待确认\n\u002Ftdd               # 先写测试，再写代码\n\u002Fcode-review       # 进行质量和安全检查\n\u002Fhandoff-verify    # 自动验证构建、测试和 lint\n\u002Fcommit-push-pr    # 提交、推送并创建 PR\n```\n\n**场景 3：快速修复 Bug**\n```text\n\u002Fexplore           # 定位 bug 位置\n\u002Ftdd               # 编写复现测试并修复\n\u002Fverify-loop       # 自动重试构建\u002F测试（最多 3 次）\n\u002Fquick-commit      # 快速提交修复\n```\n\n### 💡 常用命令速查\n- `\u002Forchestrate`: 启动多智能体并行协作模式。\n- `\u002Fsecurity-review`: 执行 CWE 和 STRIDE 安全审计。\n- `\u002Fsync`: 同步项目文档（如 prompt_plan.md, CLAUDE.md 等）。\n\n现在，您已拥有了一套生产级的 AI 开发环境，可以尝试输入 `\u002Fauto \u003C您的任务>` 开始体验了。","某全栈开发者正接手一个遗留的 Node.js 微服务项目，需要在两天内完成代码重构、安全漏洞修复并补充单元测试，同时确保不引入新的回归错误。\n\n### 没有 claude-forge 时\n- **指令重复繁琐**：每次让 Claude Code 执行任务，都要手动输入冗长的上下文约束（如“只修改请求的文件”、“先运行测试”），否则 AI 容易过度重构或遗漏步骤。\n- **缺乏专业分工**：面对复杂需求，只能依赖单个通用对话窗口，AI 在编写业务逻辑、审查安全和生成测试之间频繁切换，导致思路混乱且产出质量不稳定。\n- **安全隐患难控**：在执行涉及文件写入或系统命令的操作时，缺乏自动化的前置检查机制，必须人工逐行审查代码，极易因疏忽导致生产环境事故。\n- **工作流断裂**：从代码分析到最终提交，需要手动复制粘贴多次中间结果，无法形成自动化的闭环，严重拖慢开发节奏。\n\n### 使用 claude-forge 后\n- **一键调用专家智能体**：直接通过 `\u002Fagent security` 或 `\u002Fagent test` 等命令召唤专属 AI 代理，它们内置了特定领域的最佳实践，无需重复交代背景即可高质量完成任务。\n- **标准化技能工作流**：利用预置的 15 种技能（Skills），如“安全修复工作流”，自动串联起“扫描漏洞 -> 生成补丁 -> 运行测试 -> 验证结果”的全流程，确保操作规范统一。\n- **六层安全钩子防护**：依托内置的 6-layer security hooks，在执行任何危险命令或文件修改前自动拦截并二次确认，将“手术式修改”原则固化到系统底层，杜绝意外破坏。\n- **命令效率倍增**：通过 36 个快捷斜杠命令（如 `\u002Frefactor`, `\u002Fexplain`），将原本需要多轮对话才能厘清的任务简化为单条指令，大幅缩短从想法到落地的时间。\n\nclaude-forge 将原本松散的 AI 对话升级为企业级的自动化开发环境，让开发者从“提示词工程师”回归到真正的架构决策者。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsangrokjung_claude-forge_6929f0ad.jpg","sangrokjung","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fsangrokjung_9eb5dff8.jpg",null,"seoul","https:\u002F\u002Fcruella-de-vil.tistory.com\u002F","https:\u002F\u002Fgithub.com\u002Fsangrokjung",[79,83,87,91],{"name":80,"color":81,"percentage":82},"Shell","#89e051",46.7,{"name":84,"color":85,"percentage":86},"Python","#3572A5",42,{"name":88,"color":89,"percentage":90},"PowerShell","#012456",10.3,{"name":92,"color":93,"percentage":94},"Go Template","#00ADD8",1,645,144,"2026-04-09T15:23:41","MIT","Linux, macOS, Windows","未说明",{"notes":102,"python":103,"dependencies":104},"该工具是 Claude Code 的插件\u002F开发环境增强工具，而非本地运行的 AI 模型，因此无需 GPU 或大内存。安装脚本在 macOS\u002FLinux 上使用符号链接，在 Windows 上使用文件复制。部分功能（如 exa、github）需要配置 API Key 或个人访问令牌。","未说明 (依赖项 fetch 需要 uvx\u002FPython，但未指定具体版本)",[105,106,107,108,109],"Node.js v22+","Git","jq","Claude Code CLI ≥1.0","uvx (用于 fetch MCP 服务器)",[14,52,13,35],[112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131],"agents","ai-assistant","anthropic","automation","claude-code","developer-tools","dotfiles","llm","macos","productivity","ai-coding","ai-framework","ai-pair-programming","claude-code-agents","cli-tools","developer-experience","hooks","shell","slash-commands","workflow","2026-03-27T02:49:30.150509","2026-04-11T17:40:52.699731",[],[136],{"id":137,"version":138,"summary_zh":139,"released_at":140},206247,"v1.0.0","# 克劳德锻造 v1.0.0\n\n**适用于 Claude Code 的 oh-my-zsh** — 将 Claude Code 转变为一个完整的开发环境。\n\n## 包含内容\n\n| 类别       | 数量 | 详情                                   |\n|------------|:----:|----------------------------------------|\n| **智能体** | 11  | 6 个 Opus（规划者、架构师、代码评审员、安全评审员、TDD 指导员、数据库评审员）+ 5 个 Sonnet（构建错误解决者、端到端测试运行者、重构清理者、文档更新者、验证代理） |\n| **斜杠命令** | 36  | \u002Fplan、\u002Ftdd、\u002Fcode-review、\u002Fcommit-push-pr、\u002Forchestrate、\u002Fsecurity-review 等 30 多条命令 |\n| **技能工作流** | 15  | 构建系统、安全流水线、评估框架、团队协调器、会话封装等 10 多个工作流 |\n| **自动化钩子** | 14  | 6 个安全钩子（秘密过滤器、远程命令防护、数据库防护、安全自动触发器、速率限制器、MCP 追踪器）+ 8 个实用工具钩子 |\n| **规则文件** | 8   | 代码风格、安全规范、Git 工作流程、黄金原则、智能体配置、交互规则等 |\n| **MCP 服务器** | 6   | context7、memory、exa、github、fetch、jina-reader |\n\n## 平台支持\n\n- macOS（通过 `install.sh` 创建符号链接）\n- Linux（通过 `install.sh` 创建符号链接）\n- WSL（自动检测跨文件系统问题，必要时使用副本）\n- Windows（通过 `install.ps1` 复制文件）\n\n## 开发工作流\n\n为常见开发任务预配置的工作流：\n\n- **功能开发**：`\u002Fplan` → `\u002Ftdd` → `\u002Fcode-review` → `\u002Fhandoff-verify` → `\u002Fcommit-push-pr`\n- **Bug 修复**：`\u002Fexplore` → `\u002Ftdd` → `\u002Fverify-loop` → `\u002Fquick-commit`\n- **安全审计**：`\u002Fsecurity-review` → `\u002Fstride-analysis-patterns` → `\u002Fsecurity-compliance`\n- **团队协作**：`\u002Forchestrate` → 智能体团队（并行执行）→ `\u002Fcommit-push-pr`\n\n## 快速开始\n\n```bash\ngit clone --recurse-submodules https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge.git\ncd claude-forge\n.\u002Finstall.sh\nclaude\n```\n\n## 文档\n\n- [英文 README](https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge#readme)\n- [韩文 README](https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fblob\u002Fmain\u002FREADME.ko.md)\n- [贡献指南](https:\u002F\u002Fgithub.com\u002Fsangrokjung\u002Fclaude-forge\u002Fblob\u002Fmain\u002FCONTRIBUTING.md)\n\n---\n\n由 [QJC（量子跃迁俱乐部）](https:\u002F\u002Fgithub.com\u002Fsangrokjung) 用心打造 ❤️","2026-02-24T00:55:39"]