subskill-generation-rule

核心用法

Subskill Generation Rule 是一个纯文档型的规范指导技能，旨在为 Skill 开发者建立标准化的项目组织规则。该技能定义了五条核心规则：将生成的推荐结果存储在 data// 目录；将新功能代码脚本放置在 subskills/<feature>/ 目录下；每个功能独占一个子文件夹；在需要说明行为或用法时，在功能文件夹内添加 SKILL.md；避免在主技能根目录堆积一次性脚本和生成文件。

显著优点

该技能的最大价值在于提供了经过验证的工程实践规范。通过强制性的目录隔离，开发者可以有效避免技能根目录的混乱，使项目结构一目了然。subskills// 的模块化设计支持功能的独立迭代和版本管理，降低了大型项目的维护复杂度。此外，纯文档形态意味着零运行时开销，可随时查阅而无需担心性能影响。

潜在缺点与局限性

作为纯规范文档，该技能本身不具备任何自动化执行能力——它不会自动帮你创建目录或移动文件，开发者需要手动遵循这些规则。对于小型、单一功能的技能项目，这种分层结构可能显得过度设计，增加了不必要的目录深度。此外，规范中未提供与现有 CI/CD 流程或自动化工具的集成方案，团队需要自行补充配套工具链。

适合的目标群体

该技能特别适合以下场景：正在开发多模块、可扩展 Skill 系统的技术团队；需要长期维护、频繁迭代的 Skill 项目；希望建立统一代码规范的开发组织；以及从单体 Skill 向微服务式架构迁移的开发者。对于个人快速原型开发或一次性脚本，该规范的必要性较低。

使用风险

该技能本身无代码执行风险，但需注意：若团队成员未严格遵循规范，可能导致目录结构再次混乱；data// 目录的广泛使用若缺乏清理机制，可能累积大量历史文件；子技能间的依赖关系若未在文档中明确说明，可能引发模块耦合问题。建议配套制定代码审查清单和定期重构计划。