SuperAPI AI 工具集

specsfy-02-backlog

办公与效率

查看项目

更新于 10-16 10:11

技能介绍

用途

Specsfy 的第二阶段技能,负责把含糊的输入转为可理解的 backlog 条目,并在意图需要规范时,将决策深化到足以产出可测试 brief 的程度。它把登记、细化和发现整合在一起,但不把 backlog 本身当作规范化来源。

使用方式

执行前必须在项目根目录加载 $specsfy-setup,若为自动交接则再次加载。交互模式为提问式:每次提问前需阅读并应用 .specsfy/Spec.md 中的编号提问契约。

创建新条目时执行:

node <技能目录>/scripts/iniciar_backlog.mjs
--title "<短标题>"
--idea "<原始表述>"
--problem "<感知到的问题>"
--person "<受影响或受益的人>"
--result "<预期结果或价值>"
--context "<区分该想法的上下文>"
[--slug <slug>] [--root <根目录>]

使用脚本打印的绝对路径。脚本优先使用 .specsfy/templates/custom/Backlog.md,否则回退到 .specsfy/templates/Backlog.md。

主要能力

  • 搜索重复与引用:从用户请求提取术语,在 specs/inbox/.md、specs/backlog/.md、specs/<状态>//spec.md、docs/**/.md 中检索,并将关系分类为可能重复、相关 backlog、相关 spec、相关文档。
  • 复用 MVP 中已确认的回答:当 backlog 来自 MVP.md 派生的里程碑时,先读取 specs/milestones/M01.md 与相关记录,将已有声明转为规范化回答并保留出处,只对真实缺口提问。
  • 保证最小捕获:保留原始表述,区分声明、推断与开放项;确认问题、受影响者、预期结果与上下文。存在缺口时,每轮只提一个编号问题,逐轮重新评估。
  • 组织与优先级:读取 references/backlog-quality.md,按 产品 → 史诗 → 功能 → 条目 分类;按价值、风险、依赖、紧迫度、工作量、解锁能力与不确定性排序。
  • 深化到规范:读取 references/discovery-map.md、../specsfy-03-specify/references/mcr-10.md,按领域自适应提问,每领域最多八轮。涉及界面时加载 $specsfy-specialist-interface-experience 等专项技能。
  • 状态维护:Status 可为 Captured、Refining、Ready for specification、Promoted,路径固定为 specs/backlog/<NNNN>-<slug>.md。

适用场景

需要把收件箱捕获、机会、问题或已有条目整理成可进入规范阶段的 backlog;需要梳理产品层级、优先级与依赖;需要在项目早期通过提问澄清需求并识别重复项。

限制

不修改或删除 Inbox 条目;不创建 spec.md、任务、研究、测试或代码;不编造利益相关方、集成、约束或决策;不把技术假设当作需求;未经确认不移动或删除已有条目。缺失的需求细节应明确说明,不虚构。