关于 reviewing-design-docs
reviewing-design-docs 是用于审查指定工程设计文档的 skill,依次采用四种独立视角并综合报告。它要求使用独立的新上下文审查者、检查结论格式,并且不修改文档。
主要功能
- 01要求提供明确且可读的文档路径
- 02运行四种独立审查视角
- 03验证后综合各视角报告
- 04检查结论行并允许重试一次
- 05保持只读且不编辑文档
适用场景
- 01实施前审查设计文档
- 02评估决策、就绪度与准确性
- 03为设计获取独立审查意见
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bostonaholic/ skills --skill reviewing-design-docs安装后在 Claude Code 中输入/reviewing-design-docs确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/design-reviewer.mddesign-template.mdreport-format.mdsynthesizer.mdshared/decisions.mdfindings.mdindependent-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