用途:当智能体需要使用 Autocontext 已经产出的知识时使用本技能,包括确认某任务是否已有积累、读取某场景的当前 playbook 或 lessons、以及把知识从一个检出或机器迁移到另一个。产出知识请改用 autocontext-creator;本技能不负责运行场景或评判输出。
知识位置:根目录默认为 ./knowledge,可用 AUTOCONTEXT_KNOWLEDGE_ROOT 改变。每个场景一个目录,内含 playbook.md(当前做法,随循环学习被重写)、lessons.json(累积经验,最新在最后)、hints.md、mutation_log.jsonl(追加式变更日志)、package_metadata.json(场景导出后出现)、reports/<run_id>.md。另有 analytics/、_hub/、_evaluator_epochs/ 等以下划线开头的跨场景共享目录。playbook.md 应优先阅读,它是当前答案;lessons.json 是形成过程的历史。
读取方式:playbook 与 lessons 都是普通文件,可直接读取,例如:cat "${AUTOCONTEXT_KNOWLEDGE_ROOT:-knowledge}/grid_ctf/playbook.md"。文件不存在表示该场景尚未学到东西,属正常状态而非错误。
查找运行:autoctx list --json 是不知道存在什么时的入口;autoctx status "$RUN_ID" --json;autoctx show "$RUN_ID"。
迁移知识:导出用 autoctx export --scenario grid_ctf --output grid_ctf_package.json --json;导入用 autoctx import-package grid_ctf_package.json --json,包文件是位置参数且必填。--conflict 决定目标场景已有知识时的行为:overwrite、merge 或 skip;--scenario 可用不同名称导入。建议用这些命令而非手工复制目录,因为包携带元数据。
细节排查:结果异常时可用 autoctx replay "$RUN_ID" --generation 1 查看该代 JSON。
限制与注意:知识按场景隔离,一个场景的 playbook 不适用于另一个;lessons.json 为追加式,最后条目最新,不代表按重要性排序;空 playbook 有意义,表示循环尚未找到值得保留的做法,与场景不存在不同。本技能不假设特定智能体宿主,大部分操作就是普通文件读取。