qoderwake的skill需显式绑定知识库才能调用私有知识，包括在skill.md中声明knowledge_sources字段、在yaml skill中插入knowledge.search或knowledge.get_by_tag动作，并通过调试面板验证检索结果是否非空且内容正确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake的Skill在执行时自动调用私有知识库中的内容，比如查内部API文档后再调用HTTP Skill发请求，而不是靠人工填参或硬编码——这需要明确建立Skill与知识源之间的上下文绑定关系，否则Skill只会按默认逻辑运行，完全忽略你上传的PDF或Markdown。
在Skill定义中声明知识库依赖
QoderWake不会自动把所有知识库都塞进每个Skill的上下文，必须显式声明哪些知识源对该Skill生效。
第一步：打开你的Skill所在目录，编辑SKILL.md文件。
第二步：在文件末尾新增knowledge_sources字段，填入已挂载的知识库ID或别名。例如：
【knowledge_sources: ["payment-spec-v3", "error-code-ref"]】
这个字段值必须与你在Qoder CN控制台创建知识库时填写的“知识库标识”完全一致，大小写、连字符都不能错。填错会导致Skill运行时查不到任何知识片段，且不报错，只返回空结果。
第三步：保存文件，重启QoderWake Agent或执行qoder skill reload --name your-skill-name重新加载该Skill。
用YAML Skill注入实时知识检索动作
当Skill需要动态检索知识（比如根据用户提问关键词查对应SOP），就不能只靠静态绑定，得在执行流程里插入知识检索步骤。
方法一：在YAML Skill的steps中插入knowledge.search动作
在steps列表中添加一项：
- action: knowledge.search
params:
query: "{input.user_question}"
source_ids: ["internal-ops-manual"]
top_k: 3
这一步会把用户原始输入作为查询语句，去指定知识库中做向量检索，返回最相关的3段文本，并自动注入到后续step的context中。
方法二：用knowledge.get_by_tag精准拉取结构化知识
如果你的知识库文档已打上标签（如tag: “database-migration”），可直接按标签提取：
- action: knowledge.get_by_tag
params:
tag: "database-migration"
format: "markdown"
该动作不走语义检索，而是精确匹配标签，响应更快，适合固定场景复用，比如每次执行DB迁移Skill都必须加载同一份检查清单。
验证Skill是否真正读到了知识
1、在Qoder IDE中打开调试面板 → 进入「Skill执行沙盒」→ 选择你要测试的Skill。
2、输入模拟输入，例如：{"user_question": "支付超时怎么重试？"}
3、点击「执行并查看Trace」，展开log详情，找到knowledge.search或knowledge.get_by_tag节点。
4、确认output字段中返回了非空content，且内容来自你上传的《支付异常处理手册.pdf》——如果返回空数组或全是乱码，说明知识库未就绪或编码错误。
5、若看到"retrieval_confidence: 0.42"低于0.6，说明语义匹配度弱，需检查文档是否含扫描图、是否被切块过碎，或考虑在知识库配置中启用“增强术语识别”开关。
