| name | metabot-post-skill |
| description | 将本地技能（SKILL.md + 文件）以 metabot-skill 协议打包发布到链上的技能。当用户说"发布技能"、"上传技能"、"分享技能到社区"、"把这个技能发到链上"时调用此技能。 |
| official | true |
MetaBot Post Skill
将本地技能目录打包为 ZIP 上传至 MetaWeb /file，再以 metabot-skill 协议（/protocols/metabot-skill）发布到链上，供社区技能市场展示与其他用户下载安装。
何时调用
当用户表达以下意图时调用：
- "发布一个技能""把这个技能上传到链上""分享技能到社区"
- "让大家也能下载我这个技能"
- 能推断出用户想将某个本地技能目录或 ZIP 发布为社区技能
对话发布流程
按以下步骤引导用户完成发布：
1. 收集技能来源
询问用户：「请提供你的技能目录路径，或一个已打包的 ZIP 文件。」
收到路径后检测：
-
如果是目录：检查根目录下是否有 SKILL.md。若没有，提示用户「该目录下没有 SKILL.md，可能不是合法的技能包，是否继续？」。
然后询问用户是否需要压缩：「是否帮你把该目录压缩为 ZIP？」若用户确认，执行：
cd "$(dirname "<skill-dir>")" && zip -r "/tmp/metabot-skill-<name>.zip" "$(basename "<skill-dir>")" -x "*.DS_Store" "__MACOSX/*"
建议输出路径 /tmp/metabot-skill-<name>.zip。
-
如果是 ZIP 文件：检查文件大小。读取文件大小：
stat -f%z "<zip-path>" 2>/dev/null || wc -c < "<zip-path>" | tr -d ' '
若超过 4MB（4194304 byte），提示「技能包过大（X MB），请精简至 4MB 以内后重试。」并停止。
-
如果是其他格式或不存在的路径：提示用户当前路径无效，请提供技能目录或 ZIP 文件路径。
2. 从技能文件中读取建议值
读取技能目录下的 SKILL.md frontmatter 或 ZIP 内的 SKILL.md（若方便），提取 name、description、version 作为后续建议值。如果读不到就用目录名作为 name 的建议值。
3. 收集元数据
一次性询问用户以下字段，同时给出建议值：
| 字段 | 必填 | 建议值 |
|---|
| name | 是 | 从 SKILL.md frontmatter 的 name 字段，或目录名 |
| description | 否 | 从 SKILL.md frontmatter 的 description 字段 |
| version | 是 | 从 SKILL.md frontmatter 的 version 字段，或 1.0.0 |
呈现方式示例：「根据你的技能文件，建议：name: xxx, description: xxx, version: 1.0.1。请确认或修改后告诉我。」
4. 组装并确认
将 metadata 组装为 /protocols/metabot-skill 的 JSON 展示给用户确认：
{
"name": "metabot-example",
"description": "一个示例技能",
"version": "1.0.0",
"skill-file": "metafile://<zip-pinid>"
}
同时告知用户即将执行的操作：「我将帮你上传 ZIP 并发布到链上，确认吗？」
5. 执行发布
用户确认后，调用脚本。二合一模式（推荐）：上传 + 发布一起做
node "$SKILLS_ROOT/metabot-post-skill/scripts/index.js" \
--request-file /tmp/metabot-post-skill-request.json
Request 文件格式（/tmp/metabot-post-skill-request.json）：
{
"name": "metabot-example",
"description": "一个示例技能",
"version": "1.0.0",
"zip": "/tmp/metabot-skill-example.zip"
}
脚本会自动：先上传 ZIP 到 /file → 获得 metafile://<pinId> → 再发布 /protocols/metabot-skill pin。
分步模式（当 ZIP 已提前上传时）：
node "$SKILLS_ROOT/metabot-post-skill/scripts/index.js" \
--payload '{"name":"metabot-example","description":"示例技能","version":"1.0.0","skillFileUri":"metafile://<pinid>"}'
命令语法
node "$SKILLS_ROOT/metabot-post-skill/scripts/index.js" \
--request-file <request.json>
node "$SKILLS_ROOT/metabot-post-skill/scripts/index.js" \
--payload '<JSON>' --zip <zip-path>
node "$SKILLS_ROOT/metabot-post-skill/scripts/index.js" \
--payload '<JSON>'
Payload 字段说明
与 /protocols/metabot-skill 协议一致：
| 字段 | 必填 | 说明 |
|---|
| name | 是 | 技能标识 |
| description | 否 | 简短描述 |
| version | 是 | 语义版本号，如 1.0.0 |
| skill-file | 是 | metafile://<pinid> URI，指向已上传的 ZIP；若通过 --zip 或 request 的 zip 字段提供本地路径，脚本会自动上传并填充 |
| zip (仅 request) | 否 | 本地 ZIP 文件路径，脚本会先上传该文件再发布 |
Request 文件完整格式
{
"name": "metabot-example",
"description": "一个示例技能",
"version": "1.0.0",
"zip": "/tmp/metabot-skill-example.zip"
}
ZIP 已提前上传时可不传 zip，改为在 payload 中包含 skillFileUri 或 skill-file：
{
"name": "metabot-example",
"description": "一个示例技能",
"version": "1.0.0",
"skillFileUri": "metafile://<pinid>"
}
成功输出
成功时 stdout 输出一行 JSON：
{
"success": true,
"pinId": "<pinId>",
"txid": "<txid>",
"skillFileUri": "metafile://<zip-pinid>",
"totalCost": 1234
}
退出码 0 表示成功。
AI 行为约束
- 4MB 限制：上传前必须检查 ZIP 大小，超过 4MB（4194304 byte）立即停止并提示用户。
- 目录校验：用户给的是目录时，检查根目录有没有
SKILL.md。没有就提醒用户可能不是合法技能包。
- 一次性收集：不要一个一个字段问，同时给出 name/description/version 的建议值，让用户一次确认。
- 提前确认：在实际调用脚本之前，将组装的 payload 展示给用户确认。用户确认后再执行。
- 脚本路径：始终使用
$SKILLS_ROOT/metabot-post-skill/scripts/index.js。
- 身份自动处理：底层 RPC 通过
IDBOTS_METABOT_ID 环境变量自动获取当前 MetaBot 身份，无需询问用户选择发布者。
- 结果判定：退出码 0 即成功；优先使用本技能输出，不要绕开技能另写临时脚本。
- JSON 转义：传入
--payload 的 JSON 字符串若含双引号等特殊字符需正确转义；推荐通过 --request-file 传参避免转义问题。
