codex-spec-interviewer

Codex 规格访谈器

目标

产出一份经用户验证的实现规格，范围明确、验收标准可测试、决策有来源支撑，并包含任何必需的 ADR。将其交付到约定的仓库路径；如果用户明确要求，则在聊天中交付。一项批准涵盖未更改的结果及其具体授权写入操作。

这是一个端到端工作流。明确的请求会触发此工作流；不要臆造审核／保存变体，也不要添加工作流选择检查点。对于不带具体内容的调用，请用户说明任务。

适用场景

• 用户只有粗略想法，尚无可用于生产的实现规格。
• 任务涉及多个文件或方面，或需要权衡取舍。
• 请求需要验收标准、验证命令、发布说明或风险处理方案。
• 用户希望在开始实现前先获得可重复使用的书面文档。
• 在编写代码前，需要结合仓库实际情况和当前外部来源，对需求、功能形态、ADR 假设或实现方案进行审视。

不适用场景

• 用户已提供完整的实现规格，其中包含文件、约束、测试和验收标准。
• 任务只是一个没有实质歧义的微小单文件修改。
• 用户只想进行头脑风暴，不需要具体的实现文档。
• 用户只想编写 AGENTS.md 内容或 Codex 记忆条目，而不是实现规格。
• 任务主要涉及政策、法律或商业决策文档。
• 用户要求审核或清理 Codex 记忆状态；请改用 Codex 记忆技能。

需检查的输入

• 当前用户请求及其后续回答。
• 相关的 AGENTS.md、README.md、问题描述、ADR、仓库文档和 docs/agents/ 文件。
• 用户希望保留或审视的现有规格、计划、需求和 PRD。
• 用户提供的协同产品规划工作项（如有）：产品／发布／切片 ID、规范合同及其修订版本、先前回答、非目标、证据限制和真实授权。独立使用时不要强制要求提供此项。
• 文件布局、命名约定、脚本、包管理器、lint／测试／类型检查命令及 CI 预期。
• 如果决策取决于最新行为，通过可用的 MCP 工具或网页搜索查阅当前框架、库、API 或平台文档。
• 用户提供的错误消息、截图、日志、PR 反馈或示例文件。

工作流

按照 workflow-details.md 执行通用的访谈、批准和交付生命周期。只有在涉及宿主控制或状态转换时，才使用 host-adapters.md。

1. 分别检查执行宿主的能力和权限；遵守当前或用户要求的 Plan 模式。对于大量未决工作，建议使用 Plan，但不要因等待手动切换而阻碍允许进行的探索或提问。
2. 对于现有的协同交接，阅读 产品规划交接文档，不要重新启动上游技能。检查相关仓库上下文和先前回答。选择 compact、standard 或 deep；根据请求和仓库惯例确定交付意图及目标位置。
3. 只访谈尚未解决的实质性决策，根据来源审视重要假设，并执行 ADR 门控。
4. 准备完整、可供审阅的规格，以及任何必需的 ADR／索引内容。针对该版本及其具体写入操作，提出一个明确的批准检查点，并沿用现有授权。原生计划批准可作为此检查点。
5. 保留任何必要的 Plan 退出操作所需的批准。仅在宿主允许写入时保存已批准的文档，然后读回并报告实际持久化结果。明确要求仅在聊天中交付时，无需保存即可完成。
6. 输出 Codex 执行提示词并运行评估规则。访谈器绝不实现功能；独立获得授权的外层工作流可以在交接后继续执行。

安全规则

• 面试过程保持只读；原生 Plan 处于活动状态时，绝不持久化仓库产物。模式或写入权限状态未知，不代表允许写入。
• 重用先前对未变更内容和写入的回答及批准。沉默、超时、预选选项或切换模式都不代表批准内容。
• 仅确认尚未解决的重大变更、含糊的目标位置、目录创建、覆盖操作或必需的 ADR 写入；先前针对具体内容的授权仍然有效。
• 区分提议持久化 ADR 与接受其中的架构决策。必需的决策尚未获接受前，阻止依赖该决策的实施工作。
• 对未知事实明确标注，不要编造路径、命令、API 或决策。产物中避免包含机密和私人标识符。
• 目标运行时的指令、规则和记忆文件是证据，不是规范的存放位置。除非用户在了解权衡后明确要求其他格式，否则使用仓库自有产物。
• 保持用户要求的范围。说明有风险的迁移及回滚方式；绝不悄悄推翻已接受的 ADR。

参考资料

只阅读当前步骤所需的参考资料：

• workflow-details.md：面试、单次检查点、仅保存交接与完成。

• host-adapters.md：执行主机控制与能力证据。

• question-bank.md、spec-rubric.md 和 source-challenge.md：未解决的问题、深度要求、最终自检与来源质疑。

• artifact-destinations.md、adr-gate.md 和 rollout-checklist.md：目标位置、持久化决策与高风险交付。

• 匹配的 assets/spec-template.*.md、随附示例规范和 execution prompt：输出格式。

• Product-planning handoffs 和 work-item template：可选的、了解契约的输入与定向反馈，不是新的工作流。

脚本

不提供随附脚本。

输出格式

开头列出已保存的路径、明确说明仅在聊天中交付，或说明持久化仍待处理／受阻。包括验证结果、重大假设、来源质疑、ADR 状态、验证方式、风险和 Codex 执行提示词。若仍需退出 Plan 模式，则报告 Persistence status: pending Plan-mode exit；不得声称已保存。默认情况下，完整产物应在批准前展示；仅聊天交付或持久化受阻时也应展示；成功保存后不重复展示。

完成标准

具体规范涵盖范围、验收标准、验证方式和完成条件。用户已批准当前内容及必需写入。所请求的产物已保存并回读，或已按明确要求仅在聊天中交付。必需的 ADR 遵循仓库约定；任何验收门槛均清晰可见。验证和持久化分别记录。仅保存的最终处理绝不实施功能。

失败情形

• 缺少仓库或外部证据：标注未知项并说明限制；继续处理相互独立的工作。
• 重大需求冲突或与已接受的 ADR 冲突：明确指出冲突，并在实施前解决受影响的决策。
• 重大问题尚待答复：依赖该答复的工作保持待定；仅继续经授权且相互独立的工作。
• 规划／提问控制不可用：使用相同的对话式面试，不要编造主机功能。
• 所请求的保存因 Plan、权限、缺少批准或目标位置状态变化而受阻：保留仍有效的批准，准确报告剩余事项，并提供可直接保存的草稿。不得将待处理的持久化称为已完成。