用途：create-sub-agent 用于设计并生成一个新的自主子智能体（Claude Code agent 文件），为其定义专属提示词、系统指令与工具权限。它面向需要独立职责、可被触发调用的智能体，而非无状态的流程型技能；后者应使用 create-skill。
主要能力：按分阶段工作流运行。若提供 $ARGUMENTS（可选的智能体名称或用例简述），则作为设计访谈的初始上下文；否则从开放探索开始。访谈提取核心意图，涵盖用途、输入/输出契约、升级姿态（escalation posture）、工具、permissions.deny、模型、maxTokens、颜色、生命周期钩子与放置位置。随后展示设计摘要、确认，再生成智能体 .md 文件，并用 validate_agent.py 校验。
输出：包含完整 YAML frontmatter 的智能体 .md 文件，字段包括 name、带 <example> 块的 description、model、maxTokens、color、permissions.allowedTools、permissions.deny，以及一段以第二人称撰写、目标 500–3,000 字符的系统提示词。
放置规则：插件智能体为扁平 .md 文件，路径为 plugins/<plugin-name>/agents/<agent-name>.md，无子目录；技能使用 skills/<name>/SKILL.md 子目录格式，但智能体不使用。本地/项目智能体为 .claude/agents/<agent-name>.md，同样扁平无子目录。
发布：若需让智能体对本仓库的 GitHub Copilot 或 Claude Code 可见，采用 Discovery-First 发布模式，将其物化到 .github/agents/（Copilot）或 .claude/agents/（Claude），确保 .gitignore 允许该文件或子目录，并提交到仓库。
边界情况：$ARGUMENTS 为空时执行完整第一阶段设计访谈，不预填；同名智能体已存在时先确认再覆盖；需求涉及多重职责时建议拆分为专门智能体；需要高风险操作时配置升级姿态并添加 Stop 钩子。
限制：资料未提供具体安装命令、收费方式、支持平台范围或实际效果数据，暂未提供。