AI Skill 大全

代码注释审查

给一个 PR 或分支,它会列出这轮新增的每条注释并逐条判定裁掉、精简、改写还是补充,只改注释不动代码。

功能与用途

PR 里堆着一大堆复述代码的注释、AI 味的步骤旁白,还有一个真正该说清楚的约束没写。这个 Skill 按仓库自己的注释规范(contract、why、hazard、map 四种用途)逐条过一遍:先跑机械检查兜住明显问题,再把新增和被删的注释都翻出来,用五道检查一条条判,最后只做注释层面的修改,代码结构和命名一个字都不碰。它强调宁可删掉也不编造原因,报告只在对话里给,不往 PR 上写东西。

适用场景

  • 接手一个 AI 辅助写的分支,注释里全是「第一步」「然后」这:接手一个 AI 辅助写的分支,注释里全是「第一步」「然后」这类旁白,提评审之前想先把它们清掉
  • 评审时被指出代码里有个隐含的顺序约束没写下来,需要它找出这类:评审时被指出代码里有个隐含的顺序约束没写下来,需要它找出这类该补的契约和风险注释
  • comment-lint 报了若干条规则,但有些是误报需要人:comment-lint 报了若干条规则,但有些是误报需要人判断,想让审查区分机械问题和真问题
  • 只想先看看这个分支的注释质量如何,暂时不打算改动代码:只想先看看这个分支的注释质量如何,暂时不打算改动代码

适用人群

  • 提交 PR 前想先自己清一遍的开发者
  • 负责评审并维护注释规范的团队技术负责人
  • 接手遗留分支需要整理注释的维护工程师

使用步骤

  1. 给出 PR 编号、分支名或基准引用,说明是只出报告还是要直接修改
  2. 让它先定范围:取到 PR 的头分支和它自己的基准分支,算出两者的分叉点,别默认按主干来算
  3. 让它跑机械检查并列出本分支新增和被删的全部注释行,确认没有漏掉被重写后消失的那半句
  4. 看它逐条给出的裁决,重点检查标记为「补充」的地方是否真有必要、标记为「裁掉」的是否会丢信息
  5. 要修改的话先读一遍规则文件,改完按语言跑对应格式化,再重跑机械检查确认干净

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
进阶
版本
main
最近更新
2026-09-17
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

>-

使用前准备

  • 需要 git 与 gh CLI、Node 环境,以及仓库自带的 comment-lint 脚本和格式化任务(前端格式化前需先装依赖)

依赖与权限

  • 读取用户主动提供的内容

同类 Skill