SuperAPI AI 工具集

hrt-mr-brief

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:在 tempa-spec 的 apply 阶段结束时,于变更目录中 tasks.md 旁生成 mr-brief.md,供评审者快速了解变更内容、验证其有效并评估出错代价。该技能改编自 mattpocock/skills 的 pr 技能(MIT),三部分结构源自 Dex Horthy 的 show-me 技能。

主要能力:输出固定三节——Summary(一个可视化加至多两句)、Evidence(关键行为的执行证据,含失败测试名与失败行、同一测试通过、整套测试结果)、Merge Danger(Door 单向或双向、Blast Radius 一词加说明)。内容仅来自 tasks.md、specs/**/*.md、design.md、align.md 中改变行为的决策条目、工作区 diff 及本次会话测试输出。

使用方式:在 hrt-apply-code-review 完成后运行一次,写入最终版本并提示用户随代码提交。若文件已存在则按当前状态重写而非追加。若评审循环以未解决 HIGH 发现结束,仍要写文件,阻塞项置于 Merge Danger 首位。

限制:只写文件,绝不发布内容、不运行 git commit/push 或与评审系统通信。仅陈述可追溯到工件、diff 或本次测试运行的事实。不得写入令牌、密钥、密码、含凭据 URL、邮箱、电话、身份证号。不得在 issue 引用旁写 Closes/Fixes/Resolves,可用 Related to #N。正文行首不得以 / 开头。不得使用指向变更目录文件的相对链接。若 Phase 1 RED 输出未记录,写 Before: not recorded,不得重建失败。

适用场景:需要为合并请求提供结构化说明的代码变更评审。分类依据其面向代码变更评审与合并说明的用途,归入 testing。