我们把 Claude Code 技能的 reference.md 合并回 SKILL.md，这个决定错了吗？

作者团队在 2026 年 9 月 18 日将 9 个 Claude Code 技能中 7 个的 reference.md 内容合并回 SKILL.md，与官方文档建议的拆分做法相反。合并后 8 个技能各为单文件，长度 107 至 421 行；此前被移除的 reference.md 为 39 至 288 行。作者称同周的一次测量显示拆分方案本可奏效，并有一次运行暴露了单文件方案的成本，因此发帖询问其他团队如何拆分技能文件。

AI推荐理由 来自实际运行 Claude Code 技能管道的团队，记录了将 reference.md 合并回 SKILL.md 的具体决策、文件行数范围与一次同周测量，对使用 Claude Code skills 的开发者有实践参考；但作者自述测量结果与官方文档建议相左，且为提问式帖子，结论未定，样本有限。