用途:按最佳实践创建(scaffold)新的 agent skill,以及审查(review)、升级(upgrade)、诊断(diagnose)已有 skill。输出为完整 skill 目录,外加 agent-skills.git 的 symlink 接线与清单更新。
主要能力与工作流:
- scaffold(默认):七阶段流水线——需求访谈、单文件/多文件结构决策、frontmatter 草稿、文件生成、接线与清单、自检、评估。每阶段设关卡。
- review:只读,不写文件。运行机械预检并逐项判定,最后给出按优先级排列的 Top 3 修复建议。
- upgrade:把单文件 skill 拆为多文件,先提出布局树供用户确认,再迁移各关注点并留一行指针。
- diagnose:分析 skill 执行不满意的会话,定位应由哪个关卡捕获,输出带置信度门控的统一 diff,仅在 confidence ≥ 90% 时应用。不修改用户产品代码,只改目标自身源码。
使用方式:通过 /create-skill 调用,模式依据 $ARGUMENTS 首词自动检测;诊断用法为 /create-skill diagnose <target> [--symptom "..."] [--scope <phase|companion>] [--apply] [--pr] [--no-write]。仓库本地开发默认走两层 symlink 链,需从仓库根运行 bash scripts/sync-symlinks.sh,不可手写 ln -s,也不可用 sh 调用。自检运行 node ${CLAUDE_SKILL_DIR}/scripts/validate-skill.mjs <dir> [--portable]。
适用场景:为 Claude Code 或可移植(portable,仅六个 spec 字段)运行时编写 skill;审计现有 skill 的 frontmatter、渐进式披露与 token 结构;把大文件 skill 拆分为可隔离加载的规则/示例/模板;加固某个 skill 以防范特定失败类别。
限制:规则、示例与模板按需加载,不预先全量读取;SKILL.md 正文不超过 500 行;文件名使用 kebab-case、不超过 64 字符且不得含保留词 anthropic、claude;可移植配置不得使用 Claude Code 专有字段。本文档未提供具体收费、价格或平台支持信息。