# 龙虾纪元技能包上传标准 v1.0

2026-10-05 · 基于 WorkBuddy 官方格式，增加龙虾纪元完整性与质量层。

官方依据：https://open.workbuddy.cn/docs/skill
本目录保存了当日官方文档快照。WorkBuddy 要求入口使用 YAML frontmatter + Markdown，列明 description、description_zh、description_en、version、author 为必填；name 在其字段表中为可选。references、scripts、templates 为按需资源。其本机打包器生成一层技能目录的 ZIP。本标准不声称已通过 WorkBuddy 在线市场解析／审核。

## 学员只需交一个 ZIP

一个包对应一个技能、一份版本。解压结构建议：

```
my-skill/
├── SKILL.md             必需，官方入口
├── manifest.json        本平台补充：依赖、费用、权限与验证状态
├── LICENSE              原有许可证或明确的使用范围
├── examples/            样例／验证记录；写清真实案例与演示案例
├── references/          按需知识文件
├── scripts/             按需脚本，纯文字技能不强制代码
└── templates/           按需模板
```

SKILL.md 放 ZIP 根或一层技能目录内均可被本平台校验器识别；平台打包工具输出一层技能目录，与本机 WorkBuddy 打包器一致。不要再套 outputs/project/v1 等多层外壳，不提交多个技能混在一个安装 ZIP 中。批量合集需要先解压，再逐个上传其中的独立 ZIP。

## 元数据

```yaml
---
name: my-skill
display_name: 我的技能名称
description: Describe the actual capability and when to use it.
description_zh: 写清具体用途与触发场景。
description_en: Describe the actual capability and trigger.
version: 1.0.0
author: 原作者或获准的发布者
---
```

官方必填字段全部保留。为便于唯一身份与版本管理，本平台额外要求 name 为小写字母／数字／连字符，最长 64 字符；目录名与 name 相同，version 使用语义版本。作者不能在重新包装时被改成舒舒；改编要保留来源和原有 LICENSE。适用时可保留官方可选字段 allowed-tools、disable-model-invocation、user-invocable。

## 正文要让另一只 Agent 能用

写清：什么时候用、用户提供什么、执行步骤、输出什么、如何判断做好、缺资料或工具失败怎么办。必要文件实际随包提供，资源以相对路径引用。不能依赖作者电脑路径或“我本地已经有了”的未交付文件。

CLI、MCP、代码不是强制要求；纯文字技能也成立。必须有可执行步骤与可判断输出。一句话观点、学习日志、短摘要可以发布为学习内容，不能作为可安装技能商品。

manifest.json 需要 name、version、dependencies、permissions、costs、license、validation。声明是否需自备 Key／工具、是否联网、是否修改数据、外部服务费用是否另计；不把模型费藏在下载价后面。validation 里的质量状态不能由作者自报为平台审核通过。

## 上传前检查

```bash
python3 tools/validate_skill_package.py my-skill-1.0.0.zip
```

交付工具已附 PyYAML 纯 Python 依赖与原许可证，Python 3 环境可以直接运行；单独拷走校验器时需同时携带 tools/_vendor，或自行安装 PyYAML。

从文件夹生成发行包：

```bash
python3 tools/package_skill.py ./my-skill --out-dir ./dist
```

通过才生成正式命名 ZIP；失败给出具体文件与原因。相同版本不覆盖，应修订版本后重新发布。脚本只解析结构和文本，不运行投稿包的脚本。

本平台首期上限：压缩包 25 MiB、解压总量 100 MiB、单文件 20 MiB、最多 500 项；这些是平台限制，不是 WorkBuddy 官方公布的限制。需要大型资产的作者用单独授权资源或提出扩容。

校验拒绝：损坏包、多入口／多层外壳、目录穿越、链接／特殊文件、重复或大小写碰撞路径、加密 ZIP、缓存／备份／.env、缺元数据、缺被引用资源、凭据形态或私人机器路径。凭据扫描只是初筛，不能代替人工审阅和隔离；其结果只显示文件名，不回显疑似凭据。

## 标准通过后，仍有质量审核

区分三个状态：

1. **包结构通过**：可解析、文件齐、入口完整；可以作为待授权发行的候选包。
2. **执行已验证**：在注明环境下做过指定任务，例如 PPT 导出；记录实际验证范围。
3. **精选效果通过**：完整任务产出经独立复现与质量验收，才进入星光／付费解锁。

不能把第 1 层徽章写成“认证精品”。离线合成 PPT 成功不证明 AI 生成的字、脸、设计都好；提示词脚本成功不证明实际视频连续性已成立。

## 官网接入方式

未来真正的技能发布入口只接受 ZIP：选择包 → 展示解析出的名称、作者、版本、依赖、费用和错误 → 作者确认权利及公开范围 → 提交待审核。旧经验发布入口继续收笔记，内容类型显示“经验／教程”，不自动生成可售技能记录。

正式服务端必须运行同一标准检查，不能只靠前端检查。未审核包存放在非 public 隔离目录，不自动执行脚本，不直接开放下载；只有审核通过的不可变版本才得到下载地址。新增版本不覆盖旧文件。package 检查结果可供审阅，但上架与付费状态只由平台角色写入。

官网投稿入口：/university/skills/submit，完整规则：/university/rules。提交成功仅进入本人私有待审记录，不自动发行或扣星光。经验区 /university 继续保留公开文章；旧 category=skill 是经验分类兼容参数，不是技能认证标志。发行目录、验证状态、下载权限与价格由平台分别管理。


## 星光发行规则 v2.0

所有技能包统一30星光，发布账号获得70%（21星光），平台9星光。上传时须具备本人作品收费分发授权，原作者、来源和第三方许可均保留；审核通过才开放下载，待授权包不收费。7日退款期内收益待结算，到期在个人中心自动结算入余额；退款取消该笔收益。同版本不可覆盖，新版本重新审核。方法与执行效果分别标注，不得把结构检查宣称效果认证。


## Agent试跑与退款规则 v2.1

所有技能包统一30星光，发布者70%即21星光、平台9星光，7日退款期内待结算。下载后由学员自己的Agent在已授权环境中用最小匿名样例试跑一次，提交清晰度、完整度、可复现性、实用性各1至5分，服务端按四项总和乘5得到100分制评分。每账号每版本只有最新一票；作者自己的评价不计入公开均分，已退款的负面评分仍保留。试跑评分是学员Agent提报，不是平台独立效果认证。受阻状态不评分。退款必须引用本人同版本Agent报告及其中明确的退款说明，写明预期、实际差异与影响；缺工具、下载失败、安全受阻可以如实报告，不强迫执行。7日内全额返还30星光，撤销权益并取消21星光待结算。报告和退款说明仅本人查看；公开仅汇总分数、人数与通过数，不公开任务、客户内容、日志或凭据。
投稿仍先审阅，客户端和网站不自动运行上传代码。