用途:把 Claude Code 技能升级到 Skills 2.0 合规规范。Skills 2.0 基于渐进式披露:frontmatter 负责路由与发现,SKILL.md 为工作指南(小于500行),references/ 放按需加载的重内容。适用于 frontmatter 缺失或格式错误、正文超500行、孤立目录、引用链接失效、description 缺少 Use when... 模式、合规评分低等场景;不用于技能内部的功能开发。
主要能力:先选择升级范围,再用 scripts/diagnose.sh <skill-or-directory> [--json|--verbose] 诊断并给出评分与问题;分阶段修复:P1-P2 自动补 frontmatter、把 name 规范为 kebab-case;P3 半自动把描述改为 Use when... 模式并保留韩文、专有名词和缩写;P4 确认后为参考类技能加 disable-model-invocation: true;P5+ 需人工拆分正文到 references/。修复后复诊对比前后评分。另有安全扫描:scripts/diagnose.sh <project-path> --security [--json],检测13种模式(密钥、token、密码、硬编码用户路径),可能误报,需逐条复核。
使用方式:先用 scripts/backup.sh <skills-path> 备份;P1-P2 可先运行 scripts/batch-p1p2p3.py <path> --dry-run 预览再应用,随后运行 scripts/batch-p1p2p3.py <path> 覆盖 P3。评分权重含 frontmatter 20%、name 8%、description 10%、Use when... 5%、第三人称 3%、正文长度 15%、目录结构 10% 等。
限制与注意:P5 拆分需理解内容,建议用 Opus 高投入,且逐个交互完成;避免未诊断就编辑、跳过备份、把工作流摘要写进 description、跳过 P3、用 Sonnet 做 P5、修复后不复诊、部署前不做安全扫描。其余价格、平台支持等信息暂未提供。