SuperAPI AI 工具集

create-skill

通用与其它

查看项目

更新于 10-16 03:05

技能介绍

用途:把技能想法整理成一个可发布、可被发现的技能目录,统一处理指令、元数据、美术资产、README 接线与校验。

主要能力:先阅读 AGENTS.md、根 README.md、相近的现有技能和本地经验文件,检查 package.json、skills.sh.json、安装器以及 assets/skill-cards/、assets/skill-banners/ 约定。然后明确契约:从请求中提取 slug、用途、受众、触发短语、输入、输出和验收检查,slug 规范为小写连字符格式,frontmatter 描述需同时说明能力与触发场景。

结构选择:只创建必要资源,包括 skills/<slug>/SKILL.md(核心工作流与路由规则)、skills/<slug>/agents/openai.yaml(展示元数据与显式 $<slug> 默认提示)、references/(按需加载的领域指导)、scripts/(确定性、可重复自动化)、assets/(输出中复用的文件)以及 README.md。SKILL.md 需控制在 500 行以内,深层规范放入一层深的 references 并直接链接。写作使用祈使句,说明决策点、所需工具、文件路径、不变量、失败处理与校验命令,不留 TODO、模板文字或臆测工具名。

美术与接线:每个新技能需要 assets/skill-cards/<slug>.svg,并在根 README 的 Pick a skill 表中新增对应行;若合集使用横幅,还需 assets/skill-banners/<slug>.webp 并在根与技能 README 中使用。需更新所有显式枚举技能的表面,如根 README 卡片表、技能 README、skills.sh.json 分组及注册表或安装器允许列表,不要新建注册表文件。

校验命令示例:python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-creator/scripts/quick_validate.py" skills/<slug>、xmllint --noout assets/skill-cards/<slug>.svg、npm test、git diff --check。若命令不可用,使用仓库文档中的等价命令并报告替换。

限制:资料未提供具体收费、平台支持范围、生成图像工具的可用性与效果保证;若所需工具、依赖、参考或用户选择缺失,需按失败处理流程应对,不得在必需文件未跟踪或校验未通过时宣称完成。