skill-store

name	skill-store
description	技能商店全链路：浏览云端技能、查看详情、安装到本地、上传发布、认证审核、AI 生成优化。当需要从技能商店搜索安装技能或管理云端技能资产时使用此技能。
tools	search_skills, lookup_skill
metadata	{"category":"operations","emoji":"🏪","tree_id":"skills/search_skills","tree_group":"skills","min_tier":"question","intent_priority":15,"intent_keywords":{"zh":["技能商店","安装技能","搜索技能","发布技能","上传技能","技能认证","技能管理","云端技能","技能市场","下载技能"],"en":["skill store","install skill","search skills","publish skill","upload skill","skill marketplace"]},"scene_hint":"云端商店浏览/安装/上传技能用此→管理本地已装包用packages-management→创建/编辑技能用skill-creator"}

技能商店技能

适用场景

用户需要从云端技能商店浏览、安装、上传或管理技能时触发。

选择原则

场景	工具/技能
从云端商店浏览/安装技能	本技能
管理本地已安装包	→ packages-management
创建/编辑技能定义文件	→ skill-creator（元技能）
管理本地技能文件	→ skill-creator

前置条件

技能商店功能需要 OAuth 认证。如果用户未登录：

gateway(action="models.auth.state")

检查 enabled 和 isAuthenticated。未认证时引导用户先登录：

gateway(action="models.auth.login.full")

一、浏览技能商店

1.1 分页浏览（推荐）

gateway(action="cloud.skills.browse", page=1, pageSize=20, category="<category>", keyword="<keyword>", tag="<tag>")

参数（均可选）：

• page: 页码，默认 1
• pageSize: 每页数量，默认 20
• category: 按分类过滤
• keyword: 搜索关键词
• tag: 按标签过滤

返回：

• items[]: 技能列表，含 id, name, description, category, author, version, downloadCount, certificationStatus
• total: 总数
• page, pageSize: 分页信息

1.2 统计概览

gateway(action="cloud.skills.summary")

返回：

• summary.installed: 已安装数
• summary.created: 用户创建数
• summary.total: 总数
• summary.storeAvailable: 商店可用数

二、安装技能

2.1 云端安装（服务端租户级）

gateway(action="cloud.skills.install", skillId="<skill-id>")

将技能安装到当前用户的云端租户空间。返回安装后的技能详情。

2.2 本地下载安装

先通过包管理下载 ZIP 并解压到本地：

gateway(action="packages.install", id="<skill-id>", kind="skill")

2.3 CLI 安装

crabclaw skills add <skill-name-or-url>

2.4 安装工作流

1. cloud.skills.browse(keyword="目标") → 找到目标技能
2. 确认技能详情和认证状态
3. cloud.skills.install(skillId="...") → 云端安装
   或 packages.install(id="...", kind="skill") → 本地安装
4. skills.status → 确认生效

三、查看技能详情

3.1 通过 RPC

gateway(action="cloud.skills.browse", keyword="<skill-name>")

从返回的 items 中选择目标，查看完整信息（含 readme, inputSchema, outputSchema, tags）。

3.2 通过 CLI

crabclaw skills info <skill-name>
crabclaw skills list --eligible --verbose

四、上传技能

将本地技能打包为 ZIP 上传到云端商店：

gateway(action="cloud.skills.upload", zipData="<base64-encoded-zip>", scope="TENANT", intent="<intent>")

参数：

• zipData: base64 编码的 ZIP 数据（包含 SKILL.md + 相关文件）
• scope: "TENANT"（租户级）
• intent: "PERSONAL"（仅自己用）或 "PUBLIC_INTENT"（走认证后公开）

返回：

• skill: 上传后的技能详情，含 id, name, status

上传工作流

1. 确认本地技能目录结构正确（SKILL.md 必需）
2. 打包为 ZIP
3. cloud.skills.upload(zipData=base64(zip), intent="PERSONAL")
4. 如需公开 → cloud.skills.certify(skillId="...")

五、技能认证

5.1 触发认证

gateway(action="cloud.skills.certify", skillId="<skill-id>")

异步操作。认证管线会自动进行安全评分和质量检查。

5.2 查询认证状态

gateway(action="cloud.skills.certification.status", skillId="<skill-id>")

返回：

• certification.certificationStatus: NONE / UNCERTIFIED / TESTING / CERTIFIED / FAILED
• certification.securityLevel: 安全等级
• certification.securityScore: 安全评分
• certification.report: 认证报告（如有）

认证工作流

1. cloud.skills.upload(intent="PUBLIC_INTENT") → 上传
2. cloud.skills.certify(skillId="...") → 触发认证
3. 等待异步完成
4. cloud.skills.certification.status(skillId="...") → 查看结果
5. CERTIFIED → 技能在商店公开可见

六、AI 技能生成

6.1 生成新技能定义

gateway(action="cloud.skills.generate", purpose="<自然语言描述>", category="<category>", language="<language>")

参数：

• purpose（必填）: 技能用途自然语言描述
• category（可选）: 目标分类
• language（可选）: 生成语言
• inputHints（可选）: 输入格式提示
• outputHints（可选）: 输出格式提示
• examples（可选）: 示例列表

返回：

• skill.skillName, skill.skillKey: 生成的名称和键
• skill.description: 技能描述
• skill.skillMd: 生成的 SKILL.md 内容
• skill.inputSchema, skill.outputSchema: 输入输出模式
• skill.testCases: 测试用例

6.2 优化现有技能

gateway(action="cloud.skills.optimize", skillName="<name>", description="<desc>", aspects=["performance", "security"])

参数：

• skillName（必填）: 技能名称
• description（可选）: 当前描述
• inputSchema（可选）: 当前输入模式
• outputSchema（可选）: 当前输出模式
• readme（可选）: 当前 README
• aspects（可选）: 优化维度列表

返回：

• result.optimizedSkill: 优化后的技能定义
• result.changes: 变更列表
• result.score: 优化评分

七、统一工具管理

7.1 查看租户工具列表

gateway(action="cloud.tools.list")

返回当前租户下所有工具（Skill 优先 + Plugin 兜底）。

7.2 查看工具详情

gateway(action="cloud.tools.detail", toolId="<tool-id>")

八、CLI 命令对照

CLI 命令	等效 RPC	说明
crabclaw skills list	skills.status	列出本地已加载技能
crabclaw skills list --eligible	cloud.skills.browse	列出商店可用技能
crabclaw skills info <name>	cloud.skills.browse(keyword=name)	查看技能详情
crabclaw skills add <name>	packages.install / cloud.skills.install	安装技能
crabclaw skills remove <name>	packages.remove	卸载本地技能
crabclaw skills check	skills.status	检查技能健康状态

九、故障排查

问题	解决
"managed auth not configured"	配置 models.managedModels.serverUrl
"not authenticated"	执行 models.auth.login.full
安装后技能未生效	检查 skills.status，确认目录和 frontmatter 格式
上传返回 401	token 过期，SDK 会自动刷新重试
认证状态为 FAILED	查看 certification.report 了解失败原因