跳到主要内容
版本:Future

日常工作流

Engram 日常循环故意设计得很简单:在开始时加载内存,在需要时进行搜索,在出现持久内容时保存,并在结束时进行审计。

启动会话

/engram load --for-agents "当前任务"

或者从终端运行:

engram load --for-agents "<任务>"

Agent 应当回复一条紧凑的计数行,例如 Engram loaded: 8 memories / 24 total related memories.,除非人类要求提供 ID、规则或原始输出。

在工作期间

当任务改变或你怀疑缺少项目知识时进行搜索:

/engram search "我可能缺失的主题"

预览哪些内存文件将被路由而不打印其内容:

engram load --dry-run "<查询>"

返回每个可见的路由匹配,而不是紧凑限制:

engram load --all "<查询>"

保存一个持久事实

/engram save knowledge

engram save 捕获最佳的单个内存候选,自动更新匹配的内存或创建新内存,并在写入前始终显示 A/B/C 审批门。

保存一个会话的多个内存

/engram save-session
/engram ss

提供此形式的候选:

TYPE: rule | TEXT: Always run tests before release. | CONTEXT: Created from release planning so future agents preserve the test gate.
TYPE: knowledge | TEXT: Release notes live in CHANGELOG.md.
TYPE: workflow | TEXT: When releasing, run tests, update changelog, then tag.

CONTEXT: ... 是可选的。仅在解释内存存在的原因时添加它。

挖掘最近的聊天记录

/engram save-session --query-level 3
/engram ss -a last 50 sessions

--query-level 必须是正整数。Agent 可以使用多达该数量的最近的人与 Agent 的聊天会话(包括当前会话),且不得编造不可用的历史记录。

接受全部快捷方式

/engram ss -a

-a 意味着人类明确批准 Agent 推荐的每个候选。除非人类要求,否则 Agent 不得添加 --accept-all

当“接受全部”运行在写入前报告相关内存时,说明尚未保存任何文件。Agent 应当使用结构化候选重新运行:

TYPE: rule | TEXT: OAuth rotation follows release foundations. | DEPENDS_ON: release-foundation | LEVEL: advanced
TYPE: knowledge | TEXT: Invoice retries use exponential backoff. | UPDATE: invoice-retry-baseline

角色路由 (Role routing)

保存特定角色的内存:

engram save --role frontend ...
engram save-session --role backend ...

调整角色路由:

engram set-role frontend
engram set-role backend security
engram set-role

engram set-role ...engram set-rule-variant ... 成功时,CLI 返回一行 Agent action:。支持 Engram 的斜杠适配器和 MCP 主机应立即重新运行 engram load "<当前任务/请求>" 并将该结果视为替换先前加载的 Engram 上下文。

结束有意义的工作

Check Engram health, report invalid memories, and propose anything worth saving from this session.

常用命令:

engram upgrade
engram verify
engram repair
engram graph "<主题>"
engram quality-check
engram archive --reason "<原因>" <id或文件>

下一步