用途
interview 用于在启动非平凡工作前,对用户进行持续追问式访谈,直到“做”“不做”“完成”三项都毫无歧义为止。它会沿着设计树的每个分支逐一走查,逐个解决决策之间的依赖关系。对于每个问题,都会给出推荐答案。
主要能力
- 每次只提一个问题,避免一次性抛出一堆问题造成认知负担。
- 如果某个问题可以通过探查代码库得到答案,则优先探查代码库而不是询问用户。
- 当用户表示已收敛时,输出一个 Markdown 摘要,包含 Do / Don't do / Done when 三部分。
- 在摘要中,对自动采纳的推荐项使用
[auto]内联标记(例如- Use bcrypt [auto])。
输出格式
当访谈收敛后,输出单个 Markdown 块(与用户语言一致,默认英语):
Do
- <bullet>
Don't do
- <bullet>
Done when
<可观察、可测试的条件>
对任何自动采纳的推荐,在内联位置标记 [auto]。
边界情况
| 情况 | 处理方式 |
|---|---|
| 用户回答“我不知道”/“你决定” | 按顺序: (1) 给出 2 个具体选项,每个附一行理由; (2) 若仍被推迟,提出单一推荐路径并问“按 X 进行可以吗?”; (3) 若被接受,用 [auto] 记录。绝不静默决定。 |
| 用户与之前的回答矛盾 | 同时反映两个版本:“你之前说 X;现在说 Y。哪个是当前的?”更新较早的决策,使摘要保持一致。 |
| 用户想中途跳过 | 尊重其意愿。输出部分摘要;将未解决的分支作为 bullet 列入附加的 ### Open questions 部分,并追加在 ### Done when 之后。 |
环境说明
Claude Code
当问题有 2-4 个具体选项时,使用 AskUserQuestion。将推荐选项标记为 (Recommended) 并放在第一位。对于开放式回答,用纯文本提问。
Codex / Gemini CLI / 普通终端
手动为多选项编号:
Q: Which export format?
- CSV (Recommended) — standard for audit exports
- JSON
- Other (please describe)
Auto Mode
如果编排器处于 auto mode(连续、自主执行),不要阻塞等待用户输入。对每个问题应用推荐答案,在输出中用 [auto] 内联标记每个自动应用的选项,并暴露所选路径,以便用户在运行结束后可以纠正。
Simulation override:如果调用方明确要求你模拟访谈或渲染对话,则产生问答轮次,而不是自动决定。
示例
User: "I want to add an export feature for teams"
Q1: What is the export for — audit, data migration, or reporting?
Recommended: Audit. OK?
A1: Audit.
[Reads src/teams/ — finds members, permissions, activity log]
Q2: Format and access? Recommend CSV, admin-only (audit default).
A2: Yes.
→ Output:
### Do
- Admin can download CSV (members + permissions) for a team
### Don't do
- PDF, scheduling, encryption-at-rest (v1 out of scope)
### Done when
- An admin can download a CSV with members and permissions