insight

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   # 自动注入 hooks 到 ~/.claude/settings.json
omp remove skill insight    # 自动移除 hooks

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 — 所有参考文档的入口