SuperAPI AI 工具集

spec-loop-assess-pull-request

编程与开发

查看项目

更新于 10-16 02:03

技能介绍

用途

该技能用于对已经实现完成的变更进行回顾性评审准备。它从用户信任的仓库中已有的拉取请求、合并请求、分支差异或提交范围出发,重建一份本应存在的人工评审准备文件,即回顾性的 Spec Loop 评审产物,然后在此基础上补充 AI 评估与建议。

该技能是可选技能,不是 Spec Loop 核心规划工作流的必需部分。它不把被评审的变更视为停留在正常的 PLAN -> EXECUTION 审批关口。

主要能力

  • 从已有的拉取请求、合并请求、分支差异或提交范围重建回顾性评审产物。
  • 在重建产物之上添加 AI 评估与建议。
  • 复用 Spec Loop 共享的规划、术语、产物结构、格式与图表约定。

使用方式

使用前需按顺序阅读以下文件:

  1. spec-loop-plan-task/SKILL.md:获取共享的规划、术语表与阶段术语。
  2. spec-loop-plan-task/common-task-guidance.md:获取共享的产物结构、格式、术语表与章节语义,这些会被回顾性评审文件复用。
  3. spec-loop-plan-task/task-file-path-guidance.md:获取图表约定以及其他明确适用于回顾性评审产物的任务文件规则。
  4. review-guidance.md:获取信任处理、证据收集、评审结构、图表规则与分享变体行为。

应用上述共享约定时,仅在其适用于回顾性评审工作的范围内使用;不要将仅限聊天的规划路径、任务文件生命周期路由或正常的 PLAN -> EXECUTION 审批关口应用于被评审的变更本身。

证据收集优先使用只读的提供方命令:

  • gh:用于 GitHub。
  • glab:用于 GitLab,包括在可用时的自托管 GitLab。

适用场景

适用于用户信任的仓库中已经存在拉取请求、合并请求、分支差异或提交范围,需要为其重建人工评审准备文件并补充 AI 评估与建议的场景。

限制

  • 仅用于用户信任的仓库中的拉取请求、合并请求、分支差异或提交范围。
  • 若信任状态不明确,应停止并在获取提供方或 Git 内容之前询问。
  • 若信任、提供方、证据来源或比较范围不明确,应停止并询问。
  • 该技能为可选技能,不是核心 Spec Loop 规划工作流的必需部分。
  • 不将正常的 PLAN -> EXECUTION 审批关口应用于被评审的变更本身。

暂未提供

关于该技能的具体收费、价格、平台支持范围、实际效果或详细使用步骤,资料中暂未提供。