mcpField
O
openspec-verify

openspec-verify

github.com/full-stack-skills测试与质量189 次安装4 周前更新
代码仓库

关于 openspec-verify

使用 `/opsx:verify` 检查实现是否符合变更制品，评估完整性、正确性和一致性，并按严重程度报告问题。

主要功能

  1. 01检查任务与需求覆盖情况
  2. 02核对实现是否符合规范意图
  3. 03检查设计与代码的一致性
  4. 04按严重程度分类问题

适用场景

  1. 01完成任务实现后验证工作
  2. 02归档变更前进行检查
  3. 03发现问题并修复后重新验证

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-verify

安装后在 Claude Code 中输入/openspec-verify确认已加载。

附带文件agents/openai.yaml

详细介绍

OpenSpec 验证技能

使用 /opsx:verify 验证实现是否与变更工件一致。检查三个维度——完整性、正确性和一致性——并将问题分类为 CRITICAL、WARNING 或 SUGGESTION。

适用场景

  • 使用 openspec-apply 完成任务后、归档前。
  • 用户说“验证”“检查我的工作”或“验证实现”。
  • 归档变更前的质量门禁。

前提条件

  • 已实现任务（通过 openspec-apply 或手动编码）。

工作流

  1. 运行验证

    • /opsx:verify — 验证当前或推断出的变更。
    • /opsx:verify <change-name> — 验证指定的变更。

  2. 三个验证维度

    维度验证内容
    完整性所有任务均已完成，所有需求均已实现，所有场景均已覆盖
    正确性实现符合规范意图，并处理了边缘情况
    一致性代码体现了设计决策，且模式保持一致

  3. 查看报告

    • CRITICAL：归档前必须修复。
    • WARNING：建议处理；不会阻止归档。
    • SUGGESTION：可选改进。

  4. 按需修复问题

    • 处理严重问题，并可选择修复警告。
    • 再次运行 /opsx:verify 进行确认。

输出

  • 包含分类问题（CRITICAL / WARNING / SUGGESTION）的验证报告。
  • 摘要：是否已准备好归档。

后续步骤

  • 如果已准备就绪：使用 openspec-archive 归档变更。
  • 如果发现问题：修复代码或更新工件，然后重新验证。

故障排除

  • 出现大量误报：在 openspec/config.yaml 中添加项目上下文，帮助 Agent 理解约定。参见 openspec-config。

参考

评论

支持 Markdown