Matt Pocock 分享代码注释清理提示词:四类分拣再加 lint 规则
mattpocockuk · x · 2026-11-20
TypeScript 知名教育者 Matt Pocock 分享一条长提示词,让 AI 代理系统性清理代码库中的注释。
提示词要求 AI 把每条注释归为四类:
- 同义反复:重复代码已可见的信息 → 删除
- 借口:为 hacky 实现开脱并使其在代码中扩散 → 删除注释,并创建 issue 修复底层 hack
- 过期:引用已失效的实现信息 → 删除
- 决策记录:记录重要的非显而易见决策 → 迁移进 ADR(架构决策记录)
完成后再让 AI:创建禁止注释的 lint 规则、采用棘轮策略(不要求一次删完)、在仓库里建一个 /delete-comment skill 便于日后重复执行、并估算删除注释后能减少多少行代码。作者结论:「我信了——注释有害。」
「编程与Agent」频道最新
- 实践者吐槽:Lean 编译通过的自然语言证明,读起来仍是错的 — jasondeanlee · 2026-11-21
- DeepMind 展示 Gemini 4 Neon 按勃朗峰真实地形写滑雪模拟器 — GoogleDeepMind · 2026-11-21
- pstack v0.15.46 更新:skills 精简、Gemini 加入评审面板 — petrusenko_max · 2026-11-21
- Hamel Husain 力挺 evals 心法:好流程远胜好工具 — HamelHusain · 2026-11-21
- Databricks Genie One 通过 MCP 把受管数据接入 ChatGPT 与 Claude — Wise_Ear_4064 · 2026-11-21
- 开源项目 acmdthat:进程内本地 AI 生成 CLI 命令 — ex-ex-pat · 2026-11-21