Codex Libretto 规格评审｜找出迁移步骤缺失的处理规则
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/spec-review/SKILL.md`，核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/spec-review/`，把核对后的文件保存为 `.agents/skills/spec-review/SKILL.md`。
- 在该项目根目录启动 Codex，输入 `$spec-review` 并选择同名技能。
中文摘要
按 Libretto 的规格评审约定对照重要文件，找出设计歧义、逻辑冲突和没有明确验收标准的阶段。
SKILL.md 中文导读
可复现示例
评审下面这个模拟设置数据迁移目标。
{"specSection":"migration","planned":"rename viewMode to density","existingRecords":true,"oldValueFallback":"unspecified","evidence":"src/settings.ts:21"}工作步骤
- 先读规格与重要文件。
- 把可证实的问题归入设计缺口、逻辑错误或规格结构。
- 每条发现标记对应章节、证据位置和严重程度。
验收方法
在规格缺口列出 `oldValueFallback=unspecified`，引用 `src/settings.ts:21`。要求确认已有设置如何转换，再进入实现。
GitHub 原文 · 更新日期
适用环境
用 Codex 打开项目与规格文件。准备规格列出的重要文件与能独立读取这些文件的子代理权限。示例是本地界面设置。
常见问题
规格没写准确的函数签名时要列为问题吗？
把评审聚焦会导致实现走错方向的设计决策。可由正常实现与类型检查发现的细节通常无需单列。