SuperAPI AI 工具集

interview

办公与效率

查看项目

更新于 10-16 02:41

技能介绍

用途

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?

  1. CSV (Recommended) — standard for audit exports
  2. JSON
  3. 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