用途:该技能让 AI 知道存在 trellis mem 这一跨会话记忆检索能力,并在合适时机主动调用。它本身不是固定工作流,没有强制输出文件或写回步骤,是否使用及如何使用由对话当下判断。
主要能力:trellis mem 是本地 CLI,索引用户过往的 Claude Code、Codex、Devin CLI、Grok、OpenCode、Pi Agent、ZCode 对话日志,支持列出、搜索、按 Trellis 任务边界切片、导出清洗后的对话。各平台日志路径不同,例如 Claude 与 Codex 使用 ~/.claude/projects/ 和 ~/.codex/sessions/,Devin CLI 使用 ~/.local/share/devin/cli/sessions.db,Grok 使用 ~/.grok/sessions/,OpenCode 使用 ~/.local/share/opencode/opencode.db,ZCode 使用 ~/.zcode/cli/db/db.sqlite。所有读取均为本地,不上传。
使用方式:常见命令包括 trellis mem search "<keyword>"(默认项目范围,加 --global 搜索全机)、trellis mem extract <session-id> --phase brainstorm、trellis mem extract <session-id> --grep "<keyword>"、trellis mem context <session-id> --turns 3 --around 2,以及 trellis mem list --cwd <project-path> 和 trellis mem projects。--phase 支持 brainstorm|implement|all,按 task.py create 与 start 边界切片,默认 all。
适用场景:重新开始旧领域任务前确认是否已有决策;调试似曾相识的 bug;用户说“继续上次的”但未指明;检索只存在于旧讨论中的决策;用户明确要求复盘;跨会话发现重复错误模式。
限制:若相关上下文已在当前对话、prd.md、design.md、git log 或打开文件中,或用户问的是代码事实而非历史对话,或处于子代理且已带上下文,或用户明确要求不要翻历史,则不应调用。mem 不编辑代码或文件,对平台 JSONL 存储只读,不推送或同步远程;它不替代 trellis-update-spec 或平台原生任务/规范工作流。返回结果如何处理由当下判断,可引用、建议更新文档或仅吸收。