mcpField
S
sdd-checklist

sdd-checklist

github.com/alejandro-cedeno-10测试与质量0128 次安装17 周前更新
代码仓库

关于 sdd-checklist

sdd-checklist 是用于在审批或实施前检查 OpenSpec 变更需求质量的技能。它会生成针对变更的检查清单、逐项评估,并给出审批或修改建议。

主要功能

  1. 01生成定制需求检查清单
  2. 02检查完整性与清晰度
  3. 03核对文档间的一致性
  4. 04逐项标记通过、不通过或不适用
  5. 05给出审批建议
  6. 06只读检查

适用场景

  1. 01在人为审批节点审查规格
  2. 02实施前检查变更
  3. 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 或启动任何非简单变更的实现之前。

流程

  1. 阅读变更内容:openspec/changes/<id>/proposal.md、design.md、tasks.md 和差异规范;如果存在,也要阅读 openspec/project.md(即项目章程)。
  2. 生成检查清单,针对本次变更涉及的内容进行定制。至少涵盖:
    • 完整性 — 设计和任务是否处理了每项明确提出的需求?是否明确说明错误、空值和边界情况,而不仅是正常路径?是否明确列出了非目标?
    • 清晰度 — 每项需求是否都可测试且没有歧义(SHALL/MUST、具体值)?是否有“可能应该 / 待定 / 等等”之类的表述,掩盖了实际决策?
    • 一致性 — 提案、设计、任务和差异是否一致?范围、数据模型或命名是否存在矛盾?是否有内容违反项目章程?
    • 可测试性 — 每项需求是否都有相应场景或任务,确保未满足需求时会导致失败?验证路径是否明确?
    • 假设 — 每项关键假设是否都已确认或标记为待解决问题(而不是悄悄当作既定事实)?
  3. 评定每项为通过 / 未通过 / 不适用,并给出一行理由;先列出未通过项。
  4. 提出建议:按原样批准、修复所列问题后批准,或退回修改。

输出

简洁的表格(项目 · 结论 · 理由),未通过项排在前面,然后给出一行建议。 只读 — 此技能不会更改任何文件;它只生成检查清单和结论。

评论

支持 Markdown