SuperAPI AI 工具集

skill-publish

智能体与模型

查看项目

更新于 10-16 08:05

技能介绍

用途:发布 Claude Code 插件与独立 Agent Skill,规范版本提升、变更日志和 Git 工作流。先按项目结构判断发布类型:存在 .claude-plugin/plugin.json 或 .codex-plugin/plugin.json 为托管插件;只有独立 SKILL.md 且无插件清单为独立 Agent Skill。

托管插件流程:检查当前状态并验证各主机清单,查看自上次版本提升以来的提交;维护必需的 CHANGELOG.md,将变更归入 Unreleased 并同步 README;统一提升每个真实清单的补丁版本(如 0.1.6→0.1.7),除非用户明确要求并说明更大改动;把 Unreleased 转为带日期的发布条目,保留空的 Unreleased 标题并与清单版本一致;发布前校验插件结构,包括清单字段、命令/智能体/技能/钩子目录、SKILL.md 与 YAML 前置元数据、引用文件、市场版本同步、README 清单及生成的主机适配器;随后仅暂存已审阅的路径,提交如 Release vX.X.X,推送默认分支,因推送默认分支即发布;推送后在各主机验证可用,必要时先 marketplace upgrade 再重装,并在全新会话中做冒烟测试,市场反映可能需几分钟;若版本被其他位置引用需一并更新。

独立技能流程:校验 SKILL.md 前置元数据,name 为 1-64 位小写字母数字与连字符且与目录同名,description 为 1-1024 字符,可选 license、compatibility、metadata、allowed-tools;结构含必需的 SKILL.md 及可选的 scripts、references、assets;在 frontmatter metadata 中记录版本与作者;以目录形式分发,方式可为 Git 仓库、zip 压缩包或适用的包注册表。

限制与常见问题:插件未更新时确认推送落在默认分支、清单为合法 JSON 并等待传播;版本已被使用需再次提升补丁号;在活动会话内运行 CLI 需加 CLAUDECODE= 前缀避免嵌套会话错误。其余细节暂未提供。