Compass 指南针

问题：技能多了，反而不知道该叫谁

在一个动辄上百个 Agent 技能的生态里，「修登录 500」「该用 Scout 还是 Zen」「这几个代理差在哪」这类问题，往往不是缺能力，而是缺一张可检索、可比较的导航图。真正执行代码和编排链路有 Nexus；设计新代理有 Architect。Compass 的定位是：只负责推荐与解释，不生成代码、不替你跑任务。

工作方式：LISTEN → CACHE → MATCH → RECOMMEND → ORIENT

默认配方是 recommend：先理解你的任务类型、领域和紧迫性，再在 1～3 个候选里收敛推荐——每条必须说清楚「为什么是这个技能」、具体用法示例，以及默认配方加 2～4 个代表性子命令（例如 scout 的 bug / regression / cascade），避免只丢一个名字让你自己猜变体。

recommend 会优先读仓库里的 .claude/compass-cache.md：缓存有效时用它做匹配源，上下文大约能缩到完整目录的一小部分；缺失时会提示你是否运行 init 生成缓存，过期则软警告后继续用旧缓存，不会在推荐过程中自动 refresh。需要全量名单时用 catalog（始终绕过缓存）；查各技能的子命令用 recipes；新手上手用 onboard。

init / refresh 会扫描项目信号（如 package.json、pyproject.toml、文件扩展名分布等），按仓库体量定 Top-N，写出带亲和度评分的轻量缓存；refresh 会附带增减与亲和度变化的前后对比。

匹配时不只靠类别标签：会交叉引用 reference/catalog.md、reference/recipes-directory.md，并在完整目录路径下对照目标技能的 CAPABILITIES_SUMMARY。任务太大时会把工作拆成子任务，每个子任务各推一个技能，而不是塞一堆「相关但松散」的代理。

边界与协作

• 何时用：要列表/类别概览、「X 该用哪个代理」、生态上手、相似代理对比、多代理链建议（需写明交接点与各代理职责）。
• 何时别用：实际执行任务 → Nexus；设计新代理 → Architect；跨代理知识沉淀 → Lore。
• 绝不：编造不存在的技能；给出没有交接说明的「代理袋子」式链路。
• 没有合适技能时会诚实说明缺口，并可向 Architect 上报；与 Nexus 的协作包括解释选型理由，以及把可执行的链建议交回执行侧。