用途:当问题不再是“收集更多知识”,而是把已有 .agents 语料运营化时使用。它可将反复出现的最强主张提升为信念体系,把健康主题转为可复用行动手册,为未来工作编译小型目标简报,并在薄弱主题与提升缺口固化前暴露出来。
在整个语料工作流中,它是第四步:$harvest 收集、$compile 合成、可选的 $dream 夜间复合循环,然后由 knowledge-activation 把已编译知识提升为行动手册、信念与运行时简报。$compile 仍是卫生循环,本技能负责语料运营化。
主要命令面为 ao knowledge 家族: ao knowledge activate --goal "turn agents into usable information" ao knowledge beliefs ao knowledge playbooks ao knowledge brief --goal "fix auth startup" ao knowledge gaps
使用方式:先确认工作区已有 .agents/ 目录,并至少具备一种证据基础:.agents/scripts/ 下的 packet 构建脚本,或 .agents/harvest/latest.json 作为原生回退。随后按 source manifests、topic packets、promoted packets、historical chunk bundles 顺序整合证据;刷新 ao knowledge beliefs 与 ao knowledge playbooks,生成 .agents/knowledge/ 与 .agents/playbooks/ 下的消费面;在有活动目标时用 ao knowledge brief 编译小型简报;用 ao knowledge gaps 报告薄弱主题、缺失提升、需复核的弱主张与建议的下一步挖掘。要一次完成全流程可运行 ao knowledge activate --goal "your goal here",它会依次执行证据整合、信念与行动手册刷新、可选简报编译与缺口摘要。
输出面包括 .agents/knowledge/book-of-beliefs.md、.agents/playbooks/index.md、.agents/playbooks/<topic>.md、.agents/briefings/YYYY-MM-DD-<goal>.md、.agents/retro/,底层还保留 .agents/packets/、.agents/topics/、.agents/packets/chunks/catalog.jsonl。
适用场景:需要把成熟语料提升为操作者可用知识时;需要为具体目标生成有界启动上下文时;需要评估语料是否适合提升时。
限制与信任规则:打包只是底层而非产品,信念、行动手册与简报才是真正操作面;薄弱主题在证据改善前仅用于发现;每个生成面应命名其消费者;重复未变化的运行应保持结构确定性。作为操作者上下文时,检索到的简报、信念或行动手册若改变建议,可用 ao metrics cite "<path>" --type applied 2>/dev/null || true 记录,已加载未使用则用 --type retrieved。文档还引用 references/dag.md、references/script-contracts.md、references/output-surfaces.md 及可执行规范文件。具体收费、平台与效果资料暂未提供。