用途:当用户询问知识库(kho/knowhow)本身包含什么,而非网页或代码库时使用。它从已积累的 knowhow 中回答问题,同时作为结构演化的第三类信号来源:反复提问却未命中页面,是结构缺失的强信号。
前置条件:先检查工作区是否存在 .knowhow/ 目录,命令为 ls -d .knowhow/ 2>/dev/null;若不存在则停止,并提示用户先运行 knowhow-init。
查询流程:第一步,读取 wiki/index.md、skills/registry.md、workflows/registry.md 了解全貌,从问题中提取 3-5 个关键词,用 grep -ril "<关键词>" .knowhow/wiki .knowhow/skills .knowhow/workflows 查找相关页面并阅读命中文件。第二步,综合已读页面直接回答,每条取自具体页面的陈述用 [[slug]] 标注来源;若找不到相关页面,直接说明“尚无相关 knowhow”,不得编造。第三步,评估回答质量,当需拼接 ≥3 个页面,或没有干净页面直接回答时,向 .knowhow/schema-signals.md 发出 query-miss 信号,格式为 - [YYYY-MM-DD] query | query-miss | <精简问题>,须拼接 <N> 页 | related: tag:<主题>;若 1-2 个干净页面即命中则不发出。第三步 b,当问题具操作性且回答主要依赖单个 pattern/troubleshooting 页面时,发出 promote-candidate 信号。第四步,若回答值得复用且用户确认,将原文存入 raw/YYYY-MM-DD-query-<slug>.md,并按格式在 inbox/ 创建条目,不得直接写入 wiki/、skills/、workflows/。第五步,在 wiki/log.md 记录日志。
teach 模式:用户要求“编写 onboarding 文档”“向新人讲解 X”时触发,本质仍是查询,但输出为阅读路径。按“知道→理解→做”排序:开头为 concept,中间为 decision 与 lesson,结尾为 pattern 与 skill/workflow。每项含 2-3 句摘要、[[slug]] 链接和一个自测问题,不复制页面原文;仅在用户指定位置时输出文件,且保存在 .knowhow/ 之外。发现缺口时报告用户并建议补充 capture/distill。
硬性规则:query 不直接写入 wiki/,新 knowhow 一律经 inbox/ → distill;不编造答案;所有取自页面的陈述标注 [[slug]];仅在真正“不匹配”时发出 query-miss;promote-candidate 仅用于操作性提问且主要依赖单个 pattern/troubleshooting 页面,纯查询不发出,已提升的页面不再发出。