SuperAPI AI 工具集

spec-kitty-clarify

编程与开发

查看项目

更新于 10-16 08:00

技能介绍

用途:在进入 /spec-kitty.plan 之前,检测并减少当前功能规格中的歧义或缺失决策点,将澄清内容直接记录到 spec 文件中。若用户明确跳过澄清(如探索性 spike),可继续但需警告下游返工风险增加。

主要能力:先运行 spec-kitty agent feature check-prerequisites --json --paths-only 解析 feature_dir、FEATURE_SPEC 及分支信息;若命令或 JSON 解析失败,则中止并提示先运行 /spec-kitty.specify 或确认仓库已初始化。随后对规格做结构化歧义与覆盖扫描,分类包括功能范围与行为、领域与数据模型、交互与 UX 流程、非功能质量属性、集成与外部依赖、边界情况与失败处理、约束与权衡、术语与一致性、完成信号、杂项与占位符。

使用方式:按最多 10 个问题、每次仅问 1 个的方式交互;问题须可短选项或 <=5 词作答,优先覆盖高影响未决类别。收到答案后立即在内存中更新,并原子写回 FEATURE_SPEC:必要时创建 ## Clarifications 与 ### Session YYYY-MM-DD,追加 - Q: … → A: …,并将澄清应用到对应章节(功能需求、用户故事、数据模型、质量属性、边界情况或术语)。最多询问 5 个问题。

限制:仅依赖 Python 3.8+ 标准库,无外部包;requirements.txt 当前为空。不预先透露后续问题;不重复已回答问题或纯风格偏好;若无可澄清项则报告无关键歧义并建议推进;若配额用尽仍有高影响类别未决,会在 Deferred 中标注。安装命令保持原样:pip-compile ./requirements.in;pip install -r ./requirements.txt。