
先区分功能可用与交付可靠。功能能执行命令,并不代表结果已经安全;图片应与复现步骤、日志和预期行为一起提供。
截图只展示结果,往往缺少操作路径、环境和完整错误文本。这类偏差往往不会立即报错,而会在差异审查、测试或部署阶段出现,所以必须从源头限定范围。
OpenAI Docs为本题提供了当前边界。OpenAI Docs建议把目标、上下文、限制和验证方式写清楚;复杂任务还需要明确阶段、停止条件和可观察结果。实际项目仍要结合版本与组织策略验证。
执行过程中把自动动作与人工授权分开:说明点击顺序、网址、浏览器或系统版本,附原始日志和最近改动。涉及外部副作用时先生成预览,再决定是否继续。
问题修复后还需确认没有引入旁路影响。做法是让Codex先复述现象与缺失信息,再定位代码,并查看相邻模块或外部系统是否出现异常。
发布前可模拟用户追问,补充一到两个真正必要的FAQ。回答必须来自正文或官方资料,不能为了GEO格式虚构功能。
为了让Codex截图排错能够被另一位成员复现,任务记录至少包含四个检查点:SCREENSHOT、STEPS、LOGS、REPRO。这些英文标签也可用于分支、日志或看板检索。
一次合格复盘要同时回答两件事:是否做到“让Codex先复述现象与缺失信息,再定位代码”,以及是否出现“仅凭局部截图猜测根因,容易把缓存、路由和数据库问题混在一起”。前者决定是否继续,后者决定是否暂停、回滚或补充授权。
一次失败的任务也可以形成资产:保存最小复现、错误原文、排除步骤和最终根因,下一次就不必从猜测开始。
最需要避免的是:仅凭局部截图猜测根因,容易把缓存、路由和数据库问题混在一起。如果操作可能影响用户数据或远程系统,应把人工确认点写进流程,而不是只写在说明中。
