把现有 Claude skill 整理成 BigApple 可发布的项目 skill。用于校验 skill 目录、复制到当前工作区 .claude/skills、补齐 bigapple.json,并引导用户在 BigApple UI 里完成发布和验收。
只处理这条链路:
现有 Claude skill
-> 当前工作区 .claude/skills/<skill-name>/
-> bigapple.json 补齐展示字段
-> 引导用户在 BigApple UI 里点“发布”
先确认用户要发布哪个 skill。
输入至少要明确到下面二选一之一:
不明确就先问,不要猜。
继续之前先确认:
SKILL.md 或 skill.md不满足时直接停,并清楚告诉用户缺什么。
优先使用:
scripts/prepare-bigapple-skill.sh
默认行为:
pwd/.claude/skills/<market-safe-name>/namebigapple.json默认不要覆盖同名目标目录。只有用户明确说要覆盖时,才用:
BIGAPPLE_SKILL_FORCE_OVERWRITE=1
这个 skill 负责补:
presentation.displayNamepresentation.intropresentation.examplespresentation.tagspublish.skillId不要替用户填写这些发布归属字段:
organization.companiesorganization.departments这些让用户在 BigApple 发布弹窗里自己填。
在运行脚本前,先根据源 skill 的 SKILL.md 准备好这四个值,再传给脚本:
displayName:4 到 12 个字,直接说明用途intro:1 到 3 句中文,说人话tags:3 到 6 个搜索词examples:2 到 4 条用户真的会说的话,不要带 @技能名不要编造源 skill 没写过的能力。
最常用:
BIGAPPLE_SKILL_DISPLAY_NAME="技能上架助手" \
BIGAPPLE_SKILL_INTRO="把现有 Claude skill 整理成 BigApple 可发布的项目 skill,并引导完成上架验证。" \
BIGAPPLE_SKILL_TAGS="BigApple,skill,上架,市场" \
BIGAPPLE_SKILL_EXAMPLES=$'把这个 Claude skill 变成 BigApple skill\n帮我整理这个 skill 然后去发布' \
bash scripts/prepare-bigapple-skill.sh <source_skill_dir>
如果想指定目标目录名:
bash scripts/prepare-bigapple-skill.sh <source_skill_dir> <target_skill_name>
脚本跑完后,至少确认:
pwd/.claude/skills/<name>/SKILL.md 或 skill.mdbigapple.jsonbigapple.json 的展示字段不是空壳文件准备好之后,不要替用户点发布。
只引导用户自己走这条链路:
如果用户说没看到 skill badge,先让他确认当前打开的是同一个工作区,再检查目标目录有没有放进 pwd/.claude/skills/
用户确认已经在“数字员工(skills)”里搜到这个 skill 后,再问一句:
原来的 Claude skill 还要保留吗?
如果用户说不要了,只告诉他原路径,让他自己删除。
不要替用户删除原 skill。