SuperAPI AI 工具集

sdd

编程与开发

查看项目

更新于 10-15 23:59

技能介绍

用途:该技能是 Liatrio Spec-Driven Development(SDD)工作流的编排器,仅在用户明确调用时执行。它先判断工作区当前所处的生命周期阶段,再加载并遵循唯一匹配的阶段参考文件。

主要能力:每次调用管理一个 SDD 阶段(除非该阶段明确要求更小的检查点);路由前评估工作区;只选择一个活跃规格和一个阶段参考;执行阶段指令或在必须的审批门处停止;向用户报告所选规格、检测到的状态、当前阶段、所选参考路径、创建或更新的产物以及下一步自然语言请求。

状态评估:在当前工作目录为目标仓库/工作区根目录时运行随附脚本:python3 {{skill_dir}}/scripts/assess-sdd-state.py . 。{{skill_dir}} 仅用于定位随附资产,SDD 产物按工作区路径参数(即命令中的 .)评估。脚本输出 JSON,描述活跃规格与推荐阶段,作为路由的默认事实来源。仅在脚本无法运行时手工检查,并明确说明该回退,检查 ./docs/specs/ 并套用相同阶段规则。

阶段规则:阶段1规格生成——用户请求新功能但无匹配的 [NN]-spec-[feature-name]/ 目录,或目录存在但规格文档不完整或缺失;收集上下文并撰写正式规格。阶段2任务清单生成与审计——[NN]-spec-[feature-name].md 存在且完整,但 [NN]-tasks-[feature-name].md 缺失,或强制的 [NN]-audit-[feature-name].md 规划审计尚未生成并通过;将规格转为父子任务、定义 Proof Artifacts 并运行强制的规划审计门。阶段3任务实现——规格、任务清单和通过的规划审计报告均存在,且任务清单中仍有标记为 [ ] 或 [~] 的未完成任务;执行任务清单、实现代码并生成所需 Proof Artifacts。阶段4验证——实现任务标记为完成且用户要求验证,或评估器发现某活跃规格的实现看似完成但验证缺失或失败;依据规格要求,用严格的通过/失败质量门评估代码库与 Proof Artifacts。

参考路由:确定阶段后只读取对应的随附参考文件——阶段1为 {{skill_dir}}/references/sdd-1-generate-spec.md,阶段2为 {{skill_dir}}/references/sdd-2-generate-task-list-from-spec.md,阶段3为 {{skill_dir}}/references/sdd-3-manage-tasks.md,阶段4为 {{skill_dir}}/references/sdd-4-validate-spec-implementation.md。始终以所选参考文件中的详细指令、约束和反模式为准。若存在多个活跃规格且用户请求未明确指向其一,需在修改文件前询问继续哪个规格;若选择明确,说明选择理由。

面向用户报告:开始或交接工作时用自然语言说明当前阶段与所选规格,包括当前 SDD 阶段、所选规格、阶段参考、检测状态与选择理由;当阶段创建或更新文件时,列出产物路径、到达的审批门、审计或验证结果,并按固定格式给出“How to Continue the SDD Workflow”交接,含下阶段动作与建议自然语言回复(如 Continue SDD with task planning. 等)。

限制:该技能不用于动态加载;捆绑技能资产与阶段参考文件的具体内容、脚本内部实现、可用平台与价格信息暂未提供。