Skill 开发自检 · 上架不被打回
写 Skill 不难,难的是传上去。
上传被拒、传上去搜不到、跑起来报错、审核打回——这些不是能力问题,是规则问题。
这个技能把踩过的 17 个坑,做成一次可执行的静态检查。
它能查出什么
一、包结构(传不上去的四大元凶)
- 包里有二进制文件 —— 平台只收文本,混入一张 PNG 整个版本都传不上去
- zip 路径是反斜杠 —— 用系统右键"压缩到 zip"必踩,平台只认正斜杠
- 根目录套了外壳文件夹 —— 你的skill/SKILL.md 会被判路径不安全
- 包内文本总量超线 —— 把古籍、知识库、模型文件塞进包,页面显示的 token 消耗会指数级爆炸
二、SKILL.md 内容
- frontmatter 是否完整(少了技能名和简介全空)
- 牌头字数是否超线(列表页会截断,卖点看不见)
- 公开正文有没有把内部指令写进去(管理命令、凭据、内部字段会被原样渲染到公开页面)
- 要不要声明付费链路——含付费的能力,支付五要素必须写在 SKILL.md,写在别处不算
三、两条过审红线(被拒过的人最懂)
- 包内脚本存在文件写入行为 —— 离线技能跑在用户沙盒里,写盘会被判风险
- 提示词里出现导流广告 —— 引导升级、指向另一个产品,会被判推广
四、AI 执行手册体积
- 沙盒读文件的响应有 4095 字节上限,超了直接报错
- 手册超线会让 AI 丢掉尾部的铁律和交付要求,还给用户留一条红色报错
怎么用
把下面任意一种丢给对话就行:
- 你的 Skill 目录路径
- 你打好的 zip 包路径
会输出 PASS / WARN / FAIL 逐项结论,每条 FAIL 都附上修复方向。
全绿再上传。
检查项从哪来
17 个坑全部来自真实上架过程:含平台返回的报错原文、实测对照数据、以及两轮安全拒审的复盘。
覆盖范围包括包结构、内容合规、审核红线、运行稳定性四个层面。
很多条目平台文档里没有,是撞出来的。
说明
本工具为静态检查,帮你在上传前发现问题,不构成上架保证。
平台规则会变,检查项以最新实测为准。