一、把会话当作任务边界
一个 Session 最好围绕一个目标展开。需求分析、实现、测试和发布可以有关联，但不应把无关项目、完整日志和大量历史对话全部混在一个上下文里。
二、开始前记录状态
pwd
git branch --show-current
git status --short
node --version
pi --help这些命令用于确认当前目录、分支、工作区和版本。具体 Pi 命令以本机帮助输出为准。
三、上下文过长时如何处理
- 先总结已确认事实、未决问题和下一步验收标准。
- 移除不再需要的长日志和重复输出。
- 把大任务拆成独立子任务，每个任务保留输入和结果。
- 对大型文件只提供相关片段和路径，不要无差别加载全部内容。
四、保存可恢复状态
重要状态应放在项目可审查的文档、Issue 或提交中，而不是只留在会话记忆里。不要把 API Key、Cookie、storage state 或个人数据写进摘要。
五、故障排查表
| 现象 | 检查方向 |
|---|---|
| Agent 重复做同一件事 | 目标是否过宽、验收条件是否缺失、上下文是否混乱 |
| 回答忽略前文 | 上下文长度、摘要质量、关键文件是否重新提供 |
| 恢复后状态不一致 | 分支、文件差异、Session 记录和外部状态 |
Pi 的 Session 存储、上下文参数和命令可能随版本变化。本文是通用管理方法，不代表特定版本的接口承诺。
