SuperAPI AI 工具集

spec-product-clarify

智能体与模型

查看项目

更新于 10-16 06:47

技能介绍

用途:在 sdlc-dev 的 spec 分支上完成 R1(raw→solution)需求澄清,将 {FEATURE_DIR}/requirements/raw.md 通过多轮最小澄清循环收敛为可评审的 {FEATURE_DIR}/requirements/solution.md(含 ## Impact Analysis)。

主要能力与规则:澄清过程可追溯,每次用户裁决后立即回写 raw.md/## 澄清记录。硬规则包括:澄清未完成时禁止创建或更新 solution.md(含模板/骨架);禁止输出下一步路由或候选阶段;澄清问题必须是需求裁决类(目标、范围、用户、入口、数据口径、权限、性能、一致性、失败策略、验收口径),不得用流程分岔或阶段选择冒充澄清。

使用方式:步骤 0 门禁检查,需先执行 spec-context 并回显 FEATURE_DIR=...,且 raw.md 存在非空,否则停止并只输出阻断原因与最小输入。步骤 1 读取 raw.md,并尝试读取 .aisdlc/project/memory/product.md、glossary.md、products/index.md、components/index.md,读不到记为 CONTEXT GAP。步骤 2 最小澄清循环,一次只问 1 个最高杠杆的可裁决选择题(2–4 选项 + 推荐项 + 其他/不确定兜底),得到回答后回写 raw.md。步骤 3 需显式确认剩余未澄清点为空且用户确认无遗漏。步骤 4 依据 assets/solution-template.md 结构产出 solution.md,须含 1 个推荐方案、2–3 个差异明显的备选方案、决策依据(证据入口)、可执行验证清单(V-xxx,禁止 TBD)、## Context Gaps 与 ## Impact Analysis,并追加迭代记录。步骤 5 输出产物清单与 ROUTER_SUMMARY,并调用 using-aisdlc 交由 Router 判定下一步。

适用场景:需要严格门禁与可追溯澄清的规格开发流程。限制:本技能不输出路由结论;遇到催促跳过澄清、要求一次问完或直接给路由结论等压力信号时,仍只问 1 个需求裁决题,其余未知转入验证清单;未获 FEATURE_DIR、raw.md 缺失或为空、指令冲突、无法确认最新 raw.md 时应立即停止。