SoulChildTc Skill Architecture Guide
什么时候用
这个 skill 管的是 Skill 的结构设计（文件怎么放、引用怎么指、description 怎么写），不覆盖 Skill 的 TDD 创建流程。如果用户同时需要创建流程指导，推荐配合 skill-creator 使用。
核心原则速览
| 原则 | 一句话 |
|---|---|
| 渐进式加载 | SKILL.md 精简，references/ 放细节，按需加载 |
| Self-Contained | 每个 reference 文件只做一件事，AI 独立读取 |
| 一级引用 | 所有引用从 SKILL.md 出发，不要嵌套 |
| 目录索引 | 超过 100 行的引用文件必须有目录 |
| 简洁为王 | 假设 AI 已经够聪明，不加冗余解释 |
快速导航
设计 SKILL.md 入口： references/frontmatter-and-entry.md
- Description 怎么写才准（含大量正反例）
- triggers / allowed-tools / preamble-tier 怎么配
- 意图路由表的构建方法
拆分 references/： references/file-structure-and-references.md
- 什么时候拆文件、什么时候合
- 渐进式加载的 3 种组织模式
- 长文件的目录结构规范
质量把关： references/quality-checklist.md
- SKILL.md 检查清单
- 引用文件检查清单
- Description 检查清单
- 常见反模式 + 修正方法
获取上下文
场景 A：用户要创建一个全新 Skill
- 读
references/frontmatter-and-entry.md设计元数据和入口 - 读
references/file-structure-and-references.md规划目录结构 - 产出后用
references/quality-checklist.md自检
场景 B：用户要审查/优化现有 Skill
- 用
references/quality-checklist.md逐项扫描 - 每发现一个问题，回到对应的 reference 文件看修正方法
- 修完一项再继续下一项