agent-creator

Agent Creator 可搭建完整的 Claude Code 专家 Agent：包括 frontmatter（name、description、model、tools、skills、hooks）、必需的 Agent Workflow 部分、钩子脚本和 marketplace 注册。它涵盖三种流程——创建全新的领域／框架专家、将现有 Agent 改编为适用于新技术栈，以及更新 Agent 的技能或钩子——每种流程最后都会通过 `fuse-ai-pilot:sniper` 进行验证。

它不会创建 Agent 引用的技能——如需创建技能，请使用 skill-creator；agent-creator 只会围绕已有技能或与 Agent 一同创建的技能，配置 Agent 的 frontmatter 和工作流。

Agent Creator

Agent 工作流（必需）

创建任何 Agent 之前，都必须通过 Agent 委派任务——并行启动 2 个 Agent（在同一条消息中调用 2 次 Agent）。生成的 Agent 会在其工具中包含 Agent 和 SendMessage，因此它们在内部也必须使用相同的模式：

1. fuse-ai-pilot:explore-codebase - 检查现有 Agent，分析其模式
2. fuse-ai-pilot:research-expert - 获取最新的 Agent 约定

mcp__context7__query-docs 是直接的 MCP 调用，不是启动的 Agent——直接调用它（与 2 个 Task 调用同时进行），以获取现有 Agent 的示例。

创建后，运行 fuse-ai-pilot:sniper 进行验证。

---

概述

操作	使用场景
新建 Agent	需要新的领域／框架专家
改编	从相似的 Agent 复制（Next.js → React）
更新	添加技能、修改钩子

---

关键规则

1. 所有内容均使用英文 - 不得使用法语或其他语言
2. Frontmatter 必须完整 - 包含 name、description、model、tools、skills、hooks
3. Agent Workflow 部分 - 始终作为第一个内容部分
4. SOLID 规则引用 - 链接到 solid-[stack] 技能
5. 在 marketplace.json 中注册 - 否则 Agent 将无法加载
6. 钩子脚本必须可执行 - chmod +x
7. 必须包含 Output Format 部分 - 每个生成的 Agent 都必须定义标准的 ## Output Format 部分（status、files_changed、errors、sources）——由 lead 调用的 Agent 必须返回结构化数据，而不是散文

---

架构

plugins/<plugin-name>/
├── agents/
│   └── <agent-name>.md      # Agent definition
├── skills/
│   ├── skill-a/
│   └── solid-[stack]/
├── scripts/
│   └── validate-*.sh        # Hook scripts
└── .claude-plugin/
    └── plugin.json

→ 详情请参阅 architecture.md

---

参考指南

概念

主题	参考资料	何时查阅
架构	architecture.md	了解 Agent 结构
Frontmatter	frontmatter.md	YAML 配置
必需部分	required-sections.md	必需内容
钩子	hooks.md	工具调用前／后的验证
注册	registration.md	marketplace.json

模板

模板	使用场景
agent-template.md	创建新 Agent
hook-scripts.md	验证脚本

---

快速参考

新建 Agent

# 1. Research existing agents
→ explore-codebase + research-expert

# 2. Create files
touch plugins/<plugin>/agents/<agent-name>.md
touch plugins/<plugin>/scripts/validate-<stack>-solid.sh
chmod +x plugins/<plugin>/scripts/*.sh

# 3. Register in marketplace.json

# 4. Validate
→ sniper

改编现有 Agent

# 1. Copy similar agent
cp plugins/nextjs-expert/agents/nextjs-expert.md plugins/new-plugin/agents/new-expert.md

# 2. Adapt with sed
sed -i '' "s/nextjs/newstack/g; s/Next\.js/NewStack/g" agents/new-expert.md

# 3. Update skills, tools, register

---

验证清单

• 所有内容均使用英文
• Frontmatter 完整（name、description、model、tools、skills）
• 包含 Agent Workflow 部分
• 包含必需的 Skills Usage 表格
• 包含指向 solid-[stack] 的 SOLID 规则引用
• Local Documentation 路径有效
• 包含 Output Format 部分（status、files_changed、errors、sources）
• 钩子脚本可执行
• 已在 marketplace.json 中注册

---

相关内容：Skill Creator

创建 Agent 时，通常也需要创建技能。

使用 /fuse-ai-pilot:skill-creator 为 Agent 创建技能：

场景	操作
新 Agent 需要技能	先使用 skill-creator 创建技能
Agent 引用了技能	确保技能存在于 skills/ 中
改编 Agent	同时改编相关技能

---

最佳实践

应该做

• 使用 skill-creator 创建相关技能
• 参考 solid-[stack] 技能了解 SOLID 规则
• 为 UI Agent 添加 Gemini Design 部分
• 确保钩子脚本可执行

不应该做

• 用法语编写（仅限英语）
• 跳过 Agent Workflow 部分
• 忘记注册到市场
• 创建不包含其技能的 Agent
• 在钩子中硬编码路径（使用 $CLAUDE_PLUGIN_ROOT）