用一张交接卡接回 AI 编程任务

使用 AI 辅助编写与复核。

本文目录

一张有用的交接卡,应让你看清任务目标、当前材料的位置、已经确定的决策,以及下一步该做什么。把它与原始会话和文件放在一起,回来时就能从明确的检查点继续,无需靠记忆重建整个任务。

这是一种手工记笔记的方法。你可以把卡片放进纯文本文件、项目笔记或会话中,不依赖某个应用自动转移上下文。

留下会影响下一步的状态

完整会话通常比接手者需要的信息多得多;简短摘要又可能漏掉最关键的一点。交接卡介于两者之间:它是通往任务、决策和证据的简洁索引。

例如,“首页快做完了”可能指设计草稿、代码改动,也可能指已经发布的页面。更有用的检查点是:“草稿里已有一个标题修改方案,窄屏布局还没检查;下一步在目标宽度下查看效果。”

尽量留下具体引用。单独一个文件路径未必能确定你看的是哪个版本;一张截图也未必能指明背后的代码。记录足够的上下文,让人能够再次找到同一份材料。

复制这张交接卡

任务:
[用一句话说明希望得到的结果。]

项目与会话:
[项目名、会话标题,以及真实链接或引用。]

当前材料:
[文件、补丁、文档或设计引用;必要时注明版本。]

已确定的决策:
- [...]

仍待决定:
- [...]

最近检查的结果:
[实际查看或运行了什么,证据记录在哪里。]
[如果还没有:“尚未检查。”]

当前阶段:
[分析 / 草稿 / 改动提案 / 已检查的改动 / 已发布的结果。]

下一步:
[从这个检查点出发,要做的一件事。]

保持不变:
[重要的范围、行为或任务约束。]

回来先检查:
[离开期间,什么可能已经发生变化?]

这些字段各有用途:

字段 为什么值得保留
任务 说明要达成的结果,而不只是一个话题
项目与会话 指回这项工作的原始上下文
当前材料 让摘要中的内容可以被查看核对
已确定的决策 避免把一个提议当成已经选定的方案
仍待决定 保留需要回答、不能靠猜的问题
最近检查的结果 分清一个说法和支持它的证据
下一步 减少恢复工作时重新梳理的负担
回来先检查 考虑笔记写下之后可能发生的变化

不要把凭据、私人内容和无关日志放进卡片。引用已有的合适位置即可,无需把整个项目复制进交接笔记。

示例一:接回一项界面修改

下面两张卡片是虚构教学示例,不是真实项目完成记录或产品运行结果。

任务:
让 Harbor 首页的主要操作在窄屏下保持清晰可读。

项目与会话:
Harbor 网站 / 首页布局 / 虚构任务 H-17。

当前材料:
示例引用:H-17 布局草稿第 1 版,hero-layout.diff。
补丁提议调整首屏主要操作的布局。

已确定的决策:
- 保留现有标题和操作文案。
- 首屏只保留一个主要操作。

仍待决定:
- 操作区域应该换行,还是单独占一行。

最近检查的结果:
本示例没有记录渲染后的布局检查。

当前阶段:
改动提案。

下一步:
在项目的目标宽度下比较两种布局方案。

保持不变:
不修改价格文案,也不修改操作跳转的目标。

回来先检查:
确认工作分支中仍然包含这份改动提案。

这张卡把下一步定为布局比较,没有把尚未查看效果的补丁变成“页面已完成”。它也保留了两类信息的区别:布局选择仍未确定,现有文案则应保持不变。

可以据此写一条恢复请求:

“按这张交接卡继续 Harbor 首页布局任务。先查看当前改动,确认标题和操作目标。然后在我们的目标宽度下,比较换行与单独占一行两种方案,给出建议。保持文案不变。”

示例二:接回一项技术调查

任务:
为 Cedar 的临时连接失败选择一种重试方案。

项目与会话:
Cedar 服务 / 重试方案比较 / 虚构任务 C-04。

当前材料:
示例引用:retry-options.md,第 2 版草稿。
其中比较了固定间隔与逐步增加间隔两种方式。

已确定的决策:
- 当前阶段比较设计,不实施改动。
- 最终设计必须说明何时停止重试。

仍待决定:
- 哪些失败情况可以再试一次。
- 客户端应如何报告无法继续的失败。

最近检查的结果:
本示例不包含实现或运行测试。

当前阶段:
分析。

下一步:
围绕上面两个待定问题比较两种方案。

保持不变:
暂不修改服务的重试设置。

回来先检查:
查看是否有更新的需求笔记改变了失败场景。

这里最值得交接的是决策边界,而不只是代码位置。仅说“继续”,可能让后续工作在失败场景还没确定时,就开始实施。

用交接卡写一条明确的恢复消息

继续 [项目/会话] 中的 [任务]。
以 [材料引用] 为检查点,先核对它的当前状态。
保留这些已确定的决策:[...]
接下来解决这个待定问题:[...]
本次要求的下一步行动是:[...]
如果材料或需求已经变化,请先说明差异。

回来时,打开原始工作,与卡片逐项对照。如果两者不一致,就根据当前文件和会话更新笔记,而不是选择听起来更自信的那份摘要。交接卡帮助你找到证据,不能代替证据。

下次中断前,更新卡片的当前阶段和下一步。维护一张简短、及时的卡片,比继续往过时摘要后面追加一段话更有用。

在 CueSpec 工作流中,回复前可先阅读最新回答,并核对目标会话。只要工具允许保存笔记和原始工作的引用,就可以使用同样的交接字段。