SuperAPI AI 工具集

spec-design-research

设计与创作

查看项目

更新于 10-16 08:46

技能介绍

用途:在 Spec 级设计阶段执行 D1 research(可选),系统提取技术背景中的未知项,把“NEEDS CLARIFICATION/依赖/集成”转为可分发研究任务并完成调研,结论写入 {FEATURE_DIR}/design/research.md,使 D2 可直接引用而无需重复解释。可独立使用,也可在 using-aidlc 路由判定需要 D1 时被调用;本技能不做 D0/D1/D2 分流判断。

主要能力:

  • 门禁定位 {FEATURE_DIR}(必须,禁止猜路径或手写 .aidlc/specs/... 路径)。
  • 读取最小必要输入:必读 {FEATURE_DIR}/requirements/solution.md;按需读 requirements/prd.md、prototype.md、project/memory/*、project/contracts/、project/adr/ 索引;缺失或不可追溯则停止。
  • 从技术背景抽取三类条目并编号生成研究任务:NEEDS CLARIFICATION→研究任务;依赖项→最佳实践任务;集成点→模式任务。
  • 建议并行分发研究 Agent,每个任务最小产出:Decision、Rationale、Alternatives considered、Evidence/References。
  • 用 assets/research-template.md 生成 research.md,未知项不得悬空:关闭或进入“风险与验证清单”(含验证信号、方法、Owner/截止、触发动作)。
  • 落盘后输出 ROUTER_SUMMARY(stage D1,artifacts 指向 design/research.md,needs_human_review true,blocked false,notes 建议评审、通常进入 D2),并立即调用 using-aidlc 路由下一步。

使用方式(实施要点):宣布正在使用本技能;先 spec-context 获取上下文并回显 FEATURE_DIR=...;按模板补齐占位符;“研究任务→结论”结构必须完整。

限制:禁止在 research.md 写实现规格(任务拆分、字段清单、DDL、脚本步骤);禁止新建契约/ADR/实现规格文件或目录,D1 只产出 design/research.md;需要更新的入口只写要点,落盘留给 D2 或用户明确要求;禁止用 TODO/待确认问题清单替代研究任务与结论;TL;DR 不超过 7 行且需含最大风险与推荐方向。缺 solution.md 时先回 R1 补齐。

适用场景:方案正确性依赖未知事实、多个方向缺证据取舍、契约/迁移/安全/性能/一致性等高风险点需先验证。不适用:需求侧 SSOT 未落盘,或不存在关键不确定性且约束已证据化(可跳过 D1 直接 D2)。