用途:当需要从既有实现和参考资料中获取灵感或指导时使用该技能,例如设计已有成熟模式的新功能、在架构决策上卡住,或想了解同类工具如何解决某问题。
主要能力:读取并利用 .references/ 目录下的参考资料。参考资料位于 .references/<name>/,其中 REF.md 为必需,包含元数据与描述;目录内可选放 PDF、Markdown、代码示例等本地文件。REF.md 使用 YAML 前置元数据,字段包括 name、type(link、local 或 hybrid)、url(type 含 link 时必需)、description,正文记录关键模式、架构与相关性说明。
使用方式:列出可用参考资料用 ls .references/;读取某个参考资料用 cat .references/<name>/REF.md。link 类型指向外部资源(GitHub 仓库、文档),可用 WebFetch 或浏览该 URL,按需获取具体文件;local 类型直接读取参考目录中的文件;hybrid 同时包含链接与本地补充材料。最后提取相关模式并适配到当前项目的约定。
最佳实践:先读 REF.md 了解该参考资料提供什么;聚焦与当前任务相关的模式;适配而非盲目复制;可将新见解记录到 .agents/notes/ 供后续参考。
限制:资料未提供该技能的安装方式、收费、价格、平台或效果等信息。