SuperAPI AI 工具集

agent-development

智能体与模型

查看项目

更新于 10-16 08:40

技能介绍

用途:该技能指导如何为 Claude Code 插件创建自主智能体。智能体是以 markdown 文件定义的自主 AI 专家,文件由 YAML frontmatter 和系统提示词正文组成。

主要能力:定义智能体文件结构,包括必填字段与可选字段。必填字段为 name(小写标识符,3-50 字符,仅允许连字符)和 description(以“Use this agent when...”开头并包含触发条件)。可选字段包括 model(inherit、sonnet、opus 或 haiku)、color(blue、cyan、green、yellow、magenta、red)以及 tools(限制工具访问的数组)。

系统提示词设计:正文使用第二人称,建议包含角色定义、Process 步骤、Output Format 与 Quality Standards。提示词长度建议在 500-3000 字符之间,需明确角色职责、分步分析流程、输出格式以及质量标准与边界情况。

description 字段尤为关键,用于告诉 Claude 何时激活该智能体,可包含 2-4 个触发示例,例如用户要求审查 PR、提交后希望获得反馈、提及代码安全问题等。

最佳实践:遵循最小权限原则,仅授予必要工具;同类智能体使用一致颜色;测试触发是否按预期生效;明确界定智能体不做什么。

文件位置:项目范围 .claude/agents/my-agent.md;用户范围 ~/.claude/agents/my-agent.md;插件范围 plugin/agents/my-agent.md。

限制:资料未提供具体收费、价格、平台支持范围或效果数据,暂未提供。