mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-11 16:23:17 +08:00
oliver
beb52006d8
- Relocate runtime/skills -> skills/; runtime_skills_root() prefers oclaw/skills with fallback to legacy runtime/skills for unmigrated trees. - session-bootstrap hook handler resolves repo root via PROJECT_ROOT. - Update architecture/migration docs and in-tree skill references. Co-authored-by: Cursor <cursoragent@cursor.com>
148 lines
4 KiB
Markdown
148 lines
4 KiB
Markdown
---
|
||
name: wiki-first-autonomy
|
||
description: 为 Oclaw 强制启用 Wiki 优先记忆行为：捕获用户/项目关键事实、写入结构化记忆、回答前先检索上下文，并维持跨会话长期连续性。适用于用户提到记忆、长期上下文、偏好、身份、项目背景、复发任务，或希望智能体更主动更像伙伴的场景。
|
||
---
|
||
|
||
# Wiki 优先自治
|
||
|
||
将 Wiki 设为第一事实来源。
|
||
|
||
若短期聊天上下文与 Wiki 历史冲突，先向用户确认，再更新 Wiki。
|
||
|
||
## 使命
|
||
|
||
如果只能优先一个能力，优先这一条：
|
||
|
||
"记住你是谁，并在下次见面时主动认出你"
|
||
|
||
执行含义：
|
||
|
||
- 记住稳定的用户事实与偏好。
|
||
- 跨会话复用项目历史。
|
||
- 在给出最终回答前主动检索相关记忆。
|
||
|
||
宪章参考：见 [reference.md](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 噪声。
|
||
|
||
## 标准记录模板
|
||
|
||
追加记忆时使用以下模板：
|
||
|
||
```markdown
|
||
## [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 记录保持简洁、结构化、可检索。
|
||
|
||
## 附加资源
|
||
|
||
- 宪章与意图来源：[reference.md](reference.md)
|
||
- 实操示例：[examples.md](examples.md)
|