Skill 创建与发布
从上传到上线：草稿 → 提交审核 → 检测 → 发布。摘自平台官方指南 /site/create-publish。
ARK Hub返回官网指南 · Skill 创建与发布Skill 如何创建和发布从上传到上线，Skill 经「草稿 → 提交审核 → 检测 → 发布」全流程。名称、描述、触发词自动解析，按角色与业务线门禁提交与发布。上传 Upload上传文件：支持 .skill / .zip / .md，后端解压并解析成目录树。自动读取：名称、描述直接从 SKILL.md 的 frontmatter 读取，无需手填。LLM 提取：触发词、使用示例（卖点 / 特性）由 Claude 解析 SKILL.md 自动生成。仅需配置：所属分类（BU）、是否开放下载 isOpen 等少量项。版本管理：保存即生成版本快照，version 由后端自增（v1.0 / v1.2…）。新建为草稿态（解析中状态 parsing 不阻塞使用）；带 assetId 保存为部分更新，保留未传字段。审核与门禁（authz.ts · cap）提交：非 viewer 且具备该业务线管理权方可提交（canSubmitLine）。发布 / 下架：admin 全线；manager 仅限自己管理的业务线/子分类（canPublish / canUnpublish，status 1↔0）。草稿可见性：仅 admin 与该业务线 manager 可见（canSeeDraft）。下载：对所有人开放（canDownload 恒为 true）。按业务线授权草稿隔离发布仅 admin角色与权限（viewer / manager / admin）角色来自外部 UA 接口的 roleCode，经 resolveAuthz 归一化；admin 视为管理全部业务线，manager 仅管理被授权的业务线（managedLines）。viewer默认浏览已发布技能查看检测报告下载技能包使用manager业务线管理管理被授权的 BU提交本线技能审核可见本线草稿admin平台管理管理全部业务线发布 / 下架可见全部草稿生命周期状态（EntryLifecycle · status 0/1）草稿 draftstatus=0 · 仅本线可见提交审核manager 提交本线已发布 publishedstatus=1 · admin 发布下架admin 回退 status=0提交后进入两阶段检测，检测通过且 admin 发布方可上线；发布与下架仅切换 status（1=发布 / 0=下架），全程保留版本快照便于回溯。检测门禁（两阶段串行）提交后先跑静态检查（文件 · 格式 · 字段），通过才进入动态检查（隔离 Mock 环境 · 脱敏门槛 · 质量评分），任一阶段命中即拒绝上线。提交 Skill静态检查8 项规则动态检查安全 · 质量评分允许上线检测标准与评分细节见白皮书ARK Hub
Agent 对接 Skill
以 claude-crm 为例的同步与埋点机制。摘自平台官方指南 /site/agent-integration。
ARK Hub返回官网指南 · Agent 对接Agent 如何对接 Skill以 claude-crm 为例：后端本地维护一份 Hub Skill 副本，会话启动时软链到工作区供 Agent 直接加载；轮询对账（兜底）+ MQ 订阅（实时）双通道同步。同步现状：本地 Skill 副本 + 软链Skill 压缩包解压落盘到 _skill_hub/skills/<skill_key>，会话启动时按需软链到该会话工作区的 .claude/skills/<skill_key> 供 Agent 直接加载使用。_skill_hub/skills落盘技能本体软链 symlink指向技能目录.claude/skills各会话工作区Agent 调用每个 Skill 以 content_hash（压缩包 sha256）标识版本，配合后端自增 version；落盘采用「临时目录 → 原子替换」，软链指向路径不变，副本更新后会话无需重建链即时生效。status 为 active / parsing / deleted。方式一 · 轮询对账（Pull · 兜底）定时调用 ARK Hub 的「版本清单接口」，拿到全部已发布 Skill 的版本指纹，与本地逐条 diff 后增量更新。拉取清单：[{ skill_key, version, content_hash, status }]与本地逐条比对 content_hash命中差异 → 进入统一落盘流程缺失 → 新增hash 变化 → 更新下架 → 禁用一致 → 跳过方式二 · MQ 订阅（Push · 实时）ARK Hub 在发布 / 更新 / 下架时投递事件到消息队列，Agent 侧订阅消费，第一时间同步。事件体：{ event, skill_key, content_hash, oss_url }event：published / updated / unpublished / deleted按事件类型 → 进入统一落盘流程或禁用实时推送按 hash 幂等去重失败重试 / 死信统一落盘流程（两通道共用）① 下载按 oss_url 取包② 校验sha256 + 含 SKILL.md③ 原子替换临时目录 → replace④ 更新记录hash / version / status⑤ 软链生效MQ 通道为后续规划，先行可仅启用轮询对账保证一致性；接入 MQ 后形成「MQ 实时 + 轮询兜底」的最终一致同步。两通道均以 content_hash 为幂等键，重复消息不重复下载。埋点调用埋点：Skill 调用完成后上报Agent 每次实际调用 Skill 后，上报一次调用记录。平台用 assetId 定位 Hub 资产，用 skillId 标识本地 Skill，用 channel 区分接入来源，后续用于首页累计调用、热门排序与运营分析。assetId=Hub 资产 IDskillId=本地 Skill 标识channel=调用渠道curl --location 'http://127.0.0.1:8090/api/v1/assets/invoke/report?assetId=92' \
--header 'Content-Type: application/json' \
--data '{
"skillId": "client-weekly-report",
"channel": "claude-crm",
"agentId": "crm-rm-copilot",
"scene": "client_weekly_summary",
"success": true,
"durationMs": 1840
}'建议在 Skill 执行结束后统一上报，成功与失败都记录；失败场景可将 success 置为 false，并补充错误类型，避免只统计成功调用导致热度失真。ARK Hub