mcpField
S
spawn

spawn

github.com/0xdarkmatterAgent 工作流7858 次安装2 周前更新
代码仓库

关于 spawn

spawn 是用于 Claude Code 的 Agent 提示词生成技能，可根据技术名称、技术列表或架构描述生成内容。它规定了文件格式、保存范围和详细的提示词结构。

主要功能

  1. 01生成单个或多个 Agent 提示词
  2. 02根据架构描述推荐 Agent
  3. 03创建含 YAML frontmatter 的 Markdown 文件
  4. 04选择项目级或全局保存范围
  5. 05按十部分模板组织提示词

适用场景

  1. 01创建特定领域的 Claude Code Agent
  2. 02为技术栈生成 Agent 提示词
  3. 03准备项目级或用户级 Agent 文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/0xdarkmatter/claude-mods --skill spawn

安装后在 Claude Code 中输入/spawn确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
.gitkeep
references/
.gitkeep
scripts/
.gitkeep

详细介绍

Spawn - 专家 Agent 生成器

为 Claude Code 生成世界级、全面的专家 Agent 提示词。每个 Agent 都应成为其领域的权威参考，达到博士级从业者编写指南的水准。

目标质量： 每个 Agent 包含 500-1000 行，提供真实代码示例、完整配置和详细模式。

基准 Agent： firecrawl-expert.md（1026 行）、project-organizer.md（610 行）

使用模式

模式 1：生成单个 Agent

为特定技术平台生成一份专家 Agent 提示词。

提供：

  • 技术平台／框架名称
  • 范围（项目级或全局／用户级）
  • 重点领域（可选：特定功能、模式、用例）
  • 输出格式（Markdown 文件或可直接复制到剪贴板的文本）
模式 2：批量生成 Agent

根据技术平台列表创建多份 Agent 提示词。

提供：

  • 多行技术平台列表
  • 范围（项目级或全局／用户级）
  • 共同的重点领域（可选）
  • 输出格式（单独的 .md 文件或合并文本）
模式 3：架构分析

分析技术栈或架构描述，并推荐相关 Agent。

流程：

  1. 阅读架构描述（来自用户输入或文件）
  2. 识别所有技术平台／服务
  3. 询问范围（项目级或全局）
  4. 提供复选框，让用户选择要创建的 Agent
  5. 生成选中的 Agent

Agent 文件格式

所有 Agent 必须创建为带有 YAML 前置内容的 Markdown 文件：

  • 项目级：.claude/agents/（仅限当前项目）
  • 全局／用户级：~/.claude/agents/ 或 C:\Users\[username]\.claude\agents\（适用于所有项目）

文件结构：

---
name: technology-name-expert
description: When this agent should be used. Can include examples and use cases. No strict length limit - be clear and specific. Include "use PROACTIVELY" for automatic invocation.
model: inherit
color: blue
---

[Agent system prompt content here]

YAML 前置内容字段：

  • name（必需）：唯一标识符，使用小写字母并以连字符分隔（例如 "redis-expert"）
  • description（必需）：清晰、具体地说明何时使用此 Agent
    • 没有严格的长度限制——清晰优先于简洁
    • 可以包含示例、用例和上下文
    • 使用 “use PROACTIVELY” 或 “MUST BE USED”，以鼓励自动调用
    • 描述较长时，可以使用多行 YAML 字符串格式
  • tools（可选）：允许使用的工具列表，以逗号分隔（例如 "Read, Grep, Glob, Bash"）
    • 如果省略，Agent 将继承主会话中的所有工具
    • 最佳实践：仅授予 Agent 实现其用途所需的工具（提升安全性并使其更专注）
  • model（可选）：指定模型（"sonnet"、"opus"、"haiku"，或使用 "inherit" 继承主会话的模型）
  • color（可选）：UI 中的视觉标识（"blue"、"green"、"purple" 等）

创建文件： 可以使用 Write 工具以编程方式创建 Agent：

Project-level: .claude/agents/[platform]-expert.md
Global/User-level: ~/.claude/agents/[platform]-expert.md (or C:\Users\[username]\.claude\agents\ on Windows)

选择范围：

  • 项目 Agent（.claude/agents/）：仅适用于当前项目，可纳入版本控制并与团队共享
  • 全局 Agent（~/.claude/agents/）：在你机器上的所有项目中均可用

创建后，Claude Code 会在几秒内加载该文件，随后即可通过 Agent 工具使用此 Agent（在 Claude Code 2.1.63 之前名为 Task；Task(...) 仍可用作别名）。唯一例外是：如果 agents/ 目录在会话启动时尚不存在，那么该目录中的第一个 Agent 需要重启会话才能加载。

Claude Code Agent 文档

必读内容：

文档中的关键概念：

  • 子 Agent 在独立的上下文窗口中运行，并使用自定义系统提示词
  • 每个子 Agent 都可以限制工具访问权限，以实现专注的功能
  • 多个子 Agent 可以并行运行，实现并行处理
  • 用户级 Agent（~/.claude/agents/）可用于所有项目
  • 项目级 Agent（.claude/agents/）专用于特定项目，且可共享
  • 建议使用 /agents 命令提供的界面管理 Agent
  • 先从 Claude 生成的 Agent 开始，再进行自定义以获得最佳效果
  • 对项目级子 Agent 进行版本控制，以便团队协作

生成要求

对于每个 Agent，请创建一份全面的专家提示词，包含：

Agent 内容结构（10 部分模板）：

每个生成的 Agent 都必须遵循以下全面的 10 部分结构：

  1. 第 1 部分：核心概念 - 基本原理、思维模型、架构概览
  2. 第 2 部分：基本模式（5-10 种模式）- 每种模式包括：适用场景、完整实现（20-50 行）、变体、常见错误
  3. 第 3 部分：高级技巧（3-5 种技巧）- 深入讲解并提供完整示例
  4. 第 4 部分：配置 - 完整的开发环境配置、完整的生产环境配置、环境变量表格
  5. 第 5 部分：集成模式 - 与 2-3 种常见技术的集成代码
  6. 第 6 部分：测试策略 - 使用模拟对象的单元测试、集成测试、测试配置
  7. 第 7 部分：错误处理 - 自定义异常层次结构、重试/断路器模式、结构化日志记录
  8. 第 8 部分：性能优化 - 性能分析技巧、优化表格、缓存策略
  9. 第 9 部分：安全注意事项 - 常见漏洞、安全加固清单
  10. 第 10 部分：快速参考 - 常见操作速查表（20-30 个代码片段）、CLI 命令、故障排除表格

此外还需包括：质量检查清单、反模式（5-10 个，附错误/正确代码）、权威资源（10-15 个 URL）

参考 agents/ 中的 firecrawl-expert.md 和 project-organizer.md 实现。

要求：

  • 顶部使用 YAML frontmatter，并包含必需字段（name、description）
  • 系统提示词简洁且可执行（不冗长）
  • 至少包含 10 个官方或权威 URL
  • 包含真实、可用于生产环境的代码示例（10 个以上代码块）
  • 包含完整的配置文件（开发环境 + 生产环境）
  • 包含带有实际测试代码的测试模式
  • 聚焦于模式、最佳实践和架构
  • 包含用于深入学习的权威参考资料
  • 使用 Markdown 格式，可直接使用
  • 如有助于清晰表达，description 字段可以较长，并包含示例

输出选项

让用户选择范围：

  1. 项目 Agent - 保存到 .claude/agents/（仅适用于当前项目，由版本控制）
  2. 全局 Agent - 保存到 ~/.claude/agents/ 或 C:\Users\[username]\.claude\agents\（适用于所有项目）

让用户选择格式：

  1. 可直接复制 - 在代码块中输出完整的 Markdown（包含 YAML frontmatter）
  2. 创建文件 - 使用 Write 工具，根据范围将文件保存到相应的 agents 目录
  3. 两者都要 - 使用 Write 工具创建文件，并在聊天中显示完整内容供审核

文件创建流程： 以编程方式创建文件时：

  1. 生成包含 YAML frontmatter 的完整 Agent 内容
  2. 根据所选范围确定路径：
    • 项目：.claude/agents/[platform-name]-expert.md
    • 全局：~/.claude/agents/[platform-name]-expert.md（或对应的 Windows 路径）
  3. 使用 Write 工具并指定相应路径
  4. 验证文件是否成功创建
  5. Agent 可立即使用

示例

示例 1：单个 Agent
User: /spawn
Agent: [Shows multi-tab AskUserQuestion with 5 tabs]
  Tab 1 (Mode): Single Agent / Batch Generation / Architecture Analysis
  Tab 2 (Scope): Project Agent / Global Agent
  Tab 3 (Output): Create File / Show in Chat / Both
  Tab 4 (Platform): Custom Platform / [or popular options]
  Tab 5 (Focus): [Multi-select] General Coverage / Caching Patterns / Pub/Sub / etc.
User: [Selects all answers and submits once]
  Mode: Single Agent
  Scope: Global Agent
  Output: Both
  Platform: Redis (via Other field)
  Focus: General Coverage, Caching Patterns, Pub/Sub
Agent: [Generates Redis expert prompt and saves to ~/.claude/agents/redis-expert.md]
示例 2：批量生成
User: /spawn
Agent: [Shows multi-tab AskUserQuestion with 3 tabs]
  Tab 1 (Mode): Single Agent / Batch Generation / Architecture Analysis
  Tab 2 (Scope): Project Agent / Global Agent
  Tab 3 (Output): Create Files / Show in Chat / Both
User: [Submits]
  Mode: Batch Generation
  Scope: Project Agent
  Output: Create Files
Agent: Please provide platforms (one per line):
User: PostgreSQL
Redis
RabbitMQ

Agent: [Creates 3 .md files in .claude/agents/ (project directory)]
示例 3：架构分析
User: /spawn
Agent: [Shows multi-tab AskUserQuestion with 3 tabs]
  Tab 1 (Mode): Single Agent / Batch Generation / Architecture Analysis
  Tab 2 (Scope): Project Agent / Global Agent
  Tab 3 (Output): Create Files / Show in Chat / Both
User: [Submits]
  Mode: Architecture Analysis
  Scope: Global Agent
  Output: Both
Agent: Describe your architecture or provide file path:
User: E-commerce platform: Next.js frontend, Node.js API, PostgreSQL, Redis cache, Stripe payments, AWS S3 storage, SendGrid emails
Agent: Found platforms: Next.js, Node.js, PostgreSQL, Redis, Stripe, AWS S3, SendGrid
[Shows multi-select AskUserQuestion]
User: [Selects: nextjs-expert, redis-expert, stripe-expert, sendgrid-expert]
Agent: [Generates 4 selected agents in ~/.claude/agents/]

实施步骤

  1. 一次性提出所有问题，使用单个多问题 AskUserQuestion 调用：

    • 问题 1（标题："模式"）：单个 Agent / 批量生成 / 架构分析
    • 问题 2（标题："范围"）：项目 Agent（仅限此项目）/ 全局 Agent（所有项目）
    • 问题 3（标题："输出"）：创建文件 / 在聊天中显示 / 两者都要

    对于单个模式，也在同一次调用中询问：

    • 问题 4（标题："平台"）：提供“自定义平台”选项（用户在“其他”字段中输入）
    • 问题 5（标题："重点"，multiSelect: true）：全面覆盖 / [该技术的 2-3 个常见重点领域]

  2. 单个模式：

    • 如果用户选择了“自定义平台”，在聊天中提示用户输入平台名称
    • 根据回答生成全面的提示词
    • 根据输出偏好创建文件和/或显示内容

  3. 批量模式：

    • 在聊天中要求用户提供多行平台列表
    • 对每个平台：
      • 生成专家提示词
      • 保存到 .claude/agents/[platform]-expert.md
    • 报告完成情况并提供文件路径

  4. 架构分析：

    • 在聊天中询问用户提供架构描述
    • 解析并识别技术
    • 使用 AskUserQuestion 提供复选框选择器（multiSelect: true）
    • 生成所选 Agent
    • 根据输出偏好将文件保存到相应位置

  5. 生成每个 Agent 的提示词：

    • 查找官方文档（WebSearch 或 WebFetch）
    • 找到 10 个以上权威 URL
    • 按照上述模板组织内容
    • 聚焦于模式和最佳实践
    • 编写 500-1000 行，涵盖全面的模式
    • 使用 Markdown 格式

  6. 输出：

    • 根据所选范围确定文件路径：
      • 项目 Agent：.claude/agents/[platform]-expert.md
      • 全局 Agent：~/.claude/agents/[platform]-expert.md（Unix/Mac）或 C:\Users\[username]\.claude\agents\[platform]-expert.md（Windows）
    • 如果选择“创建文件”或“两者都要”：使用 Write 工具，写入相应路径，并包含完整的 YAML frontmatter 和系统提示词
    • 如果选择“在聊天中显示”或“两者都要”：在代码块中显示完整 Markdown（包括 frontmatter）
    • 确认创建完成并提供完整文件路径
    • 提醒用户，几秒后即可通过 Agent 工具使用该 Agent（如果此次操作创建了 agents/ 目录，请先重启）

重要：始终使用单个 AskUserQuestion 调用并包含多个问题（2-4 个），以创建多标签页界面。切勿依次逐个提问。

质量检查清单

输出每个 Agent 提示词前，请确认：

  • 存在包含必需字段（name、description）的 YAML frontmatter
  • 名称采用小写字母加连字符的格式
  • 描述清晰具体（长度不限）
  • 如需限制访问权限，请指定 Tools 字段（最佳实践：仅授予必要的工具）
  • 系统提示词中包含 10 个以上权威 URL
  • 包含 10 个以上可用于生产环境的代码示例
  • 包含完整的开发和生产环境配置文件
  • 包含带有实际测试代码的测试模式
  • 包含错误处理模式和异常层级
  • 包含 5 个以上反模式，并对比错误与正确的代码
  • 系统提示词简洁明了、易于浏览
  • 定义明确的使用场景
  • 指明集成点
  • 引用常见模式
  • 列出反模式
  • 全文使用恰当的 Markdown 格式
  • 文件名与 name 字段一致：[name].md
  • 遵循 Claude Code 子 Agent 最佳实践（参见上方文档链接）

生成后

创建 Agent 后，提醒用户：

  1. 检查生成的提示词
  2. 使用示例问题测试 Agent
  3. 根据实际使用情况进行完善
  4. 如满意，将其添加到版本控制中
  5. 如需了解高级功能和最佳实践，请参阅上方的 Claude Code 文档链接

其他资源：

评论

支持 Markdown