SuperAPI AI 工具集

gs-openspec-review-change

编程与开发

查看项目

更新于 11-19 18:05

技能介绍

用途

gs-openspec-review-change 用于审查并更新一个 OpenSpec 变更。它先运行一轮快速审查,修补不需要人工输入的发现项,然后根据所选模式解决剩余的设计决策类发现项。该技能只修改 OpenSpec 变更产物,不修改应用源代码。

主要能力

  • 解析变更 ID 与模式:从用户请求中读取 change-id 和模式;未指定模式时默认 auto。
  • 预读:并行读取变更目录下的 proposal.md、design.md(如有)、tasks.md、各增量规格,以及相关能力的主规格、触及相同能力的其他活跃变更、近期归档变更和 git 日志与状态。
  • 双专家快速审查:并行启动两个子代理。专家 A 负责结构与一致性,检查增量格式、SHALL/MUST 用语、任务与需求映射、孤立任务与需求、命名一致性、与主规格或其他活跃变更的冲突。专家 B 负责代码库对齐与缺口,检查文件路径、函数名、schema、隐藏前置条件、已实现工作,以及缺失的错误与边界情况、鉴权、迁移、回滚、测试和向后兼容性。
  • 发现项分类:合并去重后分为可修补桶(has_question: false)与问题桶(has_question: true)。
  • 修补机械性发现项:按目标文件分组、自上而下应用编辑并记录变更;修补失败则跳过并记录。
  • 解决问题桶:auto 模式下选择推荐选项并应用,记录理由;无法从提案推断产品意图时跳过并标记需人工输入。ask 模式下逐条提问,一次一个问题,按用户回答应用修复。
  • 生成报告:写入 openspec/changes/<change-id>/review-change.md,覆盖已有文件,按严重级别(Critical、Warning、Suggestion)列出未修补或跳过的发现项。
  • 聊天摘要:输出所用模式、原始发现项计数、各类处理计数、未解决项、报告路径和结论(ready、needs revision 或 blocked),不粘贴完整报告。

使用方式

调用形式为 /gs-openspec-review-change [change-id] [ask]。变更 ID 和模式以自然语言出现在请求中。模式取值:auto(默认,含 --auto、"decide for me"、"recommend"、"answer for me")、ask(含 --ask、"ask me"、"interactive")。仅在用户要求时使用 ask。未指定变更时,列出活跃变更(openspec/changes/ 下排除 archive/)并询问审查哪一个;指定的变更不存在时停止并报告。

适用场景

适用于 OpenSpec 工作流中对变更进行快速审查与修补,尤其是希望自动处理格式、命名、缺失场景或回滚步骤等机械性问题,并对设计决策类问题按推荐方案或交互方式解决的场景。

限制

  • 仅修改目标变更目录下的文件,不修改源代码,不执行 git 提交或切换分支。
  • 每个发现项和每个修补都需标注 file:line。
  • 修补前需验证,例如发现项声称某函数不存在时,应先搜索确认。
  • 分类从保守:不确定是否需要人工输入时设为 has_question: true。
  • auto 模式不猜测产品策略;产品意图不可知时跳过并标记需人工输入。
  • ask 模式一次只问一个问题,不批量合并独立设计决策。
  • 若运行环境无子代理工具,则在当前会话中依次执行两轮专家检查,并在聊天摘要中说明。
  • 报告路径固定为 openspec/changes/<change-id>/review-change.md,存在时覆盖。