| name | insight |
| description | 项目记忆系统。回忆/回顾经验教训(recall),提取/记住对话经验(capture), 提炼洞察模式(evaluate),查看记录(list)。 |
Insight Skill
直接执行(不需要推理,直接跑命令)
| 用户意图 | 命令 |
|---|
| 回忆/想起/回顾 经验、教训、踩坑 | omp insight recall --source . --format md --budget 4096 |
| 提取/记住/保存 当前对话经验 | omp insight capture --source . |
| 提炼/归纳/总结 洞察模式 | omp insight evaluate --source . |
| 查看/列出 记忆或洞察 | omp insight list --source . |
| 提升 memory 为 insight | omp insight promote <id> --reason "<text>" |
| 降级 insight | omp insight degrade <id> --reason "<text>" |
| 删除记录 | omp insight delete <id> |
规则:收到用户意图后直接执行对应命令,不需要先搜索文件、检查命令是否存在、或阅读其他文档。
不确定参数时,先运行 omp insight <subcommand> --help 查看完整用法。
自动化(Hook 集成)
安装 Insight skill 后自动注入 Claude Code hooks,无需额外配置。
触发时机
| Hook 事件 | 行为 | 模式 |
|---|
| SessionStart | recall — 召回记忆注入 additionalContext | 同步 |
| PostCompact | capture — 从对话中增量提取记忆 | 异步 |
| Stop | capture --if-no-compact — 短会话兜底 | 异步 |
安装/卸载
omp install skill insight
omp remove skill insight
hooks 安装使用安全写入流程(backup → tmp → verify → copy back),失败不影响 skill 本身的使用。
Recall 输出格式
Hook 模式下 recall 使用 ## Insight Memory 命名空间,每条记忆附带元数据:
## Insight Memory
- **pattern** → action [confidence:0.8 | age:2mo | evidence:5]
- [preference] 内容 [confidence:0.7 | age:1mo | hits:3]
参考文档(按需加载)
需要深入理解内部机制时,加载对应文档:
- 数据结构:
references/insight-schema.md — memory/insight 的字段定义和 YAML 格式
- 提取流程:
references/extraction-flow.md — capture/evaluate 的完整处理流程
- 消费协议:
references/consumption-protocol.md — 其他 Agent 集成 insight 的协议
- 文档索引:
references/README.md — 所有参考文档的入口