handoff

用户希望继续工作。可选的 cwd 覆盖项：$ARGUMENTS

快速开始

memory_sessions { "project": "<current-project-id>", "limit": 20 }

选择 cwd 与此项目匹配的最新会话，然后调用： memory_recall { "query": "<会话的核心概念>", "project": "<当前项目 ID>", "limit": 10 }。 如果指定了 Agent，请在两次调用中传入相同的 agentId。

预期输出：

Resuming 7f3a9c2 "Auth refresh rework".
Open question: should logout revoke all device tokens or just the current one?
Next step: decide revoke scope, then update auth/logout.ts.

原因

按目录边界匹配会话，而不是按原始前缀匹配，以免误把相邻仓库识别为当前仓库。对于空会话，绝不虚构观察结果。

工作流

1. 解析项目路径：如果提供了 $ARGUMENTS，将其规范化为绝对路径（path.resolve(process.cwd(), $ARGUMENTS)）；否则使用 cwd。
2. 如果已知确切的项目标识符，使用它调用 memory_sessions；如果指定了 agentId，也一并传入。否则，持续跟进 nextCursor，直到找到目录匹配项或分页结束。翻页时保留筛选条件。选择 cwd 规范化后按目录边界匹配的最新会话：相等，或 cwd.startsWith(projectPath + sep)，或 projectPath.startsWith(cwd + sep)。优先选择 completed 而不是 abandoned 的会话。没有匹配项：说明此项目没有匹配的会话，然后停止。不要替换为其他项目的会话。
3. 如果会话以一个尚未回答、面向用户的问题结束，先显示该问题。查看 summary 或最近的 conversation 观察结果中以 ? 结尾的 narrative。
4. 总结标题/摘要、关键文件、关键决策或错误；使用 memory_recall 查询核心概念，limit 设为 10，并保留所选项目和 Agent 范围。纳入结果前，检查每个结果的会话或项目来源；仅凭查询无法确保范围正确。
5. 最后给出一个具体的“下一步？”指引。

反模式

错误：session.cwd.startsWith(projectPath) 会在项目路径为 /repo-a 时匹配 /repo-a-staging，从而恢复错误仓库的会话。

正确：session.cwd === projectPath || session.cwd.startsWith(projectPath + sep)，这是目录边界检查，不会跨到相邻仓库。

检查清单

• cwd 覆盖项已解析为绝对规范化路径。
• 匹配使用了目录边界检查，而不是原始前缀。
• 如有未回答的问题，该问题位于回复开头。
• 清楚说明空会话，并提出从头开始。

另请参阅

• recap、session-history、recall：使用相同的会话数据，提供更全面的视图。

故障排除

如果 memory_sessions 或 memory_recall 不可用，请参阅 TROUBLESHOOTING.md。