SuperAPI AI 工具集

skill-workflow-creator

智能体与模型

查看项目

更新于 10-16 09:32

技能介绍

用途:该技能面向 Claude Code 子智能体的创建与使用,指导如何把复杂任务委派给可自主运行、无需用户交互的子智能体,并将最终输出返回主对话。

主要能力:

  1. 引导创建子智能体:运行 /agents 命令,选择 Create New Agent,并选择项目级 .claude/agents/ 或用户级 ~/.claude/agents/。
  2. 配置字段:name(小写与连字符、唯一)、description(自然语言说明用途及何时调用,用于自动选择)、tools(逗号分隔,如 Read, Write, Edit, Bash, Grep;省略则继承主线程全部工具)、model(sonnet、opus、haiku 或 inherit;省略则用默认子智能体模型)。
  3. 文件层级:项目级 .claude/agents/ 优先级最高,用户级 ~/.claude/agents/ 次之,插件目录最低;同名时项目级覆盖用户级。也可直接编辑 .md 文件。
  4. 执行模型:子智能体是黑盒,在隔离上下文中运行,可用 Read、Write、Edit、Bash、Grep、Glob 及 MCP 等非交互工具,但不能使用 AskUserQuestion 或任何需用户交互的工具,用户看不到中间步骤,只看到最终报告。
  5. 工作流设计:需求收集、选项确认、需用户可见进度的工作放主对话;研究、按既定需求生成代码、分析报告、上下文密集操作放子智能体。
  6. system prompt 规范:使用纯 XML 结构,去掉正文中的 Markdown 标题;推荐标签包括 role、constraints、focus_areas、workflow、output_format、success_criteria、validation。应按复杂度选择标签数量。
  7. 后台执行:Task 工具支持 run_in_background: true 异步启动并返回 agent_id;用 TaskOutput 工具取回结果,参数含 task_id、block(默认 true)、timeout(默认 30000,最大 600000)。可同时发起多个 Task 调用并行执行,也可用 resume 参数携带历史上下文继续执行。

适用场景:代码审查、安全漏洞扫描、测试覆盖分析、API 研究、文档生成等可自主完成的委派任务。

限制:子智能体无法与用户交互;不适合 10 秒内的快速操作、需顺序依赖的任务、需要立即结果才能推进的步骤;应遵循最小权限原则限制工具。

补充资料:references/subagents.md、writing-subagent-prompts.md、evaluation-and-testing.md、error-handling-and-recovery.md、context-management.md、orchestration-patterns.md、debugging-agents.md。