关于 sdd-checklist
sdd-checklist 是用于在审批或实施前检查 OpenSpec 变更需求质量的技能。它会生成针对变更的检查清单、逐项评估,并给出审批或修改建议。
主要功能
- 01生成定制需求检查清单
- 02检查完整性与清晰度
- 03核对文档间的一致性
- 04逐项标记通过、不通过或不适用
- 05给出审批建议
- 06只读检查
适用场景
- 01在人为审批节点审查规格
- 02实施前检查变更
- 03发现含糊或遗漏的需求
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ alejandro-cedeno-10/ agentic-sdd-kit --skill sdd-checklist安装后在 Claude Code 中输入/sdd-checklist确认已加载。
详细介绍
需求质量检查清单
--strict 验证可以证明规范格式良好,但不能证明规范描述完善。
此技能会生成量身定制的检查清单,并根据清单评估变更,从而在编码之前发现清晰度或覆盖范围上的缺口,而不是等到评审时才发现。
适用场景
- 在
sdd-feature-flow人工审批关卡,决定是否批准规范。 - 在执行
/opsx:apply或启动任何非简单变更的实现之前。
流程
- 阅读变更内容:
openspec/changes/<id>/proposal.md、design.md、tasks.md和差异规范;如果存在,也要阅读openspec/project.md(即项目章程)。 - 生成检查清单,针对本次变更涉及的内容进行定制。至少涵盖:
- 完整性 — 设计和任务是否处理了每项明确提出的需求?是否明确说明错误、空值和边界情况,而不仅是正常路径?是否明确列出了非目标?
- 清晰度 — 每项需求是否都可测试且没有歧义(SHALL/MUST、具体值)?是否有“可能应该 / 待定 / 等等”之类的表述,掩盖了实际决策?
- 一致性 — 提案、设计、任务和差异是否一致?范围、数据模型或命名是否存在矛盾?是否有内容违反项目章程?
- 可测试性 — 每项需求是否都有相应场景或任务,确保未满足需求时会导致失败?验证路径是否明确?
- 假设 — 每项关键假设是否都已确认或标记为待解决问题(而不是悄悄当作既定事实)?
- 评定每项为通过 / 未通过 / 不适用,并给出一行理由;先列出未通过项。
- 提出建议:按原样批准、修复所列问题后批准,或退回修改。
输出
简洁的表格(项目 · 结论 · 理由),未通过项排在前面,然后给出一行建议。 只读 — 此技能不会更改任何文件;它只生成检查清单和结论。
评论
支持 Markdown