SuperAPI AI 工具集

agent-team

智能体与模型

查看项目

更新于 10-16 07:17

技能介绍

用途:该技能为当前仓库构建并运行一套定制化的 Claude Code 智能体团队。它探测仓库信号,从角色库挑选角色,写出 Claude Code 原生子智能体定义 .claude/agents/*.md 以及工作流文档 .claude/agent-team.md,团队成员通过 Agent 工具的 subagent_type 参数按名称启动。灵感来自 Viktor Farcic 的 dot-agent-deck,但走原生 API 路线。

四种模式(由第一个参数选择):init(无参数且不存在 .claude/agents/ 时触发)探测仓库、挑选角色并写入角色文件与 workflow 清单;update 重新探测并与现有角色文件做差异对比,保留每个文件的“## For this repo”尾部并做定向更新;run 读取团队清单、按任务描述启动成员并驱动流程,在用户闸门处停止;reflect 针对本次会话的智能体启动审查者,提出重构、新角色与版本升级建议。

版本滞后检查:每个生成的角色文件带有从 roles.yaml 抄来的 version。技能在已存在 .claude/agents/ 的仓库加载时先做快速滞后扫描,比较版本号并对比正文。仅提示,不自动编辑;合并发生在 update 模式。脚本以 python3 "<技能目录>/scripts/sync.py" check 运行,输出 ok、STALE、MODIFIED、CUSTOM、LEGACY、BAD-FM、ERROR 等状态;退出码 0 表示干净,1 表示存在漂移,2 表示工具自身失败。

自主权限:技能加载后,团队负责人可自行决定启动哪些角色、数量、前台或后台运行以及何时回收或关闭,无需每次请求用户授权。但涉及共享系统写入(推送发布标签、强制推送、合并 PR、发送外部消息)、切换新范围的任务、角色文件热修复、编辑 roles.yaml 或技能自身工作流、运行 update 等,仍需用户明确确认。

前置检查:需设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1,当前目录为 git 仓库根目录,并确认 Claude Code v2.1.32 或更高版本。

探测范围:构建/包清单、任务运行器、质量门禁配置(format、lint、typecheck、test、dead code、coverage、security scan、pre-commit 等槽位,需记录检查模式而非修复模式,并记录 CI 环境)、可复现环境清单、智能体启动器、项目斜杠命令、规格目录、CI 配置、发布信号,以及 CLAUDE.md 与 CONTRIBUTING.md。无检查的槽位记为 none (gap),单体仓库按组件分别记录。若仓库无任务运行器且多个槽位需要不止一条裸命令,可建议创建本地自包含的任务运行器,但须先询问用户。

限制:智能体团队为实验性功能,默认关闭;智能体启动器与斜杠命令需仓库中实际存在;部分行为细节与安装方式在资料中未完整提供。