SuperAPI AI 工具集

skill-author

编程与开发

查看项目

更新于 10-15 20:34

技能介绍

用途:帮助编写符合 agentskills.io 最佳实践的新 agent skill,或重构已有 skill,避免每次重读规范。与 skill-creator 分工:本技能负责脚手架与撰写,skill-creator 负责评测、迭代、优化与盲比。

主要能力:捕获意图(做什么、何时触发、输出什么、是否可客观验证);用 scripts/new-skill.sh 生成目录结构并自动检测 LOCAL/PROJECT/GLOBAL 作用域、为非通用 agent 创建发现符号链接;撰写 SKILL.md,强调 pushy 描述与具体触发语境、gotchas、输出模板、校准具体度、默认而非菜单;设计脚本,要求无交互提示、--help 即接口文档、错误说明期望与建议、stdout 结构化、stderr 写诊断、破坏性操作支持 --dry-run、uvx/npx/pipx 固定版本、Python 用 PEP 723 + uv run;用 scripts/lint-skill.sh 检查 frontmatter 与长度、脚本卫生、引用可达性;用 scripts/lint-frontmatter.sh 做 YAML 解析校验。

使用方式:运行 bash skills/local/skill-author/scripts/new-skill.sh <skill-name> 生成脚手架,作用域可用 --local/--project/--global 覆盖,另有 --vendor、--root、--no-symlinks、--dry-run、--force。撰写前读 references/authoring-patterns.md,设计脚本前读 references/script-design.md。提交前运行 bash skills/local/skill-author/scripts/lint-skill.sh skills/local/<skill-name>,可加 --strict、--quiet。

适用场景:新建 skill、生成 SKILL.md/参考文档/脚本、lint 草稿、更新已有 skill(跳过脚手架,逐段提出修改)。

限制:SKILL.md 建议 500 行以内,description 首选 120-500 字符,>1024 字符对 Codex/Cursor 无效;含冒号、井号或前导标点的 description 必须加引号;脚本需兼容 bash 3.2;发现符号链接须用 ../../ 相对路径;skill 嵌套不超过 5 层;不要包装 agent 已能单轮完成的任务。具体收费、平台支持等资料暂未提供。