Codex 任务上下文整理:事实清单、只读检查与开场模板

处理一个持续修改的项目时,需要先确认当前信息:最初说要改首页,后来改成只补帮助页;旧报错还在聊天里,代码却已经更新。直接说"继续",下一步该依据哪一份要求,并不总是清楚。我会先整理一份短记录,再让 Codex 对照当前项目核实。

这份记录是自己维护的任务资料。文件名没有特殊作用,保存后仍要在指令里明确提供路径。本文的模板与例子为独立整理;文中只读命令在 macOS 的本地 Git 工作树运行过,没有进行模型任务或跨会话恢复实测。

一张表,留下现在仍然有效的信息

OpenAI 的 Best practices 建议给任务说明目标、相关上下文、约束和完成条件。基于这个原则,我把记录整理成下面几项:

要记录什么 怎样写得能核对 常见混淆
当前目标 预期行为、交付文件、完成条件 把已取消方案当成待办
代码现场 工作目录、分支、当前提交 把旧聊天里的目录当作当前位置
有效约束 允许改哪里、必须保留什么 省略后来补充的限制
已确认事实 证据路径、命令结果、记录时间 把推测写成已经验证
下一步 缺什么证据、先检查哪一项 把所有历史日志全文塞进来

这里没有固定字数要求。短记录如果缺少当前目标,仍然不够用;长记录如果混着旧决定,也会增加核对成本。完整日志可以保留在合适的位置,记录里只说明与本任务有关的证据去哪里找。

先看当前项目,再整理记录

在准备处理的 Git 项目目录中,可以先做这些只读检查:

bash 复制代码
pwd
git status --short
git branch --show-current
git log -1 --oneline
git diff --stat
git diff --cached --stat

这些输出回答位置、提交和改动概况。两条 diff 统计分别覆盖未暂存和已暂存的已跟踪变化;未跟踪文件还要结合 status 看。统计也不能替代具体差异或分支范围检查。准备公开截图时,路径和文件名也要检查是否需要脱敏。

用一个虚构例子试填

假设现在只修帮助页的空状态文案,之前提过增加搜索框,后来已取消。记录可以写:目标是替换空状态文字;搜索框方案已取消;相关证据在帮助页文件和页面入口;构建尚未运行;下一步先核对文案与预期是否一致。

这段记录没有把旧方案删得无影无踪,也没有继续把它算作待办。上周另一个提交的构建成功,不能变成本轮的检查通过。这只是示例,不是某个修复已经完成的证明。

可以复制的开场要求

text 复制代码
请先读我指定的任务记录和项目说明。
先只读核对目录、分支、当前文件变化及证据。
列出与记录不一致的地方、有效约束和待确认项。
旧结论不要直接当作当前事实。
核对后从下一项最小检查继续,并记录实际结果。

如果仍在解决同一个连贯问题,可以在原会话补充记录。官方资料也建议连贯工作保留在同一会话;不必为了套用模板反复另开。目标已经独立变化时,再单独组织任务。

记录会过期。需求改变、代码起点改变或检查完成时,需要更新相应字段与时间;没有重新核对的结果就说明其范围。它能帮助下一步找到事实,不能恢复进程、登录态或所有对话状态。

完整记录模板与检查步骤见 任务上下文包。资料依据:OpenAI Best practices,核对日期为 2026-10-15。

相关推荐
打盹的小pig12 小时前
git pull 报错
git
Tairitsu_H1 天前
[版本控制器Git] Git 远程仓库 | 多人协作 | 企业级 Git Flow 开发模型
git·版本控制器·远程仓库
我先去打把游戏先1 天前
Git-Rebase使用指南-从原理到实战
服务器·git·嵌入式硬件·物联网·ubuntu
kaixin_learn_qt_ing1 天前
我有两个程序,它们在不同的项目中,但是它们复用了一部分头文件,它们在两个不同的git仓库中,有什么好的办法可以让它们复用吗?
git
greatofdream1 天前
git rebase时如何解决merge节点冲突问题
大数据·git·elasticsearch
敲敲敲-敲代码2 天前
git安装记录
git
我是人✓2 天前
Git入门:从零开始掌握分布式版本控制
分布式·git
Aurora_eye2 天前
Git 笔记
笔记·git
解道Jdon2 天前
FigCraft把Figma用Rust从零重写了一遍
ide·windows·git·svn·eclipse·github·visual studio