单个SKILL.md文件拆分判断标准

什么情况下需要拆分单个SKILL.md文件为多个文件

📊 单个 SKILL.md 拆分的判断标准

✅ 应该拆分的情况

1. 文件行数超过阈值

📏 拆分阈值建议：

• 🟢 < 500 行：保持单文件
• 🟡 500-1000 行：考虑拆分（可选）
• 🔴 > 1000 行：强烈建议拆分
• 🚨 > 2000 行：必须拆分

---

2. 存在明显的独立使用场景

拆分信号：

• ✅ 新手用户只需要查看"基础操作"部分
• ✅ 高级用户只需要查看"高级定制"部分
• ✅ 运维人员只需要查看"部署运维"部分

拆分方案示例：

SKILL.md（总览 + 快速开始）
├── SKILL_basic.md（基础操作：创建服务、添加组件）
├── SKILL_advanced.md（高级功能：定制 main.go、优雅关闭）
└── SKILL_deployment.md（部署运维：构建镜像、发布流程）

---

3. 章节内容膨胀

拆分信号：

• ✅ 某个章节超过 300 行（如"常用技能"章节过大）
• ✅ 某个章节包含 10+ 个子主题
• ✅ 某个章节需要频繁更新，影响其他章节

---

4. 维护成本过高

拆分信号：

• ✅ 每次更新都需要滚动很久才能找到目标章节
• ✅ 多人协作时频繁产生合并冲突
• ✅ 用户反馈"文档太长，找不到想要的内容"

---

5. 需要独立版本管理

拆分信号：

• ✅ 某些章节需要独立发布（如"部署指南"需要单独给运维团队）
• ✅ 某些章节需要独立的更新频率（如"常见问题"需要频繁更新）

---

❌ 不应该拆分的情况

1. 内容高度相关，需要一起查阅

• 例如："创建服务" → "添加方法" → "添加数据库" 是连贯的操作流程
• 拆分后会导致：用户需要在多个文件间跳转，降低效率

2. 文件较小（< 500 行）

• 过度拆分会增加维护成本
• 用户需要记住多个文件的用途

3. 拆分后会产生大量重复内容

• 例如：每个文件都需要重复"安装"的说明
• 解决方案：保持单文件，或使用引用链接

📝 拆分决策流程图