SuperAPI AI 工具集

creating-claude-agents

智能体与模型

查看项目

更新于 10-15 16:42

技能介绍

用途:在创建或改进 Claude Code 智能体时启用,帮助编写智能体文件、排查校验问题、理解格式要求,并区分 agent、skill 与 slash command。

主要能力:讲解智能体文件结构与 frontmatter。文件须放在 .claude/agents/ 目录下,为 Markdown 文件。必填字段为 name(小写字母、数字、连字符,符合 ^[a-z0-9-]+$,最长 64 字符)和 description(最长 1024 字符,建议以 Reviews/Analyzes/Helps with 等动作词开头);可选字段为 allowed-tools(逗号分隔,如 Read, Write, Bash,也支持 Bash(git *) 这类命令模式限制)、model(sonnet、opus、haiku、inherit)、agentType(agent)。内容须以 H1 标题开头,附带 emoji 图标,随后用“You are...”定义人设,并给出 Instructions、Process、Examples 等分段。

校验要点:须符合指定 JSON schema(https://github.com/pr-pm/prpm/blob/main/packages/converters/schemas/claude-agent.schema.json),常见错误包括缺少必填字段、名称含大写或下划线、名称过长、模型取值非法、缺少 H1。

模型选择:sonnet 适合多数智能体;opus 适合架构决策与深度分析;haiku 适合快速简单任务;inherit 继承父会话模型。工具应遵循最小权限原则,省略 allowed-tools 则继承全部工具。

最佳实践:描述具体明确、人设清晰、给出分步流程与正反示例、单一职责、加 emoji 图标、包含 agentType 以保留类型信息。创建后可用真实任务测试。

适用场景:创建新智能体、改进已有智能体、处理 frontmatter 或校验报错、判断何时用 agent 而非 skill 或 slash command。

限制:收费、价格、平台与效果数据暂未提供。