用途:还原某个已交付产物(功能、PR、演示、重构、报告等)背后的工作流程,把提交、会话、轮次、技能和工具轨迹连成一段简短的“它是怎么做出来的”叙述。适用于用户问“X 是怎么构建的”“这个产物背后的流程是什么”,锚点可以是 commit SHA、日期、功能名、PR、会话或仓库内产物。不用于通用活动摘要,那种情况应使用普通会话列表。
前提与限制:需已安装 ax、在 PATH 中可用,并能连接其本地数据库。若无法连接数据库,应报告连接失败并停止,不要凭记忆猜测。只能看到 ax 已摄入的会话、提交、技能和工具轨迹;当提供方缺失工具输出、成本或推理数据时,会话数据可能不完整。它还原的是流程而非正确性,做工程决策仍需检查代码并运行项目检查。
使用方式:先解析锚点,再用只读检查命令,例如 ax recall "live ingest dashboard" --sources=turn,commit,skill --scope=here、ax sessions near abc1234 --json、ax sessions around 2026-06-15 --days=3 --json、ax sessions here --days=14。随后挑选最相关的会话,必要时让用户确认候选;再查看会话轨迹,如 ax sessions show <session-id> --json、ax sessions show <session-id> --by-role、ax recall "specific keyword from the artifact" --sources=turn,commit --scope=here,关注技能顺序、用户澄清的约束、改变方向的文件与测试、关键工具或子智能体轨迹、以及验收前的验证步骤。最后写简短、有证据的还原:锚点、4 至 8 步有序流程、关键决策、验证、可复现要点;尽量引用会话 ID、commit SHA 和文件路径。
安全:不要上传私人转录、会话日志、提示、工具输出或本地数据库导出;摘要中脱敏密钥、令牌、客户数据、文件内容和私密对话;除非用户明确要求另行维护操作,否则只用只读的 ax 检查命令,不修改 .ax/、不重建索引、不发布报告、不改动仓库。