knowledge-query

SKILL.md

Knowledge Query

这个 Skill 专门负责"先路由到正确仓库,再定位知识,再读取必要正文,再给出结论"。

目标是避免全量扫描 docs/references/ 导致上下文浪费。

适用场景

  • 问某个组件、Event、Hook、基础资源"在哪篇文档里"
  • 想知道某个玩法有没有现成的组件或方案
  • 想快速找到相关代码路径、配置路径
  • 想知道某个功能属于哪个仓库

执行流程

Step 0: 读 source-map.md,判断仓库

先读本 skill base directory 下的 references/source-map.md

根据路由规则判断问题属于哪个仓库:

  • 问题涉及活动组件(task/lottery/extra_gift 等)、Event(send_gift/charge 等)、基础资源(盲盒/礼盒/家族)→ wejoy-http-go
  • 问题明确提到仓库名 → 路由到对应仓库
  • 无法判断 → 默认 wejoy-http-go,回答中说明假设

Step 1: 读仓库入口文件

根据 source-map 的路由结果:

骨架仓库(状态=骨架): 直接告知用户该仓库知识尚未填充,附上接入规范路径: 本 skill base directory 下的 references/knowledge-ingestion-guide.md 不继续检索。

完整仓库(wejoy-http-go): 读本 skill base directory 下的 references/wejoy-http-go/quick-index.md → 关键词匹配 → 定位需要读取的目标文件列表(1-3 个)

Step 2: 精确读取命中文件

只读命中的文件,不全量读整个目录。优先顺序:

  1. 命中的正式文档(widgets/xxx.md、events/xxx.md 等)
  2. 对应的 README.md(如需了解全貌)
  3. 相关文档(如问题跨子域)

Step 3: 输出结论

回答包含三部分:

  1. 直接结论 - 回答用户的问题
  2. 依据 - 引用的文档路径
  3. 下一步阅读建议 - 如果问题跨层或需要更多细节

严禁行为

  • 不凭印象补全不存在的组件、Hook、Event 或代码路径
  • 不把历史方案草稿(docs/plans/)当正式知识源
  • 不全量读 references/ 下所有文件
  • 不在未找到答案时编造路径
Installs
7
First Seen
Apr 13, 2026