SuperAPI AI 工具集

eng-design-doc-review

写作与研究

查看项目

更新于 11-03 17:14

技能介绍

用途

eng-design-doc-review 用于对工程设计文档进行独立、全新上下文的审计。它不依赖设计作者自身的判断,而是通过一个与作者没有共享对话历史的只读子代理来对抗性地评审设计文档,避免自我评估偏差。该技能可以独立调用,也可以作为团队设计流程中的 DESIGN 评审门。

主要能力

  • 读取指定目录下的 6-design.md 作为被评审文档,并可选读取 1-task.md、2-questions.md、5-research.md、4-repos.md 作为背景材料。
  • 支持通过参数显式指定工件目录,或通过 discover-topic.sh 自动发现包含 6-design.md 的目录。
  • 可选执行跨模型审查:读取 cross-model review 引用并遵循其 Design-review pass 流程,将各厂商 CLI 的原始输出封装为 DATA 块,随评审简报一起传入。
  • 通过 Agent 工具派发内置只读 Explore 子代理(指定 model: opus)执行评审,子代理使用 references/design-reviewer.md 中的评审简报。
  • 子代理返回 Conventional Comments 格式的发现(issue / suggestion / nitpick,各自带 file:line 引用),并以 APPROVE、REQUEST CHANGES 或 COMMENT 之一作为结论。
  • 原样转述子代理输出,并打印各类型发现的数量。
  • 若跨模型审查中有 CLI 不可用,会逐行说明不可用的 CLI 及原因,或在全局禁用时说明 TEAM_DISABLE_CROSS_MODEL。

使用方式

  1. 提供工件目录作为参数(如 docs/plans/<id>/)。若为空,技能会运行发现命令定位包含 6-design.md 的目录;若自动发现,会先向用户宣布解析出的目录。
  2. 若无法找到 6-design.md,技能不会硬报错,而是通过 AskUserQuestion 提供选项:运行 /team-design 生成缺失文档,或由用户直接提供路径。
  3. 可选执行跨模型审查,读取相应引用流程,将厂商输出封装为 DATA 块。
  4. 读取评审简报,调用 Agent 工具以 subagent_type: Explore、model: opus 派发只读子代理,并将简报作为提示传入,替换 $ARGUMENTS 为工件目录。
  5. 接收并完整呈现子代理返回的评审结论与发现。
  6. 不会自动修订设计文档;若结论为 REQUEST CHANGES,会提示用户带着发现重新运行 /team-design。

适用场景

  • 需要对技术设计文档进行独立、无偏见的审计时。
  • 作为团队设计流程中的评审门,确保设计在进入下一阶段前经过新鲜上下文评审。
  • 当用户希望在不依赖设计作者自我评估的情况下获得客观反馈时。

限制

  • 技能本身为只读,不写入任何工件;独立运行时不会记录 design-review-<n>.md,只有流水线的 DESIGN 评审门会写入结论工件。
  • 评审由只读 Explore 子代理执行,该子代理没有 Write/Edit 工具,因此无法修改被评审文档或工件目录。
  • 若环境缺少 Explore 代理类型,会报告派发失败,不会静默替换为全工具代理。
  • 不自动循环修订设计作者;需要用户自行决定是否重新进入 /team-design。
  • 跨模型审查为可选,若 CLI 不可用或未认证会按跳过处理,由评审子代理单独完成评审。
  • 内容撰写遵循七年级阅读水平的 STE 风格,短句、常用词、无未解释术语;在最终确定由该技能管辖的文本前,需阅读写作标准并应用其自检清单。