跳到正文
RadarAI· X:Lauren Tan(SpaceXSI,Grok Bot 工程负责人) (@poteto)·· 21 小时前AI 评分45

Lauren Tan 分享 pstack 的 /no-comments 技能,可让 agent 清理代码注释

AI 导读

Lauren Tan 在 X 上推荐 pstack 中的 /no-comments 技能,其链接指向 cursor/plugins 仓库的 SKILL.md,并建议让 agent 把它转成一条 lint 规则使用。该技能引用 Matt Pocock 的提示词,将代码注释分为同义重复、借口、过时、决策记录四类,分别执行删除、删除并提 issue 修复、删除、移入 ADR 的处理。

正文 · AI 翻译

lauren· @poteto · X·2026-11-21 05:58· 35 分钟前AI 评分61

AI 导读

作者推荐尝试 pstack 中的 /no-comments 技能,链接指向 cursor/plugins 仓库中的 SKILL.md,并建议让 agent 把它转成一条 lint 规则使用。引用的 Matt Pocock 提示词将注释分为同义重复、借口、过时、决策记录四类,分别删除、修复或归档进 ADR,并建议创建 lint 规则和可复用的 /delete-comment 技能。

正文 · 原文

引用Matt Pocock@mattpocockuk

今日提示词(很长的一条):

查看 <我的代码库 | 这段代码> 中的每一条代码注释。

将每条注释归类为:

  • 同义重复:只是重复了代码中已经显而易见的内容
  • 借口:许多注释让 agent 得以用取巧的实现蒙混过关,随后这种实现会在代码中蔓延
  • 过时:引用了不再相关的代码或实现信息
  • 决策记录:记录了关于代码的重要且不显而易见的决策

对每条注释采取以下操作:

  • 同义重复/过时:删除该注释
  • 借口:删除该注释并提交 issue 来修复取巧的实现
  • 决策记录:将其移入 ADR

完成上述操作后:

  • 创建一条 lint 规则,禁止 <我的代码库 | 这段代码> 中出现注释
  • 采取棘轮式推进,假设并非所有注释都会在本次 PR 中被删除
  • 在此仓库中创建一个 /delete-comment 技能,以便我们日后重复此流程
  • 为我估算一下,删除所有注释后我们将减少多少行代码

---

我被说服了——注释有害

在 X 查看被引用的帖子

来源:lauren · x.com

来源:RadarAI · aihot.news