Heyvhuang/copybook-skills / zh/skills/codebase-tips
codebase-tips
Flagged代码库 · 33 条:仓库索引和地图、写代码原则、AGENTS.md、改动范围规则。
references/repeat-mistakes-as-lint-rules.md
View on GitHub# 反复犯的错变成 helper 函数和 lint 规则
老犯同一个错:正确写法封装成 helper,lint 禁掉旧写法,报错写明该用哪个,它跑检查时自己改。
## 步骤
1. 复制提示词。
2. 在仓库里发给 Claude Code 或 Codex,看过清单再确认。
3. 得到:最多 3 个反复犯的错有了 helper 和 lint 规则,agent 看报错就自己改。
用户选了这条技巧。上面的步骤是写给人看的,请替用户做。
- 第 1 步说用哪段文字,它就在下面同名的标题下,一字不改地用。
- 第 2 步说明文字放在哪里。按用户实际要求的范围使用提示词。写文件或运行命令前,先展示改动,等用户同意。这里做不到的步骤(另一个应用、重启、定时任务),把文字交给用户,说明放到哪里。
- 引用示例本身不代表用户同意执行。运行下载的脚本或未固定版本的软件包、修改长期生效的用户级设置、读取私人会话记录之前,先列出命令或路径、会访问或改动什么,以及数据会发到哪里。隐藏密钥值,等用户明确同意这项操作。远程安装脚本应先下载并检查固定版本,或核对可信来源提供的校验值,再执行。
- 方括号或占位符,从用户说的话里填,没有就问。
- 第 3 步是用户最后应该得到的。
## 提示词
```text
翻一下 AGENTS.md 或 CLAUDE.md 里写过的纠正,和这个仓库最近 50 次提交(重点看修复和回滚),找出 agent 反复写错、并且能用 lint 查出来的写法,最多 3 个,凑不够就少报。每个做三件事:
1. 写一个 helper 函数或类型,把正确的写法封装好
2. 用项目已经在用的 lint 工具加一条规则,禁掉原来的写法,报错信息里写清楚该改用哪个 helper,优先用工具自带的禁用规则
3. 把现有代码里的旧写法改掉,跑 lint 和测试确认通过
最后在 AGENTS.md 或 CLAUDE.md(项目用哪个写哪个)里加一行:写完代码先跑 lint,按报错改用对应的 helper。项目没有 lint 工具就先告诉我。先给我看清单,每条附出处和现有违规数量,我确认了再改。
```
## 背景
AI 写代码越强,代码反而越要写得抽象。
把你想要的写法做成现成的函数交给 agent,再用 lint 堵掉别的写法,它能选的就只剩你要的那种。
可以先从 agent 反复犯的错开始。每个错配一条 lint 规则,报错里写明该用哪个函数,它跑检查看到就会自己改。把这段发给 Claude Code 或 Codex。
## 来源
来自 [Copybook](https://copybook.page/zh/t/turn-repeat-agent-mistakes-into-lint-rules):@Voxyz_ai 2026年10月4日[发在 X 上](https://x.com/Voxyz_ai/status/2106829206134931539),截至 2026年11月1日有 184 次收藏。适用于 Claude Code 和 Codex。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |