Agent Sort

作者 affaan-mef648e01899bMIT275K 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫3 天前更新

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

AI 產生的概覽

透過將技能、命令、規則與鉤子分為 DAILY 與 LIBRARY 兩類,為特定儲存庫產出有證據支持的 ECC 安裝方案。

功能
此技能引導代理針對特定儲存庫將 ECC 元件分為兩類:DAILY(每次工作階段都載入)與 LIBRARY(保持可存取但不預設載入)。它會產出 DAILY 清單、LIBRARY 清單、安裝方案、驗證報告,以及選用的 skill-library 路由檔案。分類必須引用具體的儲存庫證據,例如副檔名、鎖定檔、框架設定與 CI 設定。
適用情境
當專案只需要 ECC 的一部分、完整安裝過於吵雜時使用;或當團隊希望獲得可重複、有證據支持的安裝決策,而非逐一手動篩選技能時使用。它也適合清理已偏離到錯誤語言、規則或鉤子集合的儲存庫。
執行需求
不附帶指令碼,僅為指示文件。它需要存取目標儲存庫,並能執行 rg、cat 等搜尋與檔案讀取命令,選用時可搭配平行子代理執行審查流程。

Agent Sort

Use this skill when a repo needs a project-specific ECC surface instead of the default full install.

The goal is not to guess what "feels useful." The goal is to classify ECC components with evidence from the actual codebase.

When to Use

  • A project only needs a subset of ECC and full installs are too noisy
  • The repo stack is clear, but nobody wants to hand-curate skills one by one
  • A team wants a repeatable install decision backed by grep evidence instead of opinion
  • You need to separate always-loaded daily workflow surfaces from searchable library/reference surfaces
  • A repo has drifted into the wrong language, rule, or hook set and needs cleanup

Non-Negotiable Rules

  • Use the current repository as the source of truth, not generic preferences
  • Every DAILY decision must cite concrete repo evidence
  • LIBRARY does not mean "delete"; it means "keep accessible without loading by default"
  • Do not install hooks, rules, or scripts that the current repo cannot use
  • Prefer ECC-native surfaces; do not introduce a second install system

Outputs

Produce these artifacts in order:

  1. DAILY inventory
  2. LIBRARY inventory
  3. install plan
  4. verification report
  5. optional skill-library router if the project wants one

Classification Model

Use two buckets only:

  • DAILY
    • should load every session for this repo
    • strongly matched to the repo's language, framework, workflow, or operator surface
  • LIBRARY
    • useful to retain, but not worth loading by default
    • should remain reachable through search, router skill, or selective manual use

Evidence Sources

Use repo-local evidence before making any classification:

  • file extensions
  • package managers and lockfiles
  • framework configs
  • CI and hook configs
  • build/test scripts
  • imports and dependency manifests
  • repo docs that explicitly describe the stack

Useful commands include:

bash
rg --filesrg -n "typescript|react|next|supabase|django|spring|flutter|swift"cat package.jsoncat pyproject.tomlcat Cargo.tomlcat pubspec.yamlcat go.mod

Parallel Review Passes

If parallel subagents are available, split the review into these passes:

  1. Agents
    • classify agents/*
  2. Skills
    • classify skills/*
  3. Commands
    • classify commands/*
  4. Rules
    • classify rules/*
  5. Hooks and scripts
    • classify hook surfaces, MCP health checks, helper scripts, and OS compatibility
  6. Extras
    • classify contexts, examples, MCP configs, templates, and guidance docs

If subagents are not available, run the same passes sequentially.

Core Workflow

1. Read the repo

Establish the real stack before classifying anything:

  • languages in use
  • frameworks in use
  • primary package manager
  • test stack
  • lint/format stack
  • deployment/runtime surface
  • operator integrations already present

2. Build the evidence table

For every candidate surface, record:

  • component path
  • component type
  • proposed bucket
  • repo evidence
  • short justification

Use this format:

text
skills/frontend-patterns | skill | DAILY | 84 .tsx files, next.config.ts present | core frontend stackskills/django-patterns   | skill | LIBRARY | no .py files, no pyproject.toml       | not active in this reporules/typescript/*       | rules | DAILY | package.json + tsconfig.json            | active TS reporules/python/*           | rules | LIBRARY | zero Python source files             | keep accessible only

3. Decide DAILY vs LIBRARY

Promote to DAILY when:

  • the repo clearly uses the matching stack
  • the component is general enough to help every session
  • the repo already depends on the corresponding runtime or workflow

Demote to LIBRARY when:

  • the component is off-stack
  • the repo might need it later, but not every day
  • it adds context overhead without immediate relevance

4. Build the install plan

Translate the classification into action:

  • DAILY skills -> install or keep in .claude/skills/
  • DAILY commands -> keep as explicit shims only if still useful
  • DAILY rules -> install only matching language sets
  • DAILY hooks/scripts -> keep only compatible ones
  • LIBRARY surfaces -> keep accessible through search or skill-library

If the repo already uses selective installs, update that plan instead of creating another system.

5. Create the optional library router

If the project wants a searchable library surface, create:

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

That router should contain:

  • a short explanation of DAILY vs LIBRARY
  • grouped trigger keywords
  • where the library references live

Do not duplicate every skill body inside the router.

6. Verify the result

After the plan is applied, verify:

  • every DAILY file exists where expected
  • stale language rules were not left active
  • incompatible hooks were not installed
  • the resulting install actually matches the repo stack

Return a compact report with:

  • DAILY count
  • LIBRARY count
  • removed stale surfaces
  • open questions

Handoffs

If the next step is interactive installation or repair, hand off to:

  • configure-ecc

If the next step is overlap cleanup or catalog review, hand off to:

  • skill-stocktake

If the next step is broader context trimming, hand off to:

  • strategic-compact

Output Format

Return the result in this order:

text
STACK- language/framework/runtime summary
DAILY- always-loaded items with evidence
LIBRARY- searchable/reference items with evidence
INSTALL PLAN- what should be installed, removed, or routed
VERIFICATION- checks run and remaining gaps

來源與署名

來源:affaan-m/ecc位於.agents/skills/agent-sort提交ef648e0

授權條款: MIT

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架