SuperAPI AI 工具集

flow-next-interview

写作与研究

查看项目

更新于 10-15 21:53

技能介绍

用途:flow-next-interview 扮演技术面试官与规格细化者,针对某个任务、规格或规格文件进行极为彻底的访谈,通常提出 40 个以上问题,以提取完整的实现细节,并将细化后的内容写回目标。适用场景是用户希望充实规格、完善实现细节时。

输入方式:接受 Flow 规格 ID(如 fn-1-add-oauth)、Flow 任务 ID(如 fn-1-add-oauth.3,并会读取父规格上下文)、文件路径(如 docs/spec.md)、或空值。空值时提示用户提供 Flow ID 或文件路径。示例用法:/flow-next:interview fn-1-add-oauth 或 /flow-next:interview docs/oauth-spec.md。规格 ID 用 flowctl show 获取、flowctl spec set-plan 写回;任务 ID 用 flowctl task set-description/set-acceptance 写回;文件路径则读取、访谈后重写文件。

任务状态:该插件所有任务跟踪统一使用 .flow/,不使用 markdown TODO、计划文件或 TodoWrite。flowctl 是随插件捆绑的,不全局安装,which flowctl 会失败属预期;需通过 ${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl 调用。开始前会检查 .flow/meta.json 的 setup_version 与插件版本是否一致,不一致时提示运行 /flow-next:setup 刷新本地脚本,但不阻塞继续。

提问方式:必须使用 AskUserQuestion 工具提问,不将问题作为文本输出,也不在回复中罗列问题;每次工具调用分组 2-4 个相关问题,每轮只做一次 AskUserQuestion 调用。每个问题需先给出推荐选项及置信度分层(high、judgment-call、your-call),选项标签保持中立,不在标签里添加推荐标记。若工具不可用,才退回纯文本编号选项。

提问顺序:按依赖顺序遍历决策树,分支深度上限为 4,边问边根据先前回答调整,不预先锁定整棵树;当一个回答剪掉某个子树时,明确说明跳过了哪些问题。提问前先用 Read/Grep/Glob 调查代码库,可由代码库回答的问题不询问用户。

文档感知行为:通过 --docs / --no-docs 与 --strategy / --no-strategy 标志控制,默认自动检测,依据术语表条目数、决策记录、策略已填充分区等信号激活;术语表与决策由 DOC_AWARE 控制,策略冲突行为由 STRATEGY_AWARE 独立控制。文档感知开启时会执行零阶段术语表扫描,发现术语不匹配或代码与用户陈述矛盾时以 AskUserQuestion 提出。

限制:资料未提供更多关于错误处理、权限、兼容平台之外的细节。