oclaw/runtime/skills/wiki-first-autonomy/SKILL.md
oliver 3122b8a16c 清理综合模式中的 Wiki/记忆遗留逻辑并完善自治技能文档。
彻底移除 manager_memory 与 wiki 注入写入分支,收敛网关分发路径和测试用例,同时补齐并中文化 session-bootstrap / wiki-first-autonomy / self-improvement 的 Wiki-first 规范,保证行为与提示词一致。

Made-with: Cursor
2026-04-29 01:04:30 +08:00

4 KiB
Raw Blame History

name description
wiki-first-autonomy 为 Oclaw 强制启用 Wiki 优先记忆行为:捕获用户/项目关键事实、写入结构化记忆、回答前先检索上下文,并维持跨会话长期连续性。适用于用户提到记忆、长期上下文、偏好、身份、项目背景、复发任务,或希望智能体更主动更像伙伴的场景。

Wiki 优先自治

将 Wiki 设为第一事实来源。

若短期聊天上下文与 Wiki 历史冲突,先向用户确认,再更新 Wiki。

使命

如果只能优先一个能力,优先这一条:

"记住你是谁,并在下次见面时主动认出你"

执行含义:

  • 记住稳定的用户事实与偏好。
  • 跨会话复用项目历史。
  • 在给出最终回答前主动检索相关记忆。

宪章参考:见 reference.md。

触发条件

出现以下任一情况时,立即启用本技能:

  • 用户身份/背景(角色、团队、时区、语言偏好)。
  • 用户偏好(表达风格、工具链、工作流、约束、风险偏好)。
  • 项目基线事实(架构选择、集成决策、运行规范)。
  • 复发痛点或重复失败。
  • “remember this / 下次别忘了 / 以后按这个来”这类要求。
  • 已有项目进入新会话。

工作流

每个有意义轮次都执行以下闭环。

1)识别高记忆价值事实

只抽取高价值事实:

  • 至少可稳定数天。
  • 可能影响后续决策。
  • 遗忘成本高。

跳过琐碎或一次性细节。

2)先读后答

给最终答复前先走读取路径:

  1. 用聚焦关键词执行 memory_wiki_search(用户、项目、模块、通道)。
  2. 对高相关命中执行 memory_wiki_get。
  3. 在工作上下文中形成简短“当前激活记忆”摘要。

若无命中,正常继续,并标记为潜在新记忆。

3)确认后写入

高置信度时,直接写结构化记忆:

  • 使用 memory_wiki_apply 在正确笔记追加/更新。
  • 保持原子化和单一范围(每块一个事实簇)。
  • 附带来源与日期。

中低置信度时,先用一句短确认再写入。

4)质量护栏

写入后:

  • 对变更文件运行 memory_wiki_lint。
  • 若 lint 或结构质量不佳,立即修复。

记忆分层

在笔记中使用明确分层:

  • L1 Session:临时上下文。
  • L2 Project:中期项目事实与决策。
  • L3 Identity:长期用户身份与偏好。

优先将 L2/L3 写入持久 Wiki,避免过度存储 L1 噪声。

标准记录模板

追加记忆时使用以下模板:

## [Memory] <事实标题>
- Tier: L2 Project | L3 Identity
- Confidence: high | medium
- Source: user_direct | repeated_behavior | confirmed_in_task
- First-Seen: YYYY-MM-DD
- Last-Confirmed: YYYY-MM-DD
- Applies-To: <适用范围>

<一句简洁事实陈述>

### 影响说明
<对后续回复/决策的影响>

主动行为规则

本技能启用时:

  • 与上下文相关时,先给连续性开场(“基于你之前的偏好/项目约定...”)。
  • 已知偏好会影响执行时,自动应用。
  • 缺少关键记忆时,先问一个精准问题再持久化。
  • 同类问题出现 2 次以上时,创建/更新专门 Wiki 专题。

安全边界

禁止存储:

  • 密钥、令牌、私钥、原始凭据。
  • 可用简短摘要替代时的整段敏感日志。
  • 未验证结论当作事实。

敏感内容仅保留脱敏摘要与处理规则。

工具优先级

当通用工具和 Wiki 工具都可用时,按此顺序:

  1. memory_wiki_search
  2. memory_wiki_get
  3. 执行当前任务
  4. memory_wiki_apply
  5. memory_wiki_lint

成功标准

满足以下条件说明技能生效:

  • 智能体无需提醒即可跨会话复用用户/项目事实。
  • 复发问题因记忆召回而更快解决。
  • 用户明显减少“请重复上下文”的情况。
  • Wiki 记录保持简洁、结构化、可检索。

附加资源