用途:在开始项目会话、离开一段时间后返回、或进行重大改动前,帮助代理先全面理解仓库上下文,避免因信息不足而犯错。
主要能力与流程:
- 检索记忆:在 Total Recall 中搜索项目相关上下文,查询词可包含项目名、关键词、近期工作与已做决策,max_results 设为 15。Claude Code 使用 mcp__plugin_totalrecall_memory-total-recall__synthesis_search,Codex 或其他环境使用 totalrecall.synthesis_search。关注近期对话、已做决策、已解决问题、既定模式与发现的坑。
- 深度调查:通过 teams(action: 'delegate', tasks: [{text: '...', assignee: 'oracle'}]) 委派 Oracle 收集深度上下文;若 teams 不可用,则自行调查。调查清单包括:项目身份(读 AGENTS.md、README.md、package.json 等,明确项目用途、核心技术、模式与约定)、当前工作状态(tk list --tag plan、tk list、git status、git log -10 --oneline)、决策历史(tk list --tag decision)、架构概览(关键目录、核心模块、数据流)、痛点与上下文(TODO、FIXME、HACK、KNOWN_ISSUES、TROUBLESHOOTING、技术债标记)。
- 汇总报告:按项目摘要、当前状态、关键决策、既定模式、约定与约束、建议下一步的格式输出,并向用户总结关键发现、提示紧急或阻塞事项、确认优先级、询问是否缺少特定上下文。
适用场景:新会话开始、久别重返项目、重大改动前、对项目状态不确定时、其他开发者改动之后。
限制:依赖 Total Recall 与 teams/Oracle 等工具,若不可用需手动调查;资料未提供具体安装方式、收费、价格、平台支持或效果保证。