mcpField
S
spec-peer-review

spec-peer-review

github.com/pedronauck测试与质量644145 次安装1 周前更新
代码仓库

关于 spec-peer-review

spec-peer-review 是用于独立审查已保存设计规格的技能，适合需要依据契约和项目上下文评估设计的团队。它按轮次保留审查结果，并由用户决定是否采纳及应用发现。

主要功能

  1. 01审查已保存的设计规格
  2. 02检查关联契约与项目上下文
  3. 03每轮生成独立发现文件
  4. 04验证发现并报告结论
  5. 05仅应用用户选定的发现

适用场景

  1. 01发起独立设计审查
  2. 02依据关联需求检查规格
  3. 03参考先前发现继续审查
  4. 04选择要实施的审查发现

安装

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

$npx skills add https://github.com/pedronauck/skills --skill spec-peer-review

安装后在 Claude Code 中输入/spec-peer-review确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
peer-review-prompt.md
quality-markers.md
scripts/
validate-findings.sh

详细介绍

规格同行评审

仅当用户要求独立评审时，才评审已保存的设计。尊重用户已有的按当前状态评审授权。仅纳入用户选定的发现；后续轮次仍需用户主动选择。

输入和输出

  • 根据请求或当前上下文确定规格。仅在存在歧义时提问。
  • 接受额外上下文和输出目录。对于 .compozy/tasks/<slug>/，默认使用规格的 qa/ 目录；否则使用 .peer-reviews/<UTC-timestamp>/。
  • 使用已配置的评审运行时、模型和推理设置。明确的覆盖设置优先；绝不固定使用历史模型，也不暗中替换用户选择的模型。
  • 每轮仅保留一个发现文档：<out>/peer-review-findings-roundN.md。保留之前各轮的文档。

评审

  1. 阅读规格及其关联的契约索引。纳入相关要求、具体示例、测试契约、ADR 决策，以及受影响界面的说明。若依赖关系或矛盾需要更多上下文，再扩展阅读范围；不要加载所有记忆文件。

  2. 使用 references/quality-markers.md 中适用的标记；缺少契约应记为发现，而不是在用户要求评审前自动终止。

  3. 阅读 references/peer-review-prompt.md 并填入其中的占位符，包括准确的发现文件路径、轮次、已确定的运行时/模型和上下文路径。评审者只能写入该发现文件。

  4. 通过可用的独立评审运行时启动评审（已配置的原生评审器、Compozy 会话或 herdr TUI）。使用该运行时有文档说明的命令；不要假设已废弃的 compozy exec API 仍可用。后续轮次中，若已有工作者身份，则保留该身份。

  5. 检查发现、引用的证据和变更路径。验证该文档：

    bash <skill-dir>/scripts/validate-findings.sh --kind techspec --round <N> --path <out>/peer-review-findings-roundN.md

  6. 报告结论、实质性发现、限制和文档路径。输出缺失或格式错误意味着评审未完成，绝不能判为 READY。在已授权的轮次内修复操作故障；不要自动启动额外的实质性评审轮次。

  7. 仅应用用户选定的发现，并记录处置结果及变更路径。复用已有授权；仅在尚未获得选择时提问。用户明确要求进行下一轮时，应提交变更文件、先前的发现/处置结果和新的输出路径，而不是再次提交未变更的全部内容。

此技能不授权提交、发布或批准设计。真实的产品、安全或兼容性约束可以阻止就绪；缺少惯例要求的章节和风格偏好则不能。

评论

支持 Markdown