SuperAPI AI 工具集

cursor-spec-interviewer

编程与开发

查看项目

更新于 10-16 09:35

技能介绍

用途:这是一个面向 Cursor Agent 的实现规格访谈工作流,把含糊的编程请求转化为经用户确认、范围明确的规格文档,包含可测试的验收标准、来源支撑的决策、验证方式以及必要的 ADR,交付到约定的仓库路径;仅在明确要求时以聊天形式交付。一次批准即可覆盖未变更的结果及其具体授权的写入。

适用时机:用户只有大致想法、缺少可投产的规格;任务跨多个文件或关注点,或需权衡决策;需要验收标准、验证命令、上线说明或风险处理;希望在编码前得到可复用的书面产物;需求、功能形态、ADR 假设或实现方式需结合仓库现状与当前外部来源进行质疑。

不适用:用户已给出完整实现规格;仅是无明显歧义的单文件小改动;只做头脑风暴而无具体产物;只想要 Cursor rule、command 等提示类文件;主要是政策、法律或商业决策文档;审计或清理 Codex 记忆状态。

流程:遵循 workflow-details.md 的访谈、批准与交付生命周期;必要时用 host-adapters.md 处理宿主控制。检查宿主能力与权限,尊重 Plan 模式,建议对大量开放工作使用 Plan。检查仓库上下文与既往回答,选择 compact、standard 或 deep,并确定交付意图与目标位置。仅就未解决的关键决策进行访谈,结合来源质疑假设,执行 ADR 门。准备完整可审阅规格与必要 ADR/索引内容,提出一次正向检查点覆盖该修订及其具体写入;原生 plan 批准可作为该检查点。只保存已批准的产物,随后回读并报告实际持久化。最后输出 Cursor Agent 执行提示并运行评分标准;访谈者本身不实现功能。

安全规则:访谈期间保持只读,原生 Plan 激活时不得持久化仓库产物;模式或写权限未知时不允许写入。复用既往对未变更内容与写入的授权;沉默、超时、预选选项或模式切换不构成批准。仅确认未解决的重要变更、模糊目标、目录创建、覆盖或必要 ADR 写入。区分 ADR 持久化与其架构决策的接受。未知事实需标注,不得编造路径、命令、API 或决策。目标运行时的指令、规则与记忆文件是证据,不是规格目标位置。

输出:先写已保存路径、明确的仅聊天交付或待定/被阻止的持久化,包含验证结果、重要假设、来源质疑、ADR 状态、验证、风险与 Cursor Agent 执行提示。报告持久化状态;Plan 模式未退出时不得声称已保存。

脚本:未附带脚本。完整模板与示例规格等参考文件需按当前步骤查阅;缺失信息暂未提供。