用途：帮助在 VS Code 中创建、调试与评审自定义代理（.agent.md），并设计多代理结构。
配置规则：VS Code 仅扫描工作区 .github/agents/ 直下层的 .md 文件，子目录不被识别。可选位置包括工作区 .github/agents/（团队共享）、用户配置文件（个人全工作区可用）、chat.agentFilesLocations 设置（指定额外路径）。扩展名支持 .agent.md 或 .md，.claude/agents/ 下 .md 为 Claude Code 兼容。
访问控制（frontmatter）：user-invokable 默认 true，设为 false 隐藏于选择器；disable-model-invocation 默认 false，设为 true 后不被其他代理作为子代理调用；父侧 agents 默认 *（全允许），可列出允许调用的子代理名，显式列入可覆盖子代理的 disable-model-invocation: true。
设计模式：Orchestrator + Workers 模式中，父代理 tools 需包含 "agent" 才能调用子代理，agents 列表限制可调用者，agents: [] 禁止全部，agents: '*' 全允许。
排查：代理不出现在选择器多因放在子文件夹或 user-invokable: false；runSubagent 报 not found 多为文件未被识别；子代理不被调用常因父代理缺 agent 工具；可经 Chat Diagnostics 或 runSubagent 测试确认。已弃用属性 infer、target 应删除或替换。