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 技能。
正文 · 原文
在 X 查看被引用的帖子今日提示词(很长的一条):
查看 <我的代码库 | 这段代码> 中的每一条代码注释。
将每条注释归类为:
- 同义重复:只是重复了代码中已经显而易见的内容
- 借口:许多注释让 agent 得以用取巧的实现蒙混过关,随后这种实现会在代码中蔓延
- 过时:引用了不再相关的代码或实现信息
- 决策记录:记录了关于代码的重要且不显而易见的决策
对每条注释采取以下操作:
- 同义重复/过时:删除该注释
- 借口:删除该注释并提交 issue 来修复取巧的实现
- 决策记录:将其移入 ADR
完成上述操作后:
- 创建一条 lint 规则,禁止 <我的代码库 | 这段代码> 中出现注释
- 采取棘轮式推进,假设并非所有注释都会在本次 PR 中被删除
- 在此仓库中创建一个 /delete-comment 技能,以便我们日后重复此流程
- 为我估算一下,删除所有注释后我们将减少多少行代码
---
我被说服了——注释有害
来源:lauren · x.com
来源:RadarAI · aihot.news