agent-sort

agent-sort 技能概览

agent-sort 是一项面向仓库的规划技能，用来把宽泛的 ECC 配置收敛成更小、基于证据的安装范围。它能帮助你判断哪些内容应该每天加载，哪些更适合保留在库中可检索，从而避免为项目不会用到的技能、规则、hooks 或脚本过度安装。

它最适合维护者、agent 工作流负责人，以及任何在现有 repo 上做 agent-sort install 的人。它真正要完成的任务不是“整理文件”，而是基于真实代码库产出一份站得住脚的安装方案，减少猜测，也减少 ECC 噪音。

agent-sort 的用途

当你需要把 repo 里特定于 ECC 的内容分到更实用的桶里时，就该用 agent-sort 技能，尤其是在工作流混合、ECC 只部分落地的项目里。它适合用来把每日加载面保持得更精简，同时保留后续查阅需要的参考材料。

agent-sort 的不同之处

agent-sort 是证据驱动的：安装方案由仓库内容决定，而不是由个人偏好决定。它最大的价值在于减少误装，并把项目真正使用的内容显性化，因此它比通用 prompt 更偏向决策支持。

最适合与不适合的场景

如果仓库里已经有 ECC，但范围过宽、重复太多，或者逐渐偏离项目真实工作流，那它就很适合。若你只是想快速写一个一次性的 prompt 来概括仓库，或者项目根本没有 ECC 原生表面可处理，那它就不太适合。

如何使用 agent-sort 技能

安装与上下文设置

先在目标仓库里走 agent-sort install 流程，然后阅读 skills/agent-sort/SKILL.md 作为操作指南。这个技能是围绕仓库证据来工作的，所以要把它和你正在评估的 repo 一起安装，而不是单独使用。

能提升输出质量的输入

给技能一个明确的目标 repo、清晰的范围，以及你关心的决策边界。好的输入像这样：“把这个 repo 的 ECC surfaces 按当前 app 分成 DAILY 和 LIBRARY，只保留日常 agent 运行所必需的部分。” 反面示例则很模糊，比如“整理项目”或“让它更干净”。

推荐工作流

先查看仓库自己的 README、AGENTS 风格说明，以及任何与 ECC 相关的文件夹或 manifest 文件。然后用 agent-sort usage 把具体证据映射到每日加载候选项、仅库内引用项，以及任何不应安装的内容。目标是一份简洁的安装方案，并带有验证步骤，而不是凭空推演式的重构。

先读哪些文件

先看 SKILL.md，然后检查 repo 目录树中的 README.md、AGENTS.md、metadata.json，以及任何 rules/、resources/、references/ 或 scripts/ 文件夹。这个仓库里 SKILL.md 是主要来源，因为没有可交叉核对的支持文件。

agent-sort 技能常见问题

agent-sort 只适用于 ECC 项目吗？

是的，agent-sort 是围绕 ECC 原生表面和安装决策构建的。如果你的仓库不使用这种模式，通常直接提示会更简单，也更合适，没必要使用 agent-sort 技能。

它和普通 prompt 有什么不同？

普通 prompt 可以给出一个快速建议，但 agent-sort 更强调基于证据的分类和安装方案。这一点在你需要跨整个 repo 保持可重复的 agent-sort usage 时尤其重要，而不是只要一次性的意见。

agent-sort 对新手友好吗？

如果你能明确要评估的 repo，而且愿意先读一遍源码树，它就对新手比较友好。核心要求不是很深的 ECC 专业知识，而是要清楚哪些内容应当每天安装，哪些应当保留为库材料。

什么时候不应该使用 agent-sort？

如果你只需要一个通用的仓库摘要，如果项目没有可供分类的 ECC surfaces，或者你想做的是大范围重构而不是安装决策，就不要用它。在这些情况下，agent-sort for Skill Authoring 的额外开销是不必要的。

如何改进 agent-sort 技能

提供更明确的仓库证据

最好的 agent-sort 结果来自具体的仓库信号：文件路径、当前工作流名称，以及 agent 实际会碰到的内容示例。如果你能指向具体命令、文件夹或规则文件，daily/library 的划分就会更准确。

说明清楚安装边界

明确说明你是在给整个 repo 分类，还是某个子包，或某条窄工作流分类。边界越精确，技能就越不容易把参考材料误判成每日加载内容；这也是 agent-sort install 工作里常见的失败模式。

先检查第一版是否装得过重

如果输出感觉太重，追问哪些内容是真正每次运行都必须的，哪些只是供查阅的材料。最有价值的迭代步骤，是不断削减 daily installs，直到方案反映的是日常使用，而不是理论上可能有用。

保留有价值的库内材料

一份优秀的 agent-sort guide 不会把所有非 daily 内容都删掉。只要边界项还能支撑后续决策，就保留在 library 里，因为这个技能的目标是降低默认加载量，而不是抹掉项目知识。