代码注释审查
给一个 PR 或分支,它会列出这轮新增的每条注释并逐条判定裁掉、精简、改写还是补充,只改注释不动代码。
功能与用途
PR 里堆着一大堆复述代码的注释、AI 味的步骤旁白,还有一个真正该说清楚的约束没写。这个 Skill 按仓库自己的注释规范(contract、why、hazard、map 四种用途)逐条过一遍:先跑机械检查兜住明显问题,再把新增和被删的注释都翻出来,用五道检查一条条判,最后只做注释层面的修改,代码结构和命名一个字都不碰。它强调宁可删掉也不编造原因,报告只在对话里给,不往 PR 上写东西。
适用场景
- 接手一个 AI 辅助写的分支,注释里全是「第一步」「然后」这:接手一个 AI 辅助写的分支,注释里全是「第一步」「然后」这类旁白,提评审之前想先把它们清掉
- 评审时被指出代码里有个隐含的顺序约束没写下来,需要它找出这类:评审时被指出代码里有个隐含的顺序约束没写下来,需要它找出这类该补的契约和风险注释
- comment-lint 报了若干条规则,但有些是误报需要人:comment-lint 报了若干条规则,但有些是误报需要人判断,想让审查区分机械问题和真问题
- 只想先看看这个分支的注释质量如何,暂时不打算改动代码:只想先看看这个分支的注释质量如何,暂时不打算改动代码
适用人群
- 提交 PR 前想先自己清一遍的开发者
- 负责评审并维护注释规范的团队技术负责人
- 接手遗留分支需要整理注释的维护工程师
使用步骤
- 给出 PR 编号、分支名或基准引用,说明是只出报告还是要直接修改
- 让它先定范围:取到 PR 的头分支和它自己的基准分支,算出两者的分叉点,别默认按主干来算
- 让它跑机械检查并列出本分支新增和被删的全部注释行,确认没有漏掉被重写后消失的那半句
- 看它逐条给出的裁决,重点检查标记为「补充」的地方是否真有必要、标记为「裁掉」的是否会丢信息
- 要修改的话先读一遍规则文件,改完按语言跑对应格式化,再重跑机械检查确认干净
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-17
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
>-
使用前准备
- 需要 git 与 gh CLI、Node 环境,以及仓库自带的 comment-lint 脚本和格式化任务(前端格式化前需先装依赖)
依赖与权限
- 读取用户主动提供的内容