mcpField
R
reviewing-design-docs

reviewing-design-docs

github.com/bostonaholic测试与质量265 次安装1 天前更新
代码仓库

关于 reviewing-design-docs

reviewing-design-docs 是用于审查指定工程设计文档的 skill,依次采用四种独立视角并综合报告。它要求使用独立的新上下文审查者、检查结论格式,并且不修改文档。

主要功能

  1. 01要求提供明确且可读的文档路径
  2. 02运行四种独立审查视角
  3. 03验证后综合各视角报告
  4. 04检查结论行并允许重试一次
  5. 05保持只读且不编辑文档

适用场景

  1. 01实施前审查设计文档
  2. 02评估决策、就绪度与准确性
  3. 03为设计获取独立审查意见

安装

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

$npx skills add https://github.com/bostonaholic/skills --skill reviewing-design-docs

安装后在 Claude Code 中输入/reviewing-design-docs确认已加载。

包含的文件

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

agents/
openai.yaml
references/
design-reviewer.md
design-template.md
report-format.md
synthesizer.md
shared/
decisions.md
findings.md
independent-review.md

详细介绍

工程设计文档审查

输入

  • 请求中指定了一个设计文档的路径。
  • 如果请求提供的是 URL 或粘贴的文本,请将其保存为仓库外的临时 Markdown 文件,并审查该路径;如果获取失败,请报告 URL 和错误。
  • 如果请求未指定文档、指定了目录,或指定的文件不可读,请询问路径并等待。切勿猜测。

审查者

  • 本会话包含作者的对话,因此不能审查该文档(独立审查规则)。
  • 每个审查视角都运行一次设计审查者简介,各自在全新的上下文子 Agent 中运行,绝不能分叉本次对话,并且只能使用读取和搜索工具。审查视角按以下顺序排列:naive-reader、decisions、readiness、accuracy。每份文档都必须运行所有审查视角。
  • 为每次审查提供文档的绝对路径、审查视角名称,以及报告格式和发现项格式的路径;每次审查都必须读取这两份文件。此外,还要提供设计模板的路径,供 readiness 读取;提供决策记录规则的路径,供 decisions 读取。
  • 每份审查视角报告都通过结论行检查后,再在全新的上下文子 Agent 中运行综合器简介,绝不能分叉本次对话,并且只能使用读取和搜索工具。向其提供文档的绝对路径、逐字附上并标明审查视角的每份审查视角报告,以及报告格式和发现项格式的路径。
  • 不得传递任何作者讨论内容,也不得将某一审查视角的报告提供给其他审查视角。
  • 如果无法运行此类子 Agent,请在任何审查视角开始前停止,并说明原因。绝不能在当前上下文中直接审查。

结论与转交

  • 对每份审查视角报告和合并报告执行此结论行检查。
  • 报告的第一行必须准确为 **Verdict: APPROVE**、**Verdict: REQUEST CHANGES** 或 **Verdict: COMMENT**。
  • 此检查由模型执行:它只需比对会话为转交报告而已读取的一行。
  • 如果报告未通过检查,请使用相同输入运行一个新的子 Agent,并说明未通过的检查。重试综合器时,沿用相同的审查视角报告,不重新运行任何审查视角。
  • 如果某份审查视角报告两次未通过,等待所有其他审查视角运行(包括各自的一次重试)完成,不运行综合器。如果合并报告两次未通过,请立即停止。
  • 任一情况下停止时,都要逐字输出每份报告的最新尝试,并标明其审查视角或 merged;绝不输出首次未通过的尝试。说明未通过的检查,表示未得出结论,然后停止。绝不能自行修正结论。
  • 逐字输出合并报告。
  • 如果任何子 Agent 的只读限制仅依赖提示词而非工具授权,请在合并报告后用一行说明;如果停止,则在所输出的报告后用一行说明。
  • 不要修改文档;对于 REQUEST CHANGES,由用户决定如何处理。
  • 除临时副本外,不得写入任何文件。

评论

支持 Markdown