SuperAPI AI 工具集

create-skills

通用与其它

查看项目

更新于 10-15 23:34

技能介绍

create-skills 用于创建 Claude Skill(技能)。技能是让 Claude 稳定完成特定任务的可复用指令集,形态为一个文件夹,内含必需的 SKILL.md 与可选的支持资源;触发时 Claude 读取 SKILL.md 并遵循其中指令。

主要用途:当任务需要在多次对话中保持一致、可重复执行,涉及特定工具、步骤或输出格式,或已手动迭代出有效流程时,可将其固化为技能。若简单提示即可完成、任务为一次性、或行为已内置于 Claude,则不必创建技能。

标准流程为六步:捕获意图、研究与访谈、起草 SKILL.md、用真实提示测试、迭代优化、打包交付。起草前先明确四点:技能让 Claude 做什么、何时触发、期望输出是什么、输出是否可客观验证。若当前对话已有可捕获的工作流,可从历史中提取所用工具、步骤顺序、修正与输入输出格式,再以针对性提问补齐。

技能结构:skill-name/ 下包含 SKILL.md(YAML frontmatter 的 name 与 description,加 Markdown 正文),以及可选的 scripts/、references/、assets/。不要放 README.md、INSTALLATION_GUIDE.md、CHANGELOG.md 等面向人类的文档,技能由 AI 智能体读取。加载采用三级渐进披露:metadata 始终在上下文中(约 100 词),SKILL.md 正文在触发时加载(理想少于 500 行),打包资源按需显式读取。description 是核心触发机制,需写明技能做什么、主要与次要触发场景、相关文件类型,并加排除项防止误触发;要稍微“主动”以对抗欠触发。

正文写作:可用工作流式、任务式、参考/指南式或能力式结构。使用祈使句,解释原因而非仅下命令,避免滥用 MUST/NEVER,加入少样本示例,输出结构重要时给出明确模板。接近 500 行时拆到 references/,并在 SKILL.md 指明何时读取各引用文件;超过 300 行的引用文件顶部加目录。确定性重复操作可写为 scripts/,静态输出素材放入 assets/。

测试与交付:编写 2–3 个真实用户会说的测试提示,检查触发是否正确、是否遵循指令、输出质量与边界情况。可选用 evals/evals.json 做正式评估。定稿后校验结构、检查所有文件引用路径,复制到输出目录,并向用户展示文件与安装说明。若存在 package_skill.py,可执行 scripts/package_skill.py <path/to/skill-folder> 生成 .skill 归档。模板见 templates/skill-template.md。

限制:资料未给出具体平台、收费、价格或效果数据;是否可用某脚本、评估方式与打包工具取决于本地环境,资料未提供进一步细节。