cursor-spec-interviewer

Cursor 规格访谈

目标

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

这是一个端到端工作流。清晰的请求会触发此工作流；不要自行创建评审／保存变体，也不要增加工作流选择检查点。对于未说明具体任务的直接调用，请用户说明任务。

适用场景

• 用户有一个初步想法，但还没有可用于生产的实现规格。
• 任务涉及多个文件或关注点，或需要权衡决策。
• 请求需要验收标准、验证命令、发布说明或风险处理方案。
• 用户希望在开始实现之前先准备一份可复用的书面文档。
• 在编写代码之前，需要根据仓库实际情况和最新外部资料，对需求、功能形态、ADR 假设或实现方案进行审视。

不适用场景

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

需要检查的输入

• 当前用户请求及任何后续回答。
• 相关的 AGENTS.md、.cursor/rules/**/*.mdc、README.md、问题描述、ADR、仓库文档和 docs/agents/ 文件。
• 用户希望保留或审视的现有规格、计划、需求和 PRD。
• 文件布局、命名约定、脚本、包管理器、lint／测试／类型检查命令及 CI 预期。
• 如果某项决策取决于最新行为，则通过可用的 MCP 工具或网页搜索查阅当前框架、库、API 或平台文档。
• 用户提供的错误消息、截图、日志、PR 反馈或示例文件。
• 仅当规格依赖本地 Cursor 技能的行为时，才检查 Cursor 项目技能目录，例如 .agents/skills/ 或 .cursor/skills/。

工作流

对于通用访谈、批准和交付流程，请遵循 workflow-details.md。仅当涉及宿主控制或状态转换时，才使用 host-adapters.md。

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

安全规则

• 在原生 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、捆绑的示例规范和执行提示词：输出格式。

脚本

未提供捆绑脚本。

输出格式

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

完成标准

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

失败情形

• 缺少仓库或外部证据：标注未知信息并说明限制；继续独立的工作。
• 实质性要求或已接受的 ADR 相互冲突：明确指出冲突，并在实现前解决相关决策。
• 实质性答案待定：依赖该答案的工作保持待定；仅继续已获授权且不依赖该答案的工作。
• 规划／提问控制不可用：使用相同的对话式访谈，不要捏造主机功能。
• 由于 Plan、权限、缺少批准或目标位置状态发生变化，导致所请求的保存受阻：保留仍然有效的批准，准确报告尚待处理的事项，并提供可直接保存的草稿。不得将待处理的持久化称为已完成。