Skip to content

Heyvhuang/copybook-skills / zh/skills/codebase-tips

codebase-tips

Flagged

代码库 · 33 条:仓库索引和地图、写代码原则、AGENTS.md、改动范围规则。

代码库 · 33 条

Copybook 的 33 条「代码库」技巧,收藏多的在前。每条要用的文字、放到哪里、最后得到什么,都在 references/ 里它自己的文件中。

  • 用户点名技巧时,用点名的那条。用户只说了要做什么时,从适用于实际执行者的技巧里,选最符合用户目标和限制的一条。几条同样合适时,选一条即可。选中后,用一句话说明选了哪条、为什么,再读它的文件照着做。另一条也合适,而且换用它会明显改变做法或结果时,顺带点出它的名字和区别。
  • 用户什么都没说:把下面的列表(每条的名字和做什么)给用户看,问用哪条。
  • 都不合适就直说,并建议用 copybook,它会在全部 144 条里找。
技巧做什么
开源侦察员和收尾者提示词 open-source-scout-and-closer不熟的功能从零写、问要不要继续:先搜 GitHub,再把整个活干完,附一份大白话总结。
codebase-memory 仓库索引 codebase-memory-repo-index每个问题几十轮 grep 和读文件:仓库连成一张函数、文件和依赖的图,顺手找出能安全删的死函数。
Karpathy 的 4 条写代码原则 karpathys-4-coding-principles过度设计、顺手改旁边的代码:先想再写、简单优先、改动要准、目标驱动,4 行写进 CLAUDE.md。
vibe coding 后的清理:5 条 Codex /goal 提示词 vibe-coding-cleanup-prompts额度重置时还剩一半:清掉死代码、重复实现和用不上的依赖,给定时任务和旧 worktree 分好类。
能点的仓库地图 clickable-repo-map改一个仓库前先看清它:点任一模块,看到调用方、依赖、相关测试和源码证据,地图随代码更新。
Scope Guard:不让小任务越做越大的规则 scope-guard-rules改个配置就搭框架、修个 bug 就加一层:够用的最小改动,复用现有代码,扩大范围先问你。
开发遗留文件的磁盘地图 disk-map-of-dev-leftovers硬盘快满时先别乱删:只读扫一遍,树状图标出开发留下的大文件夹,清理脚本只删你勾选的。
Claude Code 和 Codex 共用的 AGENTS.md one-agents-md-for-both-agents两个 agent 同一套做法:先规划、最小改动、分活、修 bug、做完先验证,每次纠正记进 Lessons。
理清面条代码的 /goal untangle-goal几个月 vibe coding 让代码缠成一团:一页 HTML 接线图,最严重的结标红编号,再逐个修、逐个跑测试。
Codex 动手前先调查和计划的提示词 investigate-and-plan-prompt怕 agent 做错方向:先查仓库、复述目标、列假设和计划,批准才动手。
反复的 PR 意见写成 AGENTS.md 规则 pr-comments-as-agents-md-rules同一个 reviewer 反复提的问题:gh 扫最近 50 个 PR 排出来,选中的写成全局规则,不用再靠人提醒。
Archify:从代码画系统图 archify-system-diagrams要给人讲清系统结构:从代码生成一张能搜索、能追踪上下游、能对比版本的 HTML 图,可导出 PNG。
REA:拆开别家 app 的功能 rea-take-apart-a-feature看中别家 app 的功能却不知道怎么做的:一层层拆开,每个结论标出证据,最后拿到自己实现的计划。
少写防御式代码:4 条 AGENTS.md 规则 less-defensive-code改一点点也要层层判空:Codex 只在数据进来的地方检查一次,之后直接用。
代码清理提示词:模块更少、更深 fewer-deeper-modules功能跑通了,代码却到处重复:重复的删光,核心逻辑归到一处。
CI 耗时审计:150 次运行,9 项检查 ci-time-audit代码几分钟写完,每个 PR 却在等 CI:最慢的 5 个任务拆成排队、准备和运行,每处改动指到哪一行。
agent 工作区清点 agent-workspace-auditagent 越用越笨先别怪模型:说明、skill、MCP 和记忆列成「保留 / 删除」清单,你批准后再清。
agent 记忆工具:8 个仓库分 4 类 agent-memory-tools-8-reposagent 记不住代码、资料、对话和长任务:8 个仓库分 4 类,每类挑一个装,装前先给你看命令。
带 ASCII 图的全项目审查 whole-project-audit坏的、不一致或用不上的代码:改动前先讲清它怎么连起来,有把握的修掉,其余列出来。
AGENTS.md 瘦身:3 套方案并排 3-slimmer-agents-md-plansAGENTS.md 超过 200 行就不照做了:3 版更精简的并排,一版比一版激进,不丢规则,改前先给你看。
还没用户就不写兼容代码:AGENTS.md 规则 no-compatibility-code-yet项目还没人用,agent 却在写兼容代码:跳过兼容和迁移,每次改动走文档、测试、最小实现、清理。
deny、ask、allow 权限规则 deny-ask-and-allow-permissions顺手删过「看起来没用」的配置:危险命令直接拦,push 和发布前先问,日常放行,deny 永远优先。
加边界代码前先问:AGENTS.md 一行 ask-before-edge-case-codeagent 总为几乎不会发生的边界情况加代码:一行规则让它先说会出什么问题、概率多大,等你点头。
从会话里写出的项目说明 instructions-from-your-sessions每开新会话都要重讲一遍背景:从最近 20 个会话里捞出来,写成一份项目说明,以后不用再说。
让 Claude Code 给自己做 Mod 的提示词 mod-request-for-claude-code想改 Claude Code 自己的界面或行为:这段提示词先找现成的 Mod,没有就提一个最小的方案。
清理前的 ~/.codex 和 ~/.claude 分类 codex-and-claude-sorted怕清理时把聊天记录也删了:每项分到 Keep、History、Work、Clearable 或 Unknown,命令逐条批准。
最近 20 个会话里的 mod 点子 mod-ideas-from-20-sessions反复提的要求、中途叫停或撤销的命令、检查改动的方式:按帮助大小排好,引用你的原话。
/teach:拿自己的项目学战略型编程 teach-strategic-programming贵的 token 花在 AI 替代不了的事上:先问你代码库的 3 个问题,写出 MISSION.md 和课程,拿项目教你。
写进 CLAUDE.md 或 AGENTS.md 里的修 bug 循环规则 bug-fix-loop-rulesagent 既修又审,就会一直来回拉扯:修两次不好就停,只审这一轮的改动。
ub-mode:Clean Code 作者的 agent 规则 ub-mode-clean-code-agent-rulesagent 的代码藏着 bug,测试骗你:每次改动都照这个 skill 来,自带 crapper、dryer、mutator 检查。
能点的仓库地图:叫法 vs 代码名 repo-map-words-vs-names你怎么叫一个模块,和代码里怎么叫它对不上:每一处都标红,最容易导致改错的排在最前。
反复犯的错变成 helper 函数和 lint 规则 repeat-mistakes-as-lint-rules老犯同一个错:正确写法封装成 helper,lint 禁掉旧写法,报错写明该用哪个,它跑检查时自己改。
skill 按场景路由的规则 situation-routing-for-skillsagent 常常忘了用装好的,你只好一个个点名:每个任务挑最合适的,一句话说明哪个、为什么。
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall