使用说明
🏗️ 克劳德代理生成器
在Claude Code中将任何想法转化为生产就绪的AI代理
停止从头开始写入代理文件。 描述你的问题→ 自动获取研究、架构、生产就绪的代理、技能、钩子和命令。
问题
克劳德准则中的建筑代理人意味着杂耍 7种不同的图元 （子代理、技能、钩子、命令、MCP服务器、CLAUDE.md、代理SDK），阅读零散的文档，每次从空白Markdown文件开始。
Claude Agent Builder修复了这个问题。 这是一种作为你的个人代理架构师的技能——它采访你，研究已经存在的东西，设计最佳系统，并生成你需要的每个文件。
⚡ 快速开始
macOS/Linux
git clone https://github.com/keysersoose/claude-agent-builder.git && cp -r claude-agent-builder/agent-builder ~/.claude/skills/
Windows（PowerShell）
git clone https://github.com/keysersoose/claude-agent-builder.git; Copy-Item -Recurse claude-agent-builder\agent-builder "$env:USERPROFILE\.claude\skills\agent-builder"
Windows（CMD）
git clone https://github.com/keysersoose/claude-agent-builder.git && xcopy /E /I claude-agent-builder\agent-builder "%USERPROFILE%\.claude\skills\agent-builder"
Other install methods
# macOS/Linux — install script
git clone https://github.com/keysersoose/claude-agent-builder.git
cd claude-agent-builder && ./install.sh
# macOS/Linux — project-level only
./install.sh --project
# Windows — install script (PowerShell)
git clone https://github.com/keysersoose/claude-agent-builder.git
cd claude-agent-builder; .\install.ps1
# Windows — project-level only
.\install.ps1 -Project
# Any platform — project-level manual
git clone https://github.com/keysersoose/claude-agent-builder.git
cp -r claude-agent-builder/agent-builder .claude/skills/
打开克劳德代码并说：
Build me an agent that reviews my PRs for security issues and posts comments on GitHub
该技能会自动触发。就这样
🧠 运作原理
Agent Builder在 6个阶段，根据您提供的上下文进行调整：
🔍 CONTEXT SCAN → Reads your project files + conversation history automatically
📋 DISCOVERY → Only asks what it can't figure out itself
🌐 RESEARCH → Parallel search (GitHub + blogs + docs + community) → consolidated brief
📐 ARCHITECTURE → Proposes agents, gets your explicit approval before building
🔨 BUILD → Writes all agent files directly into your project
✅ VERIFY → Self-checks everything, shows you what was built, asks for final OK
为什么不直接问克劳德？
| 无代理生成器 | 有代理生成器 |
|---|---|
| 你需要知道所有7个图元 | 它会为你挑选合适的图元 |
你从空白处写字 .md files |
它将生产就绪文件直接写入您的项目 |
| 您可以猜测描述和工具 | 它针对自动触发进行了优化 |
| 你从头开始解释你的项目 | 它首先扫描你的代码库和对话历史记录 |
| 你不知道已经存在什么 | 它并行搜索GitHub、博客、文档和社区，然后进行整合 |
| 试错法 | 建议→ 你赞成→ 它构建→ 它验证 |
📦 里面是什么
agent-builder/
├── SKILL.md # Core skill — 6-phase agent building workflow
├── references/
│ ├── primitives-guide.md # Complete guide to all Claude Code building blocks
│ └── agent-patterns.md # 7 battle-tested multi-agent architecture patterns
└── scripts/
├── validate_agents.py # Lint agent files for common issues
└── scaffold_agent.py # Generate starter files from templates
🗺️ 架构模式
技能知道 7种经过验证的模式 并为您的用例选择正确的一个：
| 模式 | 最适合 | 示例 |
|---|---|---|
| 命令→ 代理→ 技能 | 多步流水线 | 全栈功能构建器 |
| 研究→ 巩固→ Plan → 执行 | 行动前的理解 | 代码库迁移 |
| 平行专家 | 独立分析 | 安全+性能+风格审查 |
| 自我进化代理 | 随着时间的推移学习 | 项目入职指南 |
| 钩子守卫特工 | 安全关键工作流程 | 只读数据库分析师 |
| Slash命令+切换 | 快速进入→ 复杂流程 | 漏洞调查 |
| MCP授权代理 | 外部服务集成 | GitHub PR审核机器人 |
🎯 真实世界的例子
公关安全审查员 --带有GitHub MCP、PreToolUse安全挂钩、斜线命令触发器和持久内存的子代理。
研究管道 — /research 命令生成3个并行子代理（web、代码库、堆栈溢出），并输出合成和markdown报告。
自我提升型入职人员 --子代理与 memory: project 通过对话建立机构知识。
看 examples/ 用于完整、即用型配置。
🔧 实用脚本
# Install dependency for validation script
pip install pyyaml
# Validate your agents for common issues
python agent-builder/scripts/validate_agents.py .claude/agents/
# Scaffold new agents from templates
python agent-builder/scripts/scaffold_agent.py my-agent .claude --type subagent
python agent-builder/scripts/scaffold_agent.py deploy-pipe .claude --type full-stack
需求: 克劳德代码 安装。Python 3.7+用于实用程序脚本。
🧩 原始决策树
Your need
├── "Auto-do X when Y happens"
│ ├── During a tool call? → Hook
│ ├── Based on context? → Skill
│ └── Based on task type? → Subagent
├── "Trigger a workflow"
│ ├── Simple command? → Slash command
│ └── Multi-step? → Command + subagents
├── "Connect external services" → MCP server
├── "Remember across conversations" → CLAUDE.md / memory
└── "Production app" → Agent SDK
🤝 贡献
我们欢迎捐款！看 贡献.md.
添加示例·改进模式·提高技能·修复错误·分享反馈
📄 许可证
麻省理工学院——使用它，修改它，分享它。参见 许可证.
如果这为你节省了时间， **给它一颗星**它帮助别人找到它。
