claude-spec-interviewer

Claude 规格访谈员

目标

生成一份经用户确认的实现规格，明确范围、制定可测试的验收标准、为决策提供来源依据、进行验证，并包含所有必需的 ADR。将其交付到约定的代码库路径；如果用户明确要求，则在聊天中交付。一次批准即涵盖未更改的结果及其明确获准的写入操作。

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

适用场景

• 用户有一个粗略想法，但还没有可用于生产的实现规格。
• 任务涉及多个文件或方面，或需要权衡决策。
• 请求需要验收标准、验证命令、推出说明或风险处理方案。
• 用户希望在开始实现之前先准备一份可复用的书面文档。
• 用户调用 /claude-spec-interviewer，或要求 Claude Code 在编码前进行规划。
• 在编码之前，需要根据代码库实际情况和当前外部来源，对需求、功能形态、ADR 假设或实现方案进行审视。

不适用场景

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

要检查的输入

• 当前用户请求及其后续回答。
• 相关的 AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/CLAUDE.md、.claude/rules/**/*.md、~/.claude/rules/**/*.md、README.md、问题描述、ADR、代码库文档和 docs/agents/ 文件。
• 用户希望保留或审视的现有规格、计划、需求和 PRD。
• 文件布局、命名约定、脚本、包管理器、lint／测试／类型检查命令及 CI 预期。
• 如果某项决策取决于最新行为，则通过可用的 MCP 工具或网页搜索，查阅当前框架、库、API 或平台文档。
• 用户提供的错误消息、截图、日志、PR 反馈或示例文件。
• 只有当规格取决于本地 Claude Code 技能的行为时，才检查 Claude Code 项目级或个人技能目录，例如 .claude/skills/ 和 ~/.claude/skills/。
• 仅当用户提供了 Claude Code 自动记忆的证据、可通过 /memory 获取，或与请求的实现计划实质相关时，才检查这些证据。

工作流

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

1. 分别检查执行宿主的能力和权限；尊重当前或请求启用的 Plan 模式。对于大量尚未明确的工作，建议使用 Plan，但不要因此阻止在手动切换前允许进行的探索或提问。
2. 检查相关仓库上下文和先前的回答。选择 compact、standard 或 deep；根据请求和仓库惯例确定交付意图和目标位置。
3. 仅询问尚未解决的重要决策，根据来源质疑重要假设，并执行 ADR 审查关卡。
4. 准备完整且可供审阅的规范，以及任何必要的 ADR／索引内容。针对该修订版及其具体写入内容，提出一次明确的肯定确认，并复用现有授权。原生计划审批可作为此确认。
5. 保留审批状态，以便在必要时退出 Plan 模式。仅在宿主允许写入时保存已批准的产物，随后重新读取并报告实际持久化情况。明确仅在聊天中交付时，无需保存即可完成。
6. 输出 Claude Code 执行提示词并运行评估标准。访谈者绝不实现功能；交接后，另行授权的外部工作流可以继续执行。

安全规则

• 访谈期间保持只读；原生 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 状态、校验、风险和 Claude Code 执行提示词。如仍需退出 Plan 模式，则报告 Persistence status: pending Plan-mode exit；不得声称已保存。默认情况下，仅在审批前以及聊天交付或持久化受阻时展示完整产物；成功保存后不再重复展示。

完成标准

具体规范涵盖范围、验收标准、验证方式和完成条件。用户已批准当前内容，并要求仅写入一次。所需产物已保存并读回，或已按要求仅通过聊天交付。必需的 ADR 符合仓库惯例；任何验收门槛都清晰可见。验证和持久化是分开的记录。仅保存的最终处理绝不实现该功能。

失败模式

• 缺少仓库或外部证据：标明未知信息并说明限制；继续开展独立工作。
• 存在实质性冲突的要求或已接受的 ADR：指出冲突，并在实现前解决受影响的决策。
• 存在尚未答复的实质性问题：将依赖该问题的工作保持为待处理；继续开展已授权的独立工作。
• 规划或提问控制不可用：使用相同的对话式访谈，不要臆造宿主功能。
• 受 Plan、权限、缺少批准或目标状态已更改等因素影响，无法按要求保存：保留有效批准，准确说明剩余事项，并提供可直接保存的草稿。不要声称待处理的持久化已完成。