SuperAPI AI 工具集

workflow-review-changes

编程与开发

查看项目

更新于 11-06 09:09

技能介绍

用途:这是一个面向代码变更审查的工作流技能,用于审查复杂、有风险或跨模块的拉取请求与变更,通过多专业审查视角发现问题并推动修复。默认运行修复循环(fix-loop),也可切换到只审查模式(review-only)。

主要能力:

  • 运行前先做范围盘点:清点文件、意图、风险、必需规则、依赖与机械输出,并在 tmp/reports/ 下写入简短审查计划与覆盖记录。
  • 建立分阶段待办:按所选模式的阶段创建待办,每个阶段一行,包含条件性或可选项,执行中保持进度与证据更新。
  • 调用多个审查子技能:通用变更审查、独立理由审查(why-review)、架构审查、领域分析、性能审查、集成测试审查、安全审计、生产就绪审查、UI 设计审查、AI 工程审查、代码简化(仅报告)、体验审查等;按实际风险选择适用项。
  • 领域实体质量审查:当涉及实体/值对象/聚合或写入/加载/事件路径变更时,由 domain-entities-design-review 承担该条件任务,修复后需重新评估。
  • 汇总结论并一次性验证:通过 why-review --validate-findings 统一验证发现的问题,再在所属组件处修复;同一修复批次内更新规格、测试与文档漂移,领域文档刷新与 docs-manager 在修复后、重新审查前运行。
  • 重新审查:对修复后的完整目标(含文档编辑与新引入风险)重新运行通用审查、理由审查和所有适用的专项审查;任何修复、简化、规格/文档/测试修补或被拒绝的阻塞性问题都需要这次全新审查,局部抽查不能替代。
  • 质量门禁:保留意图、基于证据的严重程度、全流程正确性、问题验证以及规格/测试/代码一致性;测试、一致性与必需产物为二元检查,不因低优先级问题暂缓而豁免。

使用方式:

  • 以 INLINE 方式在主会话中运行,即使嵌套在其他工作流中也一样。
  • 先读取注册表 workflows.workflow-review-changes,并调用 $start-workflow workflow-review-changes 以解析所选模式、前置动作与指纹。
  • 执行前先创建待办,再按注册表顺序调用各步骤技能;若宿主拒绝该调用或无技能调用能力,则自行完整读取对应 SKILL.md 并按相同参数执行。
  • 模式 review-only 的步骤顺序:$changes-review → $why-review → (可选条件)$architecture → $domain-analysis → $performance-review → $integration-test → $security-audit → $production-readiness-review → $ui-design → $ai-engineering-review → $experience-review → $why-review --validate-findings → $workflow-end → $watzup。
  • 模式 fix-loop 的步骤顺序:$changes-review → $why-review → (可选条件)$architecture → $domain-analysis → $performance-review → $integration-test → $security-audit → $production-readiness-review → $ui-design → $ai-engineering-review → $code-simplifier --report-only → $experience-review → $why-review --validate-findings → $investigate --mode=debug → $fix --target=review → $scan --target=domain-entities → $docs-manager --mode=update → $workflow-end → $watzup。
  • 通过 --review-only 或 --report-only 选择 review-only 模式;--tests=prove 为独立审查的默认测试策略,--tests=defer 则把执行交给后续验证步骤。
  • 只读审查可并行运行适用的专项审查、代码简化报告与体验审查,等所有报告到齐后再修复;子审查默认以 --fix-loop --loop-owner=caller 运行,只审查当前轮次,返回发现与覆盖情况,由主会话负责修复与再审查循环。

适用场景:复杂、高风险或跨模块的拉取请求与变更审查;需要架构、领域、性能、安全、生产就绪、UI、AI 工程等多视角深度审查的改动;涉及领域实体或写入/加载/事件路径变更的变更;希望在审查后直接修复并重新验证的流程;只报告不修改源码的审查。

限制:

  • 默认最多三轮审查,达到三轮时若只剩低优先级问题且必需检查通过可停止并列明暂缓项;若仍存在中/高/严重问题、必需证据未解决或检查失败,需通过宿主提问工具获得用户明确的有界延长决定,沉默不算延长。
  • 所有子审查、修复后重审与嵌套调用共享同一轮次预算,不另起循环或重置。
  • 只读模式在报告验证结果后停止,不修改源码。
  • 不可用的必需能力需在该步骤与证据处停止并询问用户后再做适配。
  • 经验审查仅在存在可观察界面时运行,无法提供证据时保持阻塞。
  • 协议步骤顺序除非用户批准偏离,否则保持不变。
  • 本资料未说明安装命令、价格、平台支持范围等具体信息,相关内容暂未提供。