SuperAPI AI 工具集

create-skill

智能体与模型

查看项目

更新于 10-15 17:19

技能介绍

用途:创建一个新的 Muse 技能(Skill)。仅用于用户明确提出创建 Muse 技能的请求,不用于普通技能调用、代码修改、基准任务或第三方技能/插件系统。

两种作用域:项目级(默认)位于当前工作区 .agents/skills/<skill-id>/;个人级(用户明确要求 personal、user 或跨项目技能时)先在 .agents/skill-drafts/<skill-id>/ 暂存并校验草稿,再交给用户执行 muse skills install .agents/skill-drafts/<skill-id>,由技能库完成受管安装(文件与来源记录),使 skills update 与 skills uninstall 继续可用。

创建内容:只创建一个目录和一个必需文件 SKILL.md。除非用户明确要求且目标仍在新建技能目录内,不添加脚本、资源、引用或额外文件。不创建或安装插件、不启用技能、不信任插件、不执行生成的技能、不抓取远程内容、不在当前工作区之外写入。不得写入 ~/.codex/skills、~/.claude/skills、$HOME/.agents/skills 等外来根目录,也不得直接写入 $CONFIG_DIR/skills。

写入前需确定:作用域、skill-id(小写可移植标识符)、一句话描述、正文内容;信息不足时先提出简短澄清问题。

安全校验:目标必须位于当前工作区 .agents/skills/(项目)或 .agents/skill-drafts/(个人暂存);ID 不得为空、.、..,不得含 / 或 \,不得以 - 开头,只能含小写字母、数字、连字符、下划线,且不得为 Windows 保留名(如 con、prn、aux、nul、com1、lpt1 等);目标已存在、为符号链接或父级解析到工作区外时拒绝。

创建步骤:确认目录不存在;必要时创建父目录;以不可覆盖方式保留叶目录,若竞争失败则停止并报告未完成;复查保留目录解析在工作区内且非符号链接;写入 SKILL.md;运行 muse skills validate <dir> --json,仅当校验成功、valid: true 且无诊断或警告时视为完成;失败则在同一草稿上修正并重试,三轮后停止并报告未完成。

SKILL.md 结构:frontmatter 含 name(skill-id)与 description(一句话),正文用 # 可读技能名加使用时机与方式说明,保持直接、自包含。

完成报告:给出创建目录的规范路径、校验命令与干净结果,说明未执行安装、启用、信任或执行步骤;个人作用域还需给出由用户执行的安装命令 muse skills install .agents/skill-drafts/<skill-id>,并说明安装成功后可删除暂存目录。失败时报告失败操作、已保留的目标、剩余诊断或工具错误及未完成的检查。