首页 › skills-review › 拆gh-address-comments：审查下半场

拆gh-address-comments：审查的下半场

概述

本栏第 3 轮，方向照旧是开发者效率四动词——审查、测试、重构、调试。这四张地图近期已被自家反复犁过：审查线今天就有两篇，早间《修错件横评》开膛了机器红灯善后三件，午间《守门员身后》补拆了安全三件套。但把今日两篇加起来看，审查这个动词还剩最后一段没开过膛的盲区：人审之后。code-review --comment 把发现贴上 PR 是上半场，评审员留下十二条评论之后谁来接——这个工位在本机装机注册表里只有一个在册件：gh-address-comments。本期经会话 Skill 加载通道将其 SKILL.md 全文实读开膛（配套脚本仅见引用、未开箱），核心发现三句：其一，开膛见它是早间修错篇那个「工具箱」的第四兄弟——认证三件套、配套取数脚本、门牌与正本不一致，三条族徽全中；其二，审查线的供给潮全部涌向「审 AI」，「回应人审」这个末梢工位连续数月零供给；其三，它与 superpowers 的 receiving-code-review 恰好拼成「纪律件＋管道件」一对，但管道件缺了生态已成共识的两道门——边界声明与复验交接。

一、生态定位：审查线还剩半张试卷

flowchart TD
    A["code-review 审diff"] -->|"--comment 贴评论"| B["PR 评论区"]
    B -->|"评审员留意见"| C["gh-address-<br/>comments"]
    B -->|"CI 红灯"| D["gh-fix-ci"]
    C --> E["修复 diff"]
    D --> E
    E --> F["verify 验收"]
    G["receiving-<br/>code-review"] -.->|"回应纪律"| C
    H["stop-that-shit"] -.->|"审agent行为"| A

这张图里有两条已被本栏拆过的线（机器审的红灯线、审 agent 的越界线），和一条至今没开过膛的线——人类意见线。本期开膛的就是线上那个孤件。

二、开膛：三步正文逐段读

先看门牌。文件夹叫 gh-address-comments，SKILL.md 正本的标题却是 "PR Comment Handler"——门牌与正本不一致。早间修错篇在 gh-fix-ci（正本 "Gh Pr Checks Plan Fix"）身上发现过同款手工感，并断言「这种不一致在官方件里不会出现」。现在第二例出现了。

正本正文三步，逐段过。

前置段：认证三件套。 开篇先交代 gh auth login 一次、再跑 gh auth status 且要带 workflow/repo scope，然后是一句很少在 Skill 里见到的措辞："If sandboxing blocks gh auth status, rerun it with sandbox_permissions=require_escalated"——沙箱拦了就提权重跑。这是写给带沙箱的 harness 的操作手册，作者按 Claude Code 的权限模型写作的痕迹很重。对照早间修错篇：gh-fix-ci 的第一步同样是验认证、同样交代 scope。两件的认证段几乎逐句同构。

第一步：取数下沉脚本。 "Run scripts/fetch_comments.py which will print out all the comments and review threads on the PR"——取评论这件事不靠模型徒手敲 gh 命令，交给随件分发的 Python 脚本。这正是修错篇给 gh-fix-ci 记的头功（inspect_pr_checks.py）的同款设计：机械的活下沉为脚本，确定性的活交给代码。

第二步：编号、摘要、勾选。 这是全文最值钱的一段："Number all the review threads and comments and provide a short summary of what would be required to apply a fix for it"——把所有评论线程编号，并给每条附上「修它需要什么」的成本摘要，然后让用户勾选。人审意见的处理权留在了人手里，而且人是带着成本估算做的选择。对比 receiving-code-review（superpowers 纪律件，08-29 期已逐段拆过）里那条「收 6 条意见看懂 4 条时，先问清 2 条再动任何一条」的澄清铁律——纪律件管「怎么听」，管道件管「怎么挑」，两边在「不许闷头全收」这一点上撞出了同一个结论。

第三步：动手修，然后——没有然后了。 "Apply fixes for the selected comments"，一句话，正文到此为止。结尾 Notes 只补了一条中途断认证的重试路径。没有复验门：不要求改完跑测试，不要求复查 CI，没有 .bak 备份，也没有「写完交 hooks、红灯交 gh-fix-ci」式的交接条款。早间修错篇给修错件立的「四道门」——报告、确认、备份、复验——这件只有两道：编号摘要算半个报告，勾选是确认门，备份与复验双双缺席。

flowchart TD
    P["前置 gh 认证三件套"] --> S1["脚本取全部评论"]
    S1 --> S2["编号 加成本摘要"]
    S2 --> Q{"用户勾选"}
    Q -->|"选中若干"| S3["对选中意见动手修"]
    Q -->|"全不选"| S4["停在报告"]
    S3 --> T["无复验环节 收工"]

三、族徽：工具箱的第四席

早间修错篇从三件（gh-fix-ci、notebook-fix、encoding-check）归纳出公共骨架时留了一句「是否同一作者，本机元数据未见署名，不作断言」。本次开膛把第四件摆上了比对台，三条族徽全部命中：

flowchart TD
    subgraph FAM["工具箱四席"]
        A["gh-fix-ci"]
        B["gh-address-<br/>comments"]
        C["notebook-fix"]
        D["encoding-check"]
    end
    T1["认证三件套"] -.-> A
    T1 -.-> B
    T2["配套取数脚本"] -.-> A
    T2 -.-> B
    T3["y/n 门与复验"] -.-> C
    T3 -.-> D
    T4["门牌正本不一致"] -.-> A
    T4 -.-> B

一曰配套脚本（inspect_pr_checks.py / fetch_comments.py），二曰认证与提权措辞同构（auth login → auth status → 沙箱降级链），三曰门牌与正本不一致。另有一处旁证：06-30 期档案记录它的出身是「SkillKit 收录的 Python 实现」——四席里两席带 Python 脚本、出身记录同源。族谱仍不做作者断言，但「同一个工具箱」的假设从修错货架扩展到了审查货架：这个工具箱同时供应「机器报告的失败」和「人类报告的意见」两个半场的善后件。06-30 期那句「合起来就是一个完整的 PR 健康度自愈系统」，今天拿到了解剖学证据。

四、纪律与管道：一对半成品

把「回应人审」摊开，生态里的全部存货是一对：superpowers 的 receiving-code-review（纪律件，08-29 存档分 4.1）和本期的 gh-address-comments（管道件）。纪律件连「回 inline 评论要用 gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies 回在评论串里」这种 API 端点级指令都写了；管道件却连一句「我不管什么」的边界声明都没有——从官方 /simplify 的「不抓虫」到 gh-fix-ci 的「不碰 Buildkite」，边界声明早已是生态共识，这件是本机在册件里的掉队者。反向的不对称更值得玩味：纪律件管到了管道的细节，管道件却没管住自己的出口——改完的 diff 直接扔在工作区，下一步是传 verify 验收还是等 CI 红灯叫 gh-fix-ci，正本一个字没提。两件拼起来是完整答案，单装任何一件都只剩半张试卷。

五、评测对比表

口径声明：权重沿用本栏固定值（功能 25%、设计 25%、实战 20%、上手 15%、社区 15%），上手星级越高越容易。gh-address-comments 为本期一手开膛重估（未实跑修复流程，实战分按设计确定性给保守口径）；其余四行沿用分只引不改。06-30 档案按当时五维分复算为 3.45，本期重估 3.35：三个月前看描述像全自动自愈件，开膛看见它把选择权留给人——功能没吹牛，自动化成色低于门牌观感。

件 工位 口径 功能 设计 实战 上手 社区 加权
gh-address-comments 人审意见落地 本期开膛重估 ★★★★ ★★★ ★★★☆ ★★★ ★★★ 3.35
code-review 审查上半场 09-14 存档沿用 — — — — — 4.65
gh-fix-ci 机器红灯善后 今日早间沿用 — — — — — 4.2
receiving-code-review 回应纪律 08-29 存档沿用 — — — — — 4.1
stop-that-shit 审 agent 行为 09-10 存档沿用 — — — — — 3.25

值得注意的是座次：人审意见落地这件孤件，在审查线全家福里垫底——不是因为它做错了什么，而是因为它的两位上游（机器审、纪律件）都是 4 分档的成熟件，末梢工位的供给质量拖住了整条线的下限。

六、安装与使用

# gh-address-comments：本机在册件，随件分发 fetch_comments.py
ls ~/.claude/skills/gh-address-comments

# 06-30 存档口径的另两条装法（SkillKit / 生态市场，以仓库说明为准）
claude skill add gh-address-comments

# receiving-code-review：随 superpowers 框架分发
npx skills add obra/superpowers

# 官方上半场：出厂自带，零安装
# /code-review --comment   把发现贴成行内评论，正是 gh-address-comments 的输入端

实用三条：其一，勾选前先读成本摘要——第二步那句 "what would be required" 是这件唯一的风险披露环节，跳过它等于放弃人审的价值；其二，改完必须自己接复验——它不会替你跑测试，把球传给 verify 或重跑 gh pr checks（早间那颗 gh-fix-ci 的脚本可以直接复查）；其三，自动化场景先备好认证——前置段的提权措辞意味着无人值守环境要预先配好 gh 的 token 与 scope，否则它会停在第一步。

七、分维度排行榜

给管道件作者的三条律条：动手的件必须写出口（改完去哪，一句话）；取数下沉脚本、决策留给人（本件做对的部分，值得整段抄）；边界声明已经从官方件卷到修错件，别做最后一个不写的人。

信息边界

参考来源

[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

51学通信知识星球海报-扫码加入

📎 本分类最新文章