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: 精确读取命中文件
只读命中的文件,不全量读整个目录。优先顺序:
- 命中的正式文档(widgets/xxx.md、events/xxx.md 等)
- 对应的 README.md(如需了解全貌)
- 相关文档(如问题跨子域)
Step 3: 输出结论
回答包含三部分:
- 直接结论 - 回答用户的问题
- 依据 - 引用的文档路径
- 下一步阅读建议 - 如果问题跨层或需要更多细节
严禁行为
- 不凭印象补全不存在的组件、Hook、Event 或代码路径
- 不把历史方案草稿(docs/plans/)当正式知识源
- 不全量读 references/ 下所有文件
- 不在未找到答案时编造路径