SuperAPI AI 工具集

agent-sort

编程与开发

查看项目

更新于 11-10 16:22

技能介绍

Agent Sort 是一个用于对具体代码仓库生成项目级 ECC 安装方案的技能。当仓库需要项目特定的 ECC 组件面,而不是默认全量安装时使用。其目标不是凭感觉猜测哪些组件“有用”,而是依据实际代码库中的证据对 ECC 组件进行分类。

适用场景包括:项目只需要 ECC 的一个子集,全量安装过于嘈杂;仓库技术栈清晰,但没人愿意逐个手工筛选技能;团队希望获得可重复、由 grep 证据支撑而非主观意见的安装决策;需要把始终加载的日常工作流面与可搜索的库/参考面分开;仓库已漂移出错误的语言、规则或钩子集,需要清理。

不可协商的规则:以当前仓库为事实来源,而非通用偏好;每个 DAILY 决策必须引用具体的仓库证据;LIBRARY 不意味着“删除”,而是“保持可访问但不默认加载”;不要安装当前仓库无法使用的 hooks、rules 或 scripts;优先使用 ECC 原生面,不引入第二套安装系统。

输出物按顺序为:DAILY 清单、LIBRARY 清单、安装计划、验证报告,以及可选的技能库路由器(如果项目需要)。

分类模型使用两个桶:DAILY 表示每个会话都应为该仓库加载、与仓库语言/框架/工作流/操作面强烈匹配的组件;LIBRARY 表示值得保留但不值得默认加载、应通过搜索、路由器技能或选择性手动使用保持可达的组件。

证据来源优先使用仓库本地证据:文件扩展名、包管理器与锁文件、框架配置、CI 与钩子配置、构建/测试脚本、导入与依赖清单、明确描述技术栈的仓库文档。常用命令包括:rg --files、rg -n "typescript|react|next|supabase|django|spring|flutter|swift"、cat package.json、cat pyproject.toml、cat Cargo.toml、cat pubspec.yaml、cat go.mod。

若可用并行子代理,可将审查拆分为多轮:agents(分类 agents/)、skills(分类 skills/)、commands(分类 commands/)、rules(分类 rules/)、hooks 与 scripts(分类钩子面、MCP 健康检查、辅助脚本、操作系统兼容性)、extras(分类 contexts、examples、MCP 配置、模板、指导文档)。若无子代理,则顺序执行相同轮次。

核心工作流:首先阅读仓库,确定实际语言、框架、主要包管理器、测试栈、lint/format 栈、部署/运行时面、已有的操作集成;然后构建证据表,对每个候选面记录组件路径、组件类型、建议桶、仓库证据和简短理由;接着决定 DAILY 与 LIBRARY,当仓库明确使用匹配技术栈、组件足够通用、仓库已依赖对应运行时或工作流时提升为 DAILY,当组件不在技术栈内、可能日后需要但非每天需要、增加上下文开销而无即时相关性时降为 LIBRARY;随后构建安装计划,将分类转化为行动——DAILY 技能安装或保留在 .claude/skills/,DAILY 命令仅在仍有用时保留为显式 shim,DAILY 规则仅安装匹配语言集,DAILY hooks/scripts 仅保留兼容项,LIBRARY 面通过搜索或 skill-library 保持可达,若仓库已使用选择性安装则更新现有计划而非另建系统;若项目需要可搜索库面,创建 .claude/skills/skill-library/SKILL.md 路由器,包含 DAILY 与 LIBRARY 的简短说明、分组触发关键词、库引用所在位置,不要在路由器内复制每个技能正文;最后验证结果,检查每个 DAILY 文件存在于预期位置、未遗留过时语言规则、未安装不兼容钩子、安装结果确实匹配仓库技术栈,并返回紧凑报告,包含 DAILY 数量、LIBRARY 数量、移除的过时面、未决问题。

交接:若下一步是交互式安装或修复,交给 configure-ecc;若下一步是重叠清理或目录审查,交给 skill-stocktake;若下一步是更广泛的上下文裁剪,交给 strategic-compact。

输出格式按顺序返回:STACK(语言/框架/运行时摘要)、DAILY(带证据的始终加载项)、LIBRARY(带证据的可搜索/参考项)、INSTALL PLAN(应安装、移除或路由的内容)、VERIFICATION(已运行的检查和剩余缺口)。