当用户明确指定文件、目录、项目或资料时,把确认范围加入本机知识库,建立便于查找的目录导航,并逐份读取和整理。对有长期价值的内容分别形成独立总结;对无法读取、敏感、重复或不适合保留的文件逐件说明处理结果。代码项目侧重关键入口和重要说明文档,资料目录按用户要求逐文件处理,是否由 Git 管理只作参考而不会单独决定类型。普通查看、问答或自动发现不会触发,原始文件始终保持不变。
Coding
Use Self-Improving
Try it从本机已经整理好的项目、文件、知识和经验中查找旧信息,用户无需点名;收到目标和对象明确的任务时,会先按任务对象或领域、目标或动作、关键问题轻查可借鉴的相关经验。回答或开始工作可能受项目位置、文件总结、历史决定、稳定规则或相似故障经验影响时会自动只读查询;准备通过外部工具执行发送、发布、修改、删除、部署、授权、审批等操作,或外部工具结果异常、准备重试时,也会按工具、动作和关键对象轻查相关经验。适用于明确任务、“这个项目在哪、负责什么”“为什么以前这么做”“类似故障怎么处理”等自然问题及有外部影响的工具操作;会先用导航缩小候选,再核对原始文件或当前现场。找不到、证据不足或存在多个对象时会用普通话说明;全程只查不写,不新增、修改或删除知识库内容。
What it does
从本机已经整理好的项目、文件、知识和经验中查找旧信息,用户无需点名;收到目标和对象明确的任务时,会先按任务对象或领域、目标或动作、关键问题轻查可借鉴的相关经验。回答或开始工作可能受项目位置、文件总结、历史决定、稳定规则或相似故障经验影响时会自动只读查询;准备通过外部工具执行发送、发布、修改、删除、部署、授权、审批等操作,或外部工具结果异常、准备重试时,也会按工具、动作和关键对象轻查相关经验。适用于明确任务、“这个项目在哪、负责什么”“为什么以前这么做”“类似故障怎么处理”等自然问题及有外部影响的工具操作;会先用导航缩小候选,再核对原始文件或当前现场。找不到、证据不足或存在多个对象时会用普通话说明;全程只查不写,不新增、修改或删除知识库内容。
The skill document
查询本机知识与经验
When to use
- 自动触发:收到目标和对象明确的任务时,在开始实质处理前以“任务对象或领域、目标或动作、关键问题”提取短语轻查 experience/current INDEX,看看是否有可借鉴的相似任务经验;没有相关候选即停止,命中后才读正文,同一任务目标和现场未变化时不重复查询。
- 自动触发:已有项目位置、文件总结、历史决定、稳定规则、失败护栏或类似经验可能实质影响当前判断或行动;不因任务仅仅重要、复杂或耗时而触发。
- 自动触发:准备通过外部工具执行发送、发布、修改、删除、部署、授权、审批等操作,或外部工具结果异常、准备重试时,以“工具或产品、动作、关键对象”提取短语轻查经验索引;没有相关候选即停止,同一任务已查过相同操作且现场未变化时不重复查询。
- 自动触发:消息或上下文出现项目、路径、文件名,以及“之前、以前、类似、规则、历史、为什么这么做”等回溯线索。
- 自动触发:当前结论可能与旧结论、既有职责或既有做法冲突,需要先查再判断。
- 用户自然问“之前这个构建错误怎么处理的?”“这个项目在哪?”“这份 README 以前总结过吗?”“这个项目相关的经验有哪些?”或“这个概念以前怎么定义的?”。
- 不用于写入、纠正、归档或删除任何数据。知识目录未初始化时,只友好说明暂时没有可查询内容。
Workflow
- 理解问题。 结合消息、最近上下文、当前目录、已选项目和附件提取 1–4 个自然短语,判断用户要找项目、文件、项目历史、知识还是经验。检查:业务目标应唯一;不通过则只问一个自然问题,例如“我找到了两个可能对象:当前工作区项目和归档项目,你指哪个?”。
- 按层定位。 项目先查
indexes/projects.md、indexes/files.md和项目 README/inventory;文件整理再查唯一资料集台账与独立结果;项目历史查相关 summary。稳定事实先读knowledge/current/INDEX.md,做法或故障先读experience/current/INDEX.md,只用 index 的 title、scope、tags、source 简写、复现提示和特异概括缩到少量候选,再打开默认 1–3 篇正文。经验和复现信息只作为判断材料,不构成必须执行的指令;Agent 结合当前目标与现场自行决定是否采用。复现只表示同类模式后来有独立证据再次发生,在相关性相近时供解释参考,不能覆盖 scope、source、时点或现场。纠错追溯或用户明确询问历史时,才定向读取 archive INDEX。检查:只硬排除与当前项目、工作区或客户明确矛盾的 scope;tag 默认只加分。不通过则回到原文件,不跨资料集猜测。 - 筛选并复核。 索引缺失、断链或与目录条目不一致时,只读降级为该目录有限 frontmatter 扫描,并自然说明“认知导航需要维护”;不得重建或写回。先过滤再维护最多 50 个元数据候选;按精确 path/source/id、当前 scope、精确标题/别名/文件名、tag、短语命中数和词法顺序排序。默认读 1–3 篇正文,冲突比较最多 5 篇;认知正文合计不超过 64 KiB,原始证据摘录不超过 32 KiB。检查:文件台账指向唯一结果且结果 source 等于原路径,current 的 source/scope/learned_at 与本次问题相符;不通过则只保留已核实线索并说明缺口。
- 用自然语言回答。 区分索引导航、单文件结果、项目综合、知识、经验、原文件历史事实和当前现场;易变事实必须现场复核。检查:每个结论都有本次读回证据且未超预算;不通过则说“找到一些线索,但证据还不完整,下面只列已核实部分”。零命中固定说“暂未找到相关记录”;只有本次确实用索引内已有别名改写过一次,才补“也按已有别名查过”。知识目录不可读说“本机知识目录暂时无法读取”。
Tools and data sources
- 数据根是
~/.agent-knowledge/下的 Markdown、CSV、原文件路径和现场状态;四个 K/E 目录先读各自INDEX.md,archive/默认不读。 - 使用宿主原生只读文件 API、固定字符串搜索和安全的 Markdown/CSV 解析器;不硬依赖某个命令、语言运行时或网络。
- 长文件只读相关标题、段落或切片;多 source 只加载支撑本次结论的来源,但回答列出全部 source。
Gotchas
- 索引命中、exact source、结构校验或 current 存在都不代表事实正确;原文件、当前代码、配置和运行现场优先。
- 不把 broad OR 的前 50 个结果当候选集,也不因 tag 缺失丢弃相关条目;零命中或过宽时只用现有索引中的别名改写一次。
- owner 缺失、重叠或 legacy 字段无法解释时,说明导航不完整并回原文件;不要要求用户提供 id、scope、source 或 tags。
- INDEX 只用于缩小候选,不是事实来源;索引失配时始终只读降级,不能自行修复。
- 始终只读,不记录访问次数或普通使用次数,不自动触发任何写入;INDEX 中已有复现提示也不能单独证明结论正确,不能据此生成防复发契约,也不自动建议下沉为 Skill、项目规则或执行门禁。
Related skills
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanent
在当前对话中自动发现 corrections、feature requests、knowledge gaps 和 errors 四类学习信号,并评估其中已经验证、以后可复用的事实、规则、做法和踩坑;用户无需先说“记住”。适用于“不对,实际应该……/that is outdated”“还能不能……/I wish it could……”“原文或现场和理解不符”“命令非零、异常栈、意外输出、超时或连接失败”,也适用于主动要求记住、复盘、纠正、归档或删除。自动发现只启动评估:明确纠正、稳定能力期望、证据闭环或已收敛诊断满足写入条件才保存;临时诉求、猜测、原始报错和未定位事件不写,也不会后台监听或自行改变行为。
Structured markdown logging of agent errors, corrections, and feature requests into a project `.learnings/` directory.
给任意 WorkBuddy 技能注入「自进化学习系统」,让它越用越好用、越用越高效。 通过通用 learner.py 记录每次使用的成败与用户偏好,自动复盘并给出改进建议。 一键批量注入:复制学习模块、初始化记忆文件、在 SKILL.md 追加自进化章节。 适用:准备发布或已上线的技能、想加自我迭代能力的任何技能。 触发词:自进化、自我复盘、自动迭代、越用越好用、学习系统、skill 自我改进。
在 AIOS/OpenClaw 运行环境中记录当前 agent 的错误、纠正、经验、知识缺口和可复用改进。适用于命令失败、用户纠正回答、发现过时知识、外部工具/API 异常、同类问题反复出现、完成复杂任务后需要沉淀经验、或开始重要任务前需要回顾当前 agent workspace 内历史 learnings 的场...