SuperAPI AI 工具集

team-routing

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

Team Routing 是一个自动识别领域并寻找合适团队成员的技能。

用途:根据分支名或改动文件路径检测所属领域,为 PR 找到合适的评审人;也可在初始化模式中展示领域上下文。

主要能力分五个阶段:

  1. 提取关键词。从分支名提取,如 feature/tables-filter 得到 keywords: ["tables"],fix/auth-token-expired 得到 ["auth"];也可用 git diff --name-only origin/develop | head -20 读取改动文件,按 apps/web/features/tables/、apps/api/routes/auth/、apps/web/features/settings/ 等路径模式匹配。
  2. 查询 Notion Domains 数据库。使用 API-query-database: [Domains-DB-ID],按 Keywords 或 Codebase_Paths 过滤,返回领域名、拓扑类型(stream-aligned、platform、enabling、complicated-subsystem)及主关键词。
  3. 查询 Team Capabilities。按 Primary_Domain 匹配领域且 Availability = "Available",按 Open_PR_Count ASC 排序,返回人名、GitHub 账号、最大 PR 数与当前开放 PR 数。
  4. 检查可用性。用 gh pr list --state open --author [github_handle] --json number | jq length 查看候选人的开放 PR,超过 Max_Open_PRs 则跳过。
  5. 回退逻辑。若无可用主负责人,先从 Skills 表查技能重叠的备份负责人,再按改动文件扩展名匹配技能文件模式,都没有则提示“No available reviewer found for domain [X]”。

使用方式:该技能由 push-pr.mdc(Phase 1.2 查找评审人)和 init.mdc(展示领域上下文)调用。依赖 Notion 数据库 Domains(关键词、代码库路径)、Team Capabilities(人员、领域、可用性、最大 PR 数)、Skills(回退匹配的文件模式)。

适用场景:推送 PR 时自动分配评审人、初始化时展示领域归属、任何需要查找领域负责人的流程。

限制:必须配置上述 Notion 数据库与 GitHub CLI 环境;领域与人员数据依赖数据库维护,若无人可用则只能回退或返回警告。其他限制暂未提供。