agent-sort

Agent Sort

当仓库需要项目特定的ECC表面而非默认完整安装时使用此技能。

目标不是猜测“感觉有用”，而是基于实际代码库的证据对ECC组件进行分类。

何时使用

• 项目只需要ECC的子集，完整安装过于杂乱
• 仓库技术栈明确，但无人愿意逐个手动筛选技能
• 团队希望基于grep证据而非主观意见做出可重复的安装决策
• 需要将始终加载的日常工作流表面与可搜索的库/参考表面分离
• 仓库已偏离到错误的语言、规则或钩子集，需要清理

不可协商的规则

• 以当前仓库为事实来源，而非通用偏好
• 每个DAILY决策必须引用具体的仓库证据
• LIBRARY并不意味着“删除”，而是“保持可访问但不默认加载”
• 不要安装当前仓库无法使用的钩子、规则或脚本
• 优先使用ECC原生表面，不要引入第二个安装系统

输出

按顺序生成以下工件：

1. DAILY清单
2. LIBRARY清单
3. 安装计划
4. 验证报告
5. 可选的skill-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

并行审查轮次

如果并行子代理可用，将审查分为以下轮次：

1. 代理
   • 分类 agents/*
2. 技能
   • 分类 skills/*
3. 命令
   • 分类 commands/*
4. 规则
   • 分类 rules/*
5. 钩子和脚本
   • 分类钩子表面、MCP健康检查、辅助脚本和操作系统兼容性
6. 额外项
   • 分类上下文、示例、MCP配置、模板和指导文档

如果子代理不可用，则顺序执行相同的轮次。

核心工作流

1. 读取仓库

在分类任何内容之前，确定实际技术栈：

• 使用的语言
• 使用的框架
• 主要包管理器
• 测试栈
• 代码检查/格式化栈
• 部署/运行时表面
• 已存在的操作集成

2. 构建证据表

对于每个候选表面，记录：

• 组件路径
• 组件类型
• 建议的桶
• 仓库证据
• 简短理由

使用此格式：

skills/frontend-patterns | skill | DAILY | 84个.tsx文件，存在next.config.ts | 核心前端栈
skills/django-patterns   | skill | LIBRARY | 无.py文件，无pyproject.toml       | 此仓库未激活
rules/typescript/*       | rules | DAILY | package.json + tsconfig.json            | 活跃的TS仓库
rules/python/*           | rules | LIBRARY | 零个Python源文件             | 仅保持可访问

3. 决定DAILY vs LIBRARY

提升为DAILY当：

• 仓库明确使用匹配的技术栈
• 组件足够通用，有助于每次会话
• 仓库已依赖相应的运行时或工作流

降级为LIBRARY当：

• 组件不在技术栈内
• 仓库以后可能需要，但不是每天
• 它增加了上下文开销而无直接相关性

4. 构建安装计划

将分类转化为行动：

• DAILY技能 -> 安装或保留在.claude/skills/中
• DAILY命令 -> 仅当仍然有用时保留为显式shim
• DAILY规则 -> 仅安装匹配的语言集
• DAILY钩子/脚本 -> 仅保留兼容的
• LIBRARY表面 -> 通过搜索或skill-library保持可访问

如果仓库已使用选择性安装，则更新该计划而非创建另一个系统。

5. 创建可选库路由器

如果项目需要可搜索的库表面，创建：

• .claude/skills/skill-library/SKILL.md

该路由器应包含：

• DAILY与LIBRARY的简短说明
• 分组的触发关键词
• 库引用所在位置

不要在路由器中重复每个技能正文。

6. 验证结果

应用计划后，验证：

• 每个DAILY文件存在于预期位置
• 过时的语言规则未被保留为活动状态
• 不兼容的钩子未被安装
• 最终的安装确实匹配仓库技术栈

返回一个简洁的报告，包含：

• DAILY数量
• LIBRARY数量
• 移除的过时表面
• 未解决的问题

交接

如果下一步是交互式安装或修复，交接给：

• configure-ecc

如果下一步是重叠清理或目录审查，交接给：

• skill-stocktake

如果下一步是更广泛的上下文修剪，交接给：

• strategic-compact

输出格式

按此顺序返回结果：

技术栈
- 语言/框架/运行时摘要

DAILY
- 始终加载的项目及证据

LIBRARY
- 可搜索/参考的项目及证据

安装计划
- 应安装、移除或路由的内容

验证
- 已运行的检查和剩余差距