Skill Discovery
以 L-yifan/skills 远端 README 为唯一推荐数据源。每次检索读取当前版本,不维护本地副本。
Workflow
Step 1:确定检索意图
从用户请求提取 2–5 个任务词(可含中英文同义词)。只有当请求已经指向工作区内的文件或目录时,才轻量读取其路径链上的 AGENTS.md / CLAUDE.md 来补充直接相关的技术栈或约束:最多 3 个文件、每个最多前 12 KB、路径越近优先。
项目上下文只用于扩展关键词与重排候选,不能替代用户意图。若用户没有说明要解决的能力或任务,先询问该信息;否则直接检索,不因缺少项目说明而阻塞。
完成条件:得到一组能直接表达用户任务的检索词;仅在确有路径上下文时加入了相关约束词。
Step 2:检索索引
按以下顺序读取 L-yifan/skills 的远端 README:
- 优先使用
gh查询仓库 README;解码其内容后读取完整表格。 - 若
gh因未登录、网络、TLS 或 API 错误失败,打开https://github.com/L-yifan/skills的仓库页并读取 README。 - 仅当以上两种方式都失败时停止,并说明分别尝试的方法和失败原因。
只用 README 表格中的技能名、描述、分类、来源和安装命令匹配任务词。不得因索引暂时不可读而改用宽泛搜索,也不得将本机已安装技能、系统技能、推荐插件或其他仓库的技能当作索引候选。
只有用户明确要求扩大到索引外的公开技能时,才搜索 GitHub SKILL.md。这类结果必须单列为“索引外候选”,不得与个人索引候选混排、不得表述为已收录,也不得把未验证的安装命令写入结果。
若用户点名某个技能,先在 README 中按精确名称核验;命中时说明其分类、用途和原样安装命令,未命中时明确说明“当前索引未收录”,不要猜测名称或来源。
从每个匹配行保留技能名、描述、来源和 README 中原样记录的安装命令。
完成条件:已记录所有索引内直接匹配项,或已明确说明索引不可达;索引外候选仅在用户明确要求扩大范围时出现,并已清楚标识其来源边界。
Step 3:排序并核验候选
按以下稳定顺序排序:
- 技能名直接匹配任务词;
- 描述直接回答用户任务;
- 与当前任务的技术栈、模块或约束直接匹配;
- 前三项相近时,优先同分类的自建技能。
最多保留 3 个候选。每个候选必须能给出一条具体匹配依据,并核验:名称、描述/分类、来源和安装命令均来自同一条 README 记录。安装命令仅可从 README 原样复制;没有可靠命令时标记“未验证,暂不提供安装命令”。
完成条件:每个候选都有可追溯的来源、匹配依据和已验证的安装命令或明确的缺失标记。
Step 4:交付推荐
先给一句结论,再按匹配度输出表格:
| 推荐 | 技能 | 匹配原因 | 来源 | 安装命令 |
|------|------|----------|------|----------|
| ★ 最推荐 | skill-name | 一句话 | README 分类或上游仓库 | `npx skills add ...` |
| ☆ 备选 | skill-name | 一句话 | README 分类或上游仓库 | `npx skills add ...` |
表格前说明使用的任务词与 README 获取方式(gh 或网页降级)。没有匹配时,说明已检索的范围和关键词,并建议用户明确授权扩大到索引外,或创建新技能。
完成条件:回复不超过 3 个候选;每个推荐均可由同一条索引记录和用户任务解释;没有可靠安装命令时未作猜测;未混入任何索引外或本机候选。