SuperAPI AI 工具集

gs-pr-comment

编程与开发

查看项目

更新于 11-15 16:33

技能介绍

gs-pr-comment 用于代替用户在 GitHub 上撰写并发布评论,适用于拉取请求、议题、行内评审回复等场景。

用途:让 agent 代写的评论保持统一归属说明与一致的行文风格,同时把技术观点表达得清楚、可核查。

主要能力:

  • 归属说明:每条 agent 撰写的评论以 GitHub NOTE 提示块开头,写明撰写评论的模型名称与所代表的用户,全评论仅保留这一处表情符号。拉取请求描述、提交信息以及用户要求原文照发的文本不加此说明。
  • 写作规范:先给结论,以修复方案或下一步收尾;引用代码位置写作 file:line,标识符使用反引号;事实与判断分开陈述,并说明未验证的部分;使用完整句子和明确的行为主体;用具体数字或机制替代副词;最多加粗开头的一个词。
  • 可视化表达:一句话不足以说明时附图,可选建议块(可一键应用)、diff 块、追踪树、标注缺失分支的伪代码、Mermaid 时序图、浅层文件树或调用树,每条评论通常一个视图即可。
  • 发布流程:检查评论(含引用、命令输出、附件)中的密钥、令牌、本地绝对路径与隐私信息并移除;预览 Markdown 渲染效果;把正文写入仓库外的文件,再通过 gh pr comment --body-file 或 gh api --input 提交,避免文本被当作 shell 语法;确认 GitHub 返回评论链接后再解决评审线程。

使用方式:资料提到该技能会在需要代表用户评论时触发,并要求先经 gs-unslop 润色草稿、用 gs-show-me 选择并绘制视图;两个配套技能未安装时,则按资料中列出的规则和可渲染视图清单执行。

适用场景:PR 与议题的顶层评论、行内评审意见、回复机器人或评审者、在解决或驳回反馈前发布书面说明。

限制:不适用于 PR 描述、提交信息和不要求归属说明的原文张贴;不得用 HTML 文件承载评论配图;模型名称未知时使用 harness 名称而非猜测;不使用破折号、标题、签名页脚或第二处归属说明。