Agent 指南 · 决策门始终由你掌握
提出目标，审视过程，再作决定
Agent 在打开的故事项目中工作。它可以读取 Lattice 源码、使用故事专用技能、提出聚焦的问题、在行动模式中编辑文件，并展示校验结果。创作方向由你决定，每份计划是否继续也由你把关。
保留现有开篇，并补充校验证据。
添加局部或全局意见，再批准计划或要求修订。
放慢揭示节奏，并保留玛拉的不确定感。
把意见锚定到选中的正文，或完整的对白条目。
现在调整方向 · 稍后继续处理
调整当前工作的方向，或排入完成之后再做的任务。
用行动模式处理直接任务
行动模式是默认模式。给出结果、重要约束和预期证据：
收紧
opening里的对白，不要修改任何 Block ID 或路径目标。校验故事，并概述改动。
边界具体的请求能帮助 Agent 保留真正重要的内容。你不必规定它要执行哪些文件操作；描述完成时应该满足什么即可。
任务边界清楚、可逆，而且适合立即实施时，使用行动模式。希望修改任何文件之前先审方案时，使用计划模式。
用计划模式处理重要改动
计划模式开关只作用于下一条提交的请求。在这一轮里，Agent 可以读取、搜索、分析故事、提问并建立任务清单，但不能编辑项目文件。
以下场景适合先做计划：
- 新增或重构一条 CYOA 路线；
- 引入 State、Pool 或多个 Module；
- 把源码拆分到多个文件；
- 协调存在重要创作取舍的修改；
- 开始前先约定怎样才算完成。
一轮计划如何进行
- Agent 检查项目。
提出方案前，先读取当前源码和相关结构。 - 解决会影响结果的歧义。
通过聚焦的问题组确认那些会实质改变结果的选择。 - 建立清晰的检查清单。
完整计划保留在会话中，侧栏用于展示进度。 - 打开计划审阅。
在嵌入的审阅标签页里添加批注、批准、要求修改，或暂不决定。 - Agent 只执行你批准的计划。
计划发生变化时，会在开始工作前再次交给你审阅。
关闭计划审阅既不代表批准，也不代表拒绝，待审标签页仍会保留。如果已有未完成清单，又开始新的计划请求，TypeApe 会先确认是否替换；旧任务仍保留在会话历史里。
给计划添加批注
计划批注用于在源码变更之前检查工作方式：
- 某一步错误或不够清楚时，把局部意见附在计划的相关位置。
- 反馈会改变整份计划时，添加全局意见。
- 需要再调整时选择要求修改。Agent 会带着修改后的清单回来供你审阅。
- 步骤、边界和预期结果都合适时选择批准。批准时也可以补充最后的指导。
批准只适用于屏幕上的这份计划。计划被编辑或替换后，TypeApe 会再次请你确认。
在故事中留下阅读批注
阅读批注从实际体验到的故事出发，而不是从文件路径出发。
- 选中精确正文，把批注标记锚定到引用旁；也可以不选择文本，直接激活段落或对白标记，批注完整条目。
- 写下明确的修改意见并保存这条批注。
- 继续阅读和记录；每张卡片都会保留引用与 Block 语境。
- 所有批注都保存后，选择发送批注给 Agent。
TypeApe 会新建一段 Agent 会话，并把整次审阅一起交给它。引用的故事文本只用于定位批注，不会被当成指令。Agent 随后读取项目文件、完成修改并校验结果。
尚未提交的阅读批注是临时内容。重新开始或离开故事、切换项目、关闭 TypeApe 都会清空它们。发送批注后，Agent 会话会长期保留这次审阅记录。
在 Agent 运行时调整工作
运行期间仍然可以使用输入框。根据意图选择投递方式：
| 意图 | 快捷键 | 投递方式 |
|---|---|---|
| 改变当前方向 | Enter | 调整方向会等待当前工具调用结束，然后改变同一轮工作。 |
| 完成后再做另一件事 | Alt/Option + Enter | 后续任务会等待当前工作完全结束。 |
| 把排队内容放回输入框 | Alt/Option + ↑ | 先恢复“调整方向”，再恢复“后续任务”，可编辑后重新提交。 |
停止运行前也会先恢复排队文本。“保留现有叙述者”适合调整当前方向；“校验后再给出三个标题”则适合作为独立的后续任务。
问题、证据与恢复
Agent 需要重要决定时，请在产品内问答界面作答；相关问题会逐个出现，最后一起提交。如果执行或修订失败，会话和清单会保留清晰状态，你可以重试。修订失败后，输入框会回到规划模式；在这里发送边界更窄的指令，会把它追加到已有反馈并重试同一份计划。
接受故事修改前，至少检查三件事：
- 哪些文件或故事概念发生了变化；
- 解析器与校验器结果，包括你已经检查过的警告；
- 读者现在实际能够体验什么。
想亲自检查源码时，回到 Lattice 语言指南。