用途:OKF 用于查找并维护与当前任务相关的知识,这些知识以 Open Knowledge Format Markdown 存储,来源可以是仓库知识包,也可以是明确选定的个人知识包。
主要能力:先读取适用的仓库说明,再确定当前知识包与范围;可读取根目录 index.md,围绕当前任务、相关代码区域和可能失败场景进行检索,并只取少量源文件,避免加载全部规则标题、技能触发条件或整个语料库。检索结果只是候选,需要顺着链接查看规则引用的实际代码或文档,并在名称或任务范围变化时细化查询。
使用方式:若安装了可选 CLI,可运行 irudd-okf context 确定上下文;否则按仓库说明中的知识包路径操作。CLI 检索示例包括 irudd-okf cli search "find rules"、irudd-okf cli schema search、irudd-okf search "migration tests" --scope repo --limit 5、irudd-okf read repo architecture/migrations.md。没有 CLI 时,可用普通文件搜索(rg)并阅读相关 Markdown。
适用场景:需要按仓库自身约定应用检索到的指导;解释规则时保留知识包名称与文件路径;若冲突规则影响任务且说明无法解决,应说明冲突并询问操作者,不要自行发明优先级。被要求新增规则或仓库说明授权学习时,记录一条具体、可复用且有足够上下文的经验,先搜索避免重复。个人编辑需操作者明确授权,仓库编辑则作为普通文件进入代码审查差异。
限制:不要搜索无关仓库或推断个人知识包;格式细节、安全编写与冲突示例见 references/usage.md。原生技能仍适合任务流程,OKF 存储这些流程可能检索的事实与规则。