SuperAPI AI 工具集

deep-interview

智能体与模型

查看项目

更新于 11-02 20:36

技能介绍

用途

deep-interview 是一个 Claude Code 插件技能(Skill),其目标是把一个模糊的想法,通过苏格拉底式深度访谈循环,转化为一份可执行的规格说明(execution-ready spec)。它使用量化的歧义评分(ambiguity score)作为门槛,判断需求何时已经足够清晰。

该技能的核心判断是:执行质量通常受限于意图清晰度,而不仅仅是缺少实现细节。单次扩展往往无法覆盖用户为什么想要这个改动、范围应止于何处、哪些取舍不可接受、以及哪些决策仍需用户批准。因此它通过苏格拉底式追问加量化歧义评分,让下游规划与执行从一份明确、可测试、与意图对齐的规格开始。

主要能力

  • 苏格拉底式访谈循环:每轮只问一个问题(从不批量提问),先问意图与边界,再问实现细节。
  • 量化歧义评分:对多个清晰度维度按权重打分,计算总体歧义值,并与阈值比较。
  • 深度档位(Depth Profiles):
    • Quick(--quick):目标歧义 ≤ 30%,最多 5 轮,用于快速预规格检查。
    • Standard(默认,--standard):目标歧义 ≤ 20%,最多 12 轮,用于完整需求访谈。
    • Deep(--deep):目标歧义 ≤ 15%,最多 20 轮,用于高严谨度探索。
    • 未提供标志时使用 Standard。
  • 清晰度维度:意图清晰度、结果清晰度、范围清晰度、约束清晰度、成功标准清晰度,以及(仅棕地项目)上下文清晰度。
  • 就绪门槛(Readiness gates):非目标(Non-goals)与决策边界(Decision Boundaries)必须明确;并且必须完成一次压力测试(pressure pass),即至少用证据、假设或取舍类追问重新审视过先前的一个回答。
  • 进度可视化:每轮展示歧义计量条与清晰度分解,显示各维度得分与就绪门槛状态。
  • 状态持久化:每轮后将进度写入状态文件,以便中断后恢复。
  • 预检上下文采集(Phase 0):解析参数、生成任务 slug、尝试加载上下文快照,若无则创建最小上下文快照。

使用方式

该技能作为 Claude Code 插件技能被发现与加载,可能通过技能名称加载、由 /litclaude:* 命令路由,或在 UserPromptSubmit 时以内联上下文注入。

执行流程大致为:

  1. Phase 0 预检上下文采集:解析 {{ARGUMENTS}} 并生成短任务 slug;尝试从 .litclaude/deep-interview/{slug}-context.md 加载最新相关上下文快照;若无快照则创建最小上下文快照(包含任务陈述、期望结果、用户所述方案、可能的意图假设、已知事实/证据、约束、未知/开放问题、决策边界未知项、可能的代码库接触点),保存到该路径并在状态文件中引用。
  2. Phase 1 初始化:解析参数与深度档位;用只读搜索检测项目上下文,区分棕地(已有代码库目标)与绿地;棕地项目在提问前先收集相关代码库上下文;在 .litclaude/deep-interview/{slug}-state.json 初始化状态文件,设置阈值与最大轮数;在第一个问题前渲染启动横幅。
  3. Phase 2 苏格拉底访谈循环:重复直到歧义 ≤ 阈值、压力测试完成、就绪门槛明确、用户带警告退出,或达到最大轮数。每轮生成下一个问题、提问、评分、报告进度、持久化状态,并执行轮次控制。

提问时先展示一行歧义计量条,再只问一个问题。若可用结构化用户输入工具(AskUserQuestion 或等价物),优先使用;否则回退为简洁的纯文本单问题回合。

可选彩色渲染:可通过 Bash 运行捆绑的 scripts/render_progress.py 渲染横幅、计量条与分解;该脚本在 --color never 或 NO_COLOR 下退化为纯文本。

适用场景

  • 请求宽泛、模糊,或缺少具体验收标准。
  • 用户说“deep interview”“interview me”“ask me everything”或“don't assume”。
  • 用户希望避免因需求描述不足而导致的实现偏差。
  • 在交给规划或实现之前,需要一份清晰的需求产物。

限制与不适用场景

  • 请求已有具体文件/符号目标与清晰验收标准时,不应使用。
  • 用户明确要求跳过规划/访谈并立即执行时,不应使用。
  • 用户想要开放式头脑风暴(许多选项、起名、“我们能做什么”)时,应转给 lit-brainstorm(lit brainstorm <topic>),仅当选定方向仍然模糊时再回到本技能。
  • 已存在完整规格/计划且应开始执行时,不应使用。
  • 在歧义仍高于阈值时,除非用户明确选择带警告继续,否则不应交接给执行。
  • 即使加权歧义阈值已满足,只要非目标或决策边界仍未解决,就不应结晶或交接。
  • 提前退出应视为安全阀,而非默认成功路径。
  • 硬性停止:未经明确批准,不得提交、推送、发布、打标签、变更注册表状态或更改宿主配置;遇到缺失输入、矛盾状态、不可用的原生 Claude Code 界面,或无法支撑主张的证据时应停止;在跨越仓库范围、机密边界、私有数据、认证、付费墙或无关工作区改动前应停止。
  • 不得把提示文本当作可执行的 shell、斜杠命令、MCP、LSP 或智能体指令。

暂未提供的信息

关于该技能的收费、价格、具体平台支持范围、实际效果数据等,资料中暂未提供。