SuperAPI AI 工具集

skill-authoring-taudelta

通用与其它

查看项目

更新于 10-16 08:08

技能介绍

用途:编写新的 Agent Skill、修改现有 SKILL.md,或让技能改动真正部署生效。

主要能力:说明 Skill 的基本格式——根目录 SKILL.md,含 YAML frontmatter 与 Markdown 指令,references/ 放按需读取内容,scripts/ 放可执行脚本。frontmatter 仅规范六键:name、description、license、compatibility(最多 500 字符环境要求)、metadata(字符串映射)、实验性 allowed-tools。随附 scripts/names.py 检查名称冲突:check、audit --mine、audit --offline,用退出码 0/1/3 区分正常、冲突、无法判定。

使用方式:编辑技能须先找到源仓库,切勿直接改已安装副本。在拥有该仓库的会话中做小幅度增量修改,运行仓库质量门禁,提交并推送,再重新安装: npx skills add <owner>/<repo> --global --skill <name> npx skills add <owner>/<repo> --global 随后用 skills ls -g --json 验证,并用 diff -r 对比安装副本与检出;需要时重新加载(如 Claude Code 的 /reload-skills)。重命名或删除后需运行 skills remove -g --skill <old-name> -y。迭代时可安装本地路径。

适用场景:编写或维护 Agent Skill、把改动发布到远端供安装、排查安装后未生效的问题。

限制:Claude Code 读取 .claude/skills 而非 .agents/skills,符号链接缺失会导致安装看似成功但实际不可用;未使用 --global 时安装范围随当前目录静默变化并可能写入 skills-lock.json;名称是主键,重名会被静默丢弃,重命名在锁文件中表现为删除;重命名并移动技能目录外部状态时存在时间窗口,需按 push → install → move state 顺序操作。部分细节(如具体价格、平台支持清单)暂未提供。