其他
创建或重构 Claude 技能时…
适用于为 Claude 创建、更新、打包或重构技能，尤其是技能超过 150 行、需要把详细内容拆到 references 的场景。
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
GDI C 35/100
进化评分（GDI）
综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
创建或重构 Claude 技能时，用渐进特定
解决思路
- 先收集 3-5 个真实使用示例，并明确用户会说什么来触发该技能、该技能应完成哪些任务。
- 从具体用法示例开始设计技能，而不是从抽象概念开始。
- 根据示例规划可复用组件：重复代码抽成 scripts，领域知识写成 references，模板/图片/字体等输出素材放到 assets。
- 运行 `scripts/init_skill.py <skill-name> --path <output-directory>` 初始化技能模板结构。
- 实现 scripts、references、assets，并更新 SKILL.md；写作时全程使用祈使语气（动词开头），不要用第二人称。
- 如果技能总长度超过 150 行，应用渐进式披露：入口点保持 <200 行，最佳 140-160 行。
- 运行 `scripts/package_skill.py <path/to/skill-folder>` 校验技能并生成可分发的 zip 包。
- 在真实任务中使用技能，记录遇到的问题，并据此持续迭代更新技能。
- 设计技能时使其提供四类核心能力：专用工作流、工具集成、领域专业知识、捆绑资源。
- 了解并利用三级加载：元数据（name + description，约 100 词）始终在上下文中；SKILL.md 正文在技能触发时加载（<200 行，最佳 140-160 行）；bundled resources 按需加载（无限制）。
- 每个组件只解决特定的重复需求。
- 技能目录使用标准结构：SKILL.md 必需；scripts/、references/、assets/ 为可选。
- 当同一段代码被反复重写或需要确定性执行时，把它做成 scripts（Python/Bash）。
- 当需要详细规格、工作流、schema、API 文档时，把它们放进 references，每个参考文件 150-500 行。
- 当需要模板、样板文件、图片、字体用于输出时，把它们放进 assets。
- 入口点只保留核心工作流、导航和提醒，最佳长度 140-160 行。
- 对超过 150 行的技能，在 frontmatter 添加 progressive_disclosure，包含 summary、when_to_use、quick_start。
- 在 progressive_disclosure.references 中列出参考文件（如 skill-structure.md、creation-workflow.md、progressive-disclosure.md、best-practices.md、examples.md）。
- 将入口点缩减到 140-160 行，只保留核心工作流和导航。
- 创建 3-5 个参考文件，每个 150-500 行。
- 按主题组织参考文件：结构、工作流、最佳实践、示例。
- 添加导航章节，链接所有参考文件。
- 避免重复：同一信息只放在一个地方，入口放摘要，参考文件放细节。
- 保持组件职责清晰：scripts 放代码，references 放知识，assets 放模板。
- 分享前必须运行 `scripts/package_skill.py` 校验并打包，不要跳过校验。
- 如果发现自己想把所有细节写进 SKILL.md，停止并把细节移到 references。
- 如果发现使用第二人称，停止并改为祈使语气。
- 如果入口和参考文件出现相同信息，停止并删除重复。
- 如果 description 太泛，停止并把激活条件写具体。
- 如果 init 脚本生成的示例文件未使用，停止并删除未使用资源。
- 如果在没有使用示例的情况下创建技能，停止并先收集具体使用场景。
- 如果入口点超过 200 行，停止并应用渐进式披露。
- 在 frontmatter 中维护 name、description、license 等元数据；若技能不应被用户直接调用或不触发模型调用，设置 user-invocable: false 和 disable-model-invocation: true。
- 参考 mcp-builder、testing-anti-patterns 等渐进式披露示例来学习入口精简和参考文件拆分。
- 通过渐进式披露按需加载参考文件，以节省上下文并提升可维护性：只更新特定 reference，不必改动入口点。
适用边界 · 注意事项
- 不适用于不需要创建、更新、打包或重构 Claude 技能的场景。
- 不适用于技能很短（≤150 行）且无需拆分参考文件的简单技能；此时不必强行应用渐进式披露。
- 不适用于没有 Claude 技能格式或无法使用 scripts/init_skill.py、scripts/package_skill.py 的环境，不要照搬该脚本流程。