个人站点

主线 · 第 3 / 5 篇

· 约 5 分钟

规则越积越多以后:拆分规则文件与整理 Skill

2026 年 6 月到 7 月,一个越写越长的全局规则文件被拆成几份按需读取的文件,职责互相重叠的几个 Skill 也理了一遍。

本文目录 5 节
  1. 一个文件装下了所有规则
  2. Skill 之间开始重叠
  3. 7 月 26 日的整理
  4. 这一轮也有加法
  5. 参考资料

本文回答的问题

规则和 Skill 越积越多以后,怎么判断哪些该拆开、哪些已经重复?

规则和 Skill 用了几个月,越攒越多。6 月我整理了一次规则文件,7 月又整理了一次 Skill。

一个文件装下了所有规则

到 5 月中旬,我的全局规则都写在一个文件里,已经有 156 行。语言风格、任务分流、澄清方式、前端分工、子代理、验证和提交格式,全在里面。宿主每次开始任务都要读这个文件,改一处文案也得先把整份规则读完。

6 月 2 日,我把它拆开了。全局文件只留每次都要用的部分,完整项目的流程和多模型协作各写成一份 SOP,开头写明什么时候才读。

全局规则文件 · 156 行每次整份读取
6 月 2 日
拆开,按需读取
全局规则每次都读
项目 SOP完整项目、接手项目、大重构、复杂 bug 时读
协作 SOP需要其他模型、多个 Agent 或正式交接时读;轻量任务不加载
规则从整份读取改为按任务需要加载

思路和 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。

参考资料

本文涉及的知识点

10 个

名称打开知识图谱中的对应条目;「另见」只计已发布文章。