这个 GitHub 爆火的 Agent Sort 到底能干嘛?实测来了

1496 字
7 分钟
这个 GitHub 爆火的 Agent Sort 到底能干嘛?实测来了

如果你正在用 Claude Code 或类似 AI 编程助手,这篇文章可能会改变你的使用方式。

什么是 Agent Sort?#

简单说,Agent Sort 是一个「智能分类器」,专门为 AI Agent 的 Skills 配置做瘦身和精准匹配。

想象一下这个场景:你的项目是一个纯 Next.js 前端,但 ECC(everything-claude-code)默认会给你安装 Django 规则、Python 模式、Go 模板、Rust 钩子……一大堆根本用不上的东西。每次会话都要加载这些无用组件,白白消耗 token 和上下文空间

Agent Sort 做的就是:扫描你的实际代码库,用 grep 证据说话,把每个组件精准分类到「DAILY」(每次加载)或「LIBRARY」(按需查阅)两个桶里。

原始项目简介#

  • 仓库affaan-m/everything-claude-code
  • 星数:170,000+ ⭐(截至 2026 年 4 月)
  • 作者:Affaan Mustafa
  • 描述:Agent harness 性能优化系统 — Skills、Instincts、Memory、Security 全覆盖

这个项目是 AI 编程助手生态中最受欢迎的配置优化方案之一,提供了从 Skills 到 MCP 集成的一整套工具链。Agent Sort 是其中最实用的 Skill 之一。

核心功能与亮点#

1. 基于证据的分类,不靠猜#

Agent Sort 的核心哲学是「不要猜测,要看证据」。它不会凭感觉说「这个项目可能需要 Python」,而是去 grep 你的代码:

  • .py 文件吗?
  • pyproject.toml 吗?
  • package.json 里声明了什么技术栈?
  • CI 配置在跑什么?

每个分类决策都必须附带具体的仓库证据。

2. DAILY vs LIBRARY 二分模型#

整个分类体系极其简洁,只用两个桶:

分类含义加载时机
DAILY与项目技术栈强匹配,每次会话都有用每次 Agent 启动时自动加载
LIBRARY可能有用但不值得默认加载通过搜索或路由器 Skill 按需取用

不是「删掉」,而是「归档可查」——这个设计非常合理。

3. 六通道并行审查#

如果你的 Agent 支持并行子 Agent,Agent Sort 会把审查拆成六个通道同时跑:

  1. Agents → 分类 agents/*
  2. Skills → 分类 skills/*
  3. Commands → 分类 commands/*
  4. Rules → 分类 rules/*
  5. Hooks & Scripts → 分类 hook 和脚本
  6. Extras → 分类上下文、示例、MCP 配置等

没有子 Agent 也没关系,顺序执行同样的流程。

4. 完整的输出产物#

一次完整的 Agent Sort 运行会产出五件东西:

1. DAILY 清单 — 哪些要加载
2. LIBRARY 清单 — 哪些要归档
3. 安装计划 — 具体怎么操作
4. 验证报告 — 确认结果正确
5. skill-library 路由器(可选)— 可搜索的参考库入口

使用方法#

适用场景#

适合的情况:

  • 项目只需要 ECC 的一部分,全量安装太臃肿
  • 仓库技术栈清晰,但不想手动一个个筛选
  • 团队需要基于证据(而非主观意见)的可重复安装决策
  • 仓库的技术栈已漂移,混入了不该用的组件

不适用场景#

不适合的情况:

  • 从零开始的新项目,还没确定技术栈
  • 项目本身就是个 Skills 集合仓库(分类逻辑不适用)
  • 你不在乎 token 消耗和上下文开销

实际操作步骤#

第一步:分析仓库技术栈

Terminal window
# 看看项目里都有什么文件
rg --files
# 搜索关键技术栈关键词
rg -n "typescript|react|next|supabase|django|spring|flutter|swift"
# 检查配置文件
cat package.json
cat pyproject.toml
cat Cargo.toml

第二步:构建证据表

对每个候选组件,按这个格式记录:

skills/frontend-patterns | skill | DAILY | 84 个 .tsx 文件,存在 next.config.ts | 核心前端技术栈
skills/django-patterns | skill | LIBRARY | 无 .py 文件,无 pyproject.toml | 此仓库不活跃

第三步:决定分类

  • 仓库明确使用对应技术栈 → DAILY
  • 组件偏离当前技术栈 → LIBRARY

第四步:执行安装计划

  • DAILY 组件 → 保留在 .claude/skills/
  • LIBRARY 组件 → 通过搜索保持可访问

第五步:验证

确认每个 DAILY 文件在预期位置,过期组件已被移除。

与其他 Skill 的对比#

Skill功能与 Agent Sort 的关系
configure-ecc交互式安装/修复Agent Sort 产出分类后,可交接给 configure-ecc 执行安装
skill-stocktake重叠清理与目录审查如果需要进一步清理,可交接给 skill-stocktake
strategic-compact上下文裁剪如果需要更广泛的上下文优化,可交接给它

Agent Sort 在流程中扮演的是决策层角色——它不做安装,只做分类,然后交接给专门的 Skill 执行。

实测评价#

优点#

  • 🎯 证据驱动:不靠直觉,grep 说话
  • 🧹 瘦身效果显著:一个纯前端项目可能省掉 60%+ 的无用加载
  • 🔄 可重复:每次运行结果一致,适合团队
  • 📊 输出标准化:格式清晰,便于审查和交接
  • 🤖 并行友好:有子 Agent 时速度更快

缺点#

  • 📝 对小型单文件项目收益有限(本来就没多少组件)
  • 🔧 需要一定技术判断力来解读证据表
  • 📚 学习成本:第一次用可能需要跑两遍才能完全理解流程

推荐指数:⭐⭐⭐⭐½(4.5/5)#

对于任何使用 AI 编程助手的中大型项目,Agent Sort 都是必备技能。它的证据驱动方法让配置优化从「凭感觉」变成了「看数据」,这正是 AI 辅助开发应该有的样子。

总结#

Agent Sort 解决的问题很朴素:别让你的 AI Agent 加载一堆不需要的东西。但它的实现方式很聪明——用代码仓库的实际内容作为证据,用简洁的两分模型做分类,用标准化的输出确保可重复性。

如果你的 AI 编程助手每次启动都要花几秒钟加载一堆无关的 Skills 和 Rules,试试 Agent Sort。它可能会让你惊讶于原本浪费了多少上下文空间。


🔗 原始项目affaan-m/everything-claude-code 📦 中文翻译版本awesome-ai-agent-skills-zh

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

这个 GitHub 爆火的 Agent Sort 到底能干嘛?实测来了
https://boke.hackerdream.xyz/posts/agent-sort-introduction/
作者
晴天
发布于
2025-05-14
许可协议
CC BY-NC-SA 4.0
Profile Image of the Author
晴天
Hello, I'm 晴天.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
125
分类
17
标签
287
总字数
257,955
运行时长
0
最后活动
0 天前

目录