5. 打包发布技能与同事安装

1. 适用角色

• 企业员工（技能作者与需要安装同事技能的成员）

2. 前置条件

1. 你已完成 3. 登录并安装企业技能中心，本机可正常使用 huyuan-ai-cli，且登录脚本已自动安装 huyuan-ai-skill-installer（互远AI技能仓库安装器）。
2. 你已在 2. 账号注册与加入企业 中获取 员工 API 密钥（hue_sk_...）——首次发布技能到企业库时必需。获取页：https://skills.xds365.com/company/keys。
3. （建议）已安装 huyuan-ai-skill-creator（技能创建器）。若尚未安装，请先按 第 4 篇 §3.2 安装后再进行本地封装。
4. 待发布的技能目录包含 SKILL.md 及规范的 YAML frontmatter（name、description 等）。发布前可由安装器代为执行 validate 预检。

安全提示：员工 API 密钥是企业专属访问凭证，请妥善保管，不要泄露给外部人员，也不要在群聊或代码仓库中明文传播。

3. 什么时候需要打包发布？

当你想把某套工作流程封装成可复用的技能，并分享给公司其他同事使用时，需要完成本地封装与发布。

此外，当技能逻辑、触发描述或关键配置有变更，且需要同事同步到新版本时，也应执行更新发布（见 §9 CLI 备选 中的 --target 说明）。

纯本地实验、仅自己使用的改动，无需发布到企业技能库。

4. 打包技能（本地封装）

在飞书虾 / OpenClaw（龙虾）或 WorkBuddy 的对话环境中操作即可。OpenClaw 入口：https://openclaw.feishu.cn/home

4.1 发起封装

将以下内容发送给 Agent（将 [流程名称] 替换为你的业务场景名称）：

使用技能 huyuan-ai-skill-creator，帮我把 [流程名称] 封装成一个技能

4.2 创建器会引导你完成

• 描述技能用途：这份技能解决什么问题、面向谁。
• 定义触发词：写入 SKILL.md frontmatter 的 description 字段，供 Agent 判断何时自动选用该技能。
• 编写执行逻辑：在 SKILL.md 正文中写明步骤、约束与输出格式。
• 保存为本地技能：默认落在 ~/.agents/skills/<slug>/（Windows 下约为 C:\Users\<你>\.agents\skills\<slug>\）。

4.3 本地验证

封装完成后，在当前会话中试调用 1–2 次，例如：

使用技能 <slug>

确认输出符合预期后再进入发布步骤。

说明：此处的「打包」指本地技能包成型。上传到互远 AI 技能中心时，安装器或 CLI 会在 publish 时自动将目录打成 ZIP 并上传，无需你手动压缩文件。

4.4 可选：技能中心登记文件

若希望技能发布到企业库后自动出现在正确的分类 Tab，并展示已定稿的中文标题，可在技能目录中增加可选登记文件：

{slug}/_huyuan_skillhub_meta.json

该文件须与 SKILL.md 位于同一目录（即 {slug}/ 下），不是 ZIP 根目录。

无 meta 文件时：上传行为与现网一致（tags 为空，展示名取自 SKILL.md 首个 # 标题）。

有 meta 文件时：服务端会严格校验；校验失败将返回 400 及明确错误码（如 HUB_META_INVALID_TAGS），不会静默忽略。

最小示例（将 my-daily-report 替换为你的 slug）：

{
  "schemaVersion": 1,
  "id": "my-daily-report",
  "name": "我的日报助手",
  "tags": ["办公协同", "效率协作"],
  "status": "active",
  "updatedAt": "2026-06-14"
}

• 使用 huyuan-ai-skill-creator 封装技能时，创建器通常会一并生成该文件。
• 打标请优先选用技能中心已有分类标签（如「办公协同」「生活服务」等），避免技能出现在错误 Tab 或仅在「全部」可见。
• 发版上传时，meta 中的 tags 会覆盖你曾在网页上手动修改的标签。

5. 发布技能到互远 AI 技能中心

本地测试确认无误后，通过 huyuan-ai-skill-installer 发布到企业远程技能库。

5.1 发布话术

使用技能 huyuan-ai-skill-installer，帮我把 [技能英文名称/slug] 发布到互远AI技能中心

将 [技能英文名称/slug] 替换为技能目录名或 SKILL.md frontmatter 中的 name（例如 my-daily-report）。

5.2 身份与可见性

设为全公司可见的示例话术：

使用技能 huyuan-ai-skill-installer，把 [slug] 设为公司可见

5.3 发布后作者自检

可用与 第 3 篇 相同的方式查询远程列表，确认新技能 slug 已出现；或请安装器列出「我发布的技能」。

在终端（可选）确认员工身份：

huyuan-ai-cli whoami

6. 同事安装使用

其他同事在自己的飞书虾或 WorkBuddy 中发送：

使用技能 huyuan-ai-skill-installer，帮我安装 [技能英文名称/slug]

也可使用自然语言（Agent 会结合安装器解析），例如：

帮我安装技能 [slug]

6.1 同事侧前提

• 同事已完成 第 3 篇 的企业技能库登录（本机有 huyuan-ai-skill-installer）。
• 你已将技能设为 全公司可见，且企业管理员已为该技能配置好同事可见的授权范围。

6.2 安装后使用

安装与调用细节请参阅 4. 安装并使用技能：

• 安装步骤：§3 安装业务技能
• 调用方式：§4 使用技能

同事安装成功后，可用 使用技能 <slug> 或自然语言描述任务来调用你发布的技能。

7. 结果验证

作者侧

• huyuan-ai-cli whoami 在发布场景下能识别为员工身份（使用 hue_sk_ 登录时）。
• 远程技能列表或「我发布的技能」中包含新 slug。
• 技能可见性为 全公司可见（若目标为团队共享）。

团队侧

• 至少 1 位同事能成功安装该 slug。
• 同事至少完成一次 使用技能 <slug> 调用，并得到符合预期的输出。

8. 常见问题

8.1 发布时提示需要员工密钥

请使用以 hue_sk_ 开头的 员工 API 密钥 重新登录，勿使用企业授权码（huyuan-ai-...）执行发布。密钥获取见 第 2 篇。

8.2 同事在远程列表里看不到我的技能

先确认你是否已将技能设为 全公司可见；再请企业管理员确认该技能是否已授权到同事所在企业或账号。同事也可参阅 第 3 篇 · 安装后列表没有技能。

8.3 发布失败或校验失败

请让安装器先对技能目录执行 validate 预检，重点检查：SKILL.md 是否存在、frontmatter 是否完整、slug 是否与目录名一致。若包含 _huyuan_skillhub_meta.json，还须确认 id 与目录名一致、tags 非空且格式合法。详见 §9。

8.4 如何更新已发布的技能

在本地修改技能后，再次通过安装器发布；包内 name 须与已有 slug 一致。CLI 用户可使用 publish <path> --target <slug>（见 §9）。

8.5 是否每次小改都要发布？

仅当改动会影响他人使用，或需要团队同步新版本时再发布；纯本地调试可只改本地目录，不必上传。

9. CLI 备选（高级）

本机已安装 huyuan-ai-cli 且熟悉终端时，可直接执行以下命令（将占位符替换为实际路径与 slug，勿在命令中粘贴真实密钥到群聊）。

发布流程（员工身份）

huyuan-ai-cli login hue_sk_<员工API密钥>
huyuan-ai-cli huyuan-skill validate ./my-skill
huyuan-ai-cli huyuan-skill publish ./my-skill --dry-run
huyuan-ai-cli huyuan-skill publish ./my-skill
huyuan-ai-cli huyuan-skill visibility set <slug> company

• --dry-run 仅做校验与体积检查，不上传，可按需省略。
• 更新已有技能：huyuan-ai-cli huyuan-skill publish ./my-skill --target <slug>
• 查看本人发布：huyuan-ai-cli huyuan-skill list --scope my（需员工密钥登录）

同事安装（企业身份登录后）

huyuan-ai-cli huyuan-skill install <slug>

若提示身份或权限不符，请先执行 huyuan-ai-cli whoami，并参阅 第 4 篇 §3.4 与 第 3 篇常见问题。

10. 下一步

• 新同事上手：从 1. 快速开始 按顺序完成注册、登录与安装。
• 回顾安装与调用： 4. 安装并使用技能。
• 回顾登录与查看远程列表： 3. 登录并安装企业技能中心。