SuperAPI AI 工具集

skills-repo-maintenance

编程与开发

查看项目

更新于 10-15 19:57

技能介绍

用途:维护技能仓库,使 Codex 与 Claude Code 的产物保持同步,适用于新建技能、为 Codex 打包 .skill 文件,或把技能转换为 Claude Code 插件。

主要能力与流程:默认目标运行时为 Codex 与 Claude Code 两者;打包输出目录必须每次由用户指定,无默认值。先用 git rev-parse --show-toplevel 确定仓库根目录。若用户明确只要一个运行时,跳过另一个前需确认。Codex 侧在仓库根添加含 SKILL.md 的技能文件夹;Claude Code 侧添加含 .claude-plugin/plugin.json 的插件文件夹,并更新 .claude-plugin/marketplace.json。两者都做时,还需为 Codex 分发打包 .skill 文件。

技能内容:技能文件夹必须含带 YAML frontmatter(name、description)的 SKILL.md,技能名用小写加连字符,额外材料可放在 references/、scripts/、assets/ 下。Claude Code 插件位于仓库根,插件内加 .claude-plugin/plugin.json,并在仓库根 .claude-plugin/marketplace.json 添加 name、source、description、version、category、keywords 条目;插件含多个技能时放在 <plugin>/skills/<skill-name>/SKILL.md。

Codex 打包:用 skill packager 打包到用户指定输出目录,Windows 需设 UTF-8 避免解码错误,命令为 $env:PYTHONUTF8=1 与 python "$codexHome\skills.system\skill-creator\scripts\package_skill.py" "<repo-root>\<skill-folder>" $outDir;类 Unix 为 export PYTHONUTF8=1 与 python "$codex_home/skills/.system/skill-creator/scripts/package_skill.py" "<repo-root>/<skill-folder>" "$out_dir",每个受支持技能重复执行。

文档与提交:更新 README.md,在 Available Plugins 与 Usage (Claude Code) 中登记插件,在 Available Codex skills 与 Usage (Codex) 中登记已打包技能;确保 codex-skills/dist/*.skill 被跟踪,推送并按流程开 PR。

限制:Codex 从 .codex/skills 文件夹读取技能,.skill 是用于分发的打包 zip;Claude Code 需要 .claude-plugin/marketplace.json 中的插件条目。