主线 · 第 3 / 5 篇
· 约 5 分钟
规则越积越多以后:拆分规则文件与整理 Skill
2026 年 6 月到 7 月,一个越写越长的全局规则文件被拆成几份按需读取的文件,职责互相重叠的几个 Skill 也理了一遍。
本文回答的问题
规则和 Skill 越积越多以后,怎么判断哪些该拆开、哪些已经重复?
规则和 Skill 用了几个月,越攒越多。6 月我整理了一次规则文件,7 月又整理了一次 Skill。
一个文件装下了所有规则
到 5 月中旬,我的全局规则都写在一个文件里,已经有 156 行。语言风格、任务分流、澄清方式、前端分工、子代理、验证和提交格式,全在里面。宿主每次开始任务都要读这个文件,改一处文案也得先把整份规则读完。
6 月 2 日,我把它拆开了。全局文件只留每次都要用的部分,完整项目的流程和多模型协作各写成一份 SOP,开头写明什么时候才读。
思路和 5 月那次差不多:那次减的是每个任务要走的步骤,这次减的是每次都要读的规则。
6 月 5 日,我又建了一个独立的仓库,专门存放这些规则、Skill 和配置。规则多到这个程度,本身就需要备份和记录版本,换电脑时也要能迁移过去。
Skill 之间开始重叠
规则拆开了,Skill 却还在变多。碰到新问题,我习惯补一个新的 Skill。到 7 月,负责跨阶段协调的 dev-workflow、负责记录计划的 planning-with-files、负责长任务中断后恢复的 long-task-continuation 都在用,另外还有几个只管一件小事的 Skill。
它们开始互相抢活。dev-workflow 一看到「实现」「bug」「review」这类词就接手,哪怕任务一步就能做完。planning-with-files 会建一份计划文件,long-task-continuation 又另起一套状态目录,同一个任务的进度可能散在好几个地方。上一篇说过,一个任务的情况只记在一个地方,这条又被 Skill 打破了。
7 月 26 日的整理
整理时我给的要求是:有用的留下,缺的补上,但几个轻量工具拼起来以后,不能又变回一条长流程。
整理完,dev-workflow 不会再因为看到某个词就去接手一步能做完的事。planning-with-files 默认不建文件,只有项目没用 Trellis、状态又可能丢的时候才建一份。long-task-continuation 不再另起目录,只更新已有的那份状态。这三个 Skill 也不再自动一个接一个地启动。
另有四个小 Skill 退役,记录里都写明了原来的做法交给了谁。
| 退役的 Skill | 保留下来的做法 | 由谁接手 |
|---|---|---|
| grill-with-spec-lite | 一次只问一个问题、信息够了就停 | grill-with-me-lite |
| plan-minimum | 把执行切成最小的一步 | 宿主自带的规划或 Trellis |
| targeted-test-loop | 最小复现、相邻功能的回归检查 | 调试 Skill 和按风险决定的验证 |
| isolated-worktree-lite | 留意未提交的改动、不自动清理 | 协作规范 |
还有一个把 HTML 转成 Word 的自定义 Skill 也停用了,原因不一样:宿主的官方文档插件已经能做这件事。
这一轮也有加法
整理也不全是删。我用来让其他模型参与协作的脚本,之前没限制外部模型能改哪些文件。这次补了一项检查:外部模型只做分析或审查时,不能改产品源码;让它动手时,只能改事先批准的范围。脚本因此多了三百多行,我知道它会变复杂,还是加上了。Playwright MCP 和宿主自带的浏览器功能有重叠,整理时一度想停掉,最后还是留着备用,只是分清了各自什么时候用。
澄清规则也多了一条:信息够了、一个问题都不用问的时候,要说一下为什么不用问、按什么假设来做、下一步做什么。
7 月 27 日,全局规则里又加了一条写代码的顺序:先看项目里有没有现成的实现,再看标准库、平台自带的功能和已经装好的依赖,都不够用才写新代码,而且尽量少写。眼下用不到的依赖、封装和配置,不为以后可能的变化提前加。
这部分参考了 Ponytail。我没有安装它的整套工具或独立 Skill,只吸收了实现阶梯、过度设计检查,以及简单方案的升级条件。选了一个简单方案,也要记清它适用到什么规模,出现什么信号时再升级。这些规则进入了现有的全局约定、Trellis 开发检查和审查入口。
同一天还接入了 Architecture Bootstrap。长期项目没有可信架构基线时,先把模块职责、依赖方向、事实来源和检查规则写进项目规范,让后续任务读取同一份基线。已有基线并且仍与代码一致,就继续复用;临时原型和一次性脚本跳过。这项机制先明确项目的结构边界,Ponytail 吸收来的规则则用于后续实现中的取舍。
到 7 月底,全局规则文件缩到了四十多行,只留下怎么分派任务和几条不能碰的底线,细节都放进了两份 SOP。
参考资料
- Ponytail 7 月历史版本说明:上游的规则和工具;本文只采用其中部分原则。
本文涉及的知识点
10 个
名称打开知识图谱中的对应条目;「另见」只计已发布文章。
本节知识点