mirror of https://github.com/hansjone/oclaw.git synced 2026-10-11 04:10:44 +08:00

oliver beb52006d8 refactor: move bundled skills tree to repo root skills/

- Relocate runtime/skills -> skills/; runtime_skills_root() prefers oclaw/skills
  with fallback to legacy runtime/skills for unmigrated trees.
- session-bootstrap hook handler resolves repo root via PROJECT_ROOT.
- Update architecture/migration docs and in-tree skill references.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-05-10 11:35:57 +08:00

1.8 KiB

Raw Blame History

Oclaw — Skill 搜索指南

市场提供方

由设置 AIA_SKILL_MARKET_PROVIDER 决定：clawhub（默认）或 cocoloop（见主 SKILL.md 对照表）。Admin 的 market/search 与 market/detail 会调用当前提供方适配器。

主源：ClawHub

当 AIA_SKILL_MARKET_PROVIDER=clawhub 时使用。

Admin HTTP（ClawHub 模式下）

搜索：GET /admin/api/skills/market/search?q=<关键词>&limit=<n>
详情：GET /admin/api/skills/market/detail?slug=<slug>

从详情中读取：slug、version、描述、以及安装所需的 archiveUrl（ClawHub 下载链）。

主源：CocoLoop 商店

当 AIA_SKILL_MARKET_PROVIDER=cocoloop 时，同一组 Admin 路由背后走 cocoloop_client：关键词搜索商店列表，按技能 name 字段 匹配 slug；详情中的安装 URL 来自列表 download_url（或按 asset_name 拼 zip 直链）。商店前端：hub.cocoloop.cn。

模型侧

若无 Admin 权限，请用户代为搜索/安装，或提供准确 slug / archive_url。

重要：市场搜索不是安装前置条件。
模型安装策略下只允许 skill_auto_install。若没有可用市场结果，应向用户索取可安装内容（如技能描述、SKILL.md 或源文件）并走 skill_auto_install，而不是要求先配置 AIA_INTERNAL_BASE_URL 或先启动本地 5173 服务。

辅助源：GitHub（可选）

当市场无结果或用户指定开源仓库时：

GET https://api.github.com/search/repositories?q=<关键词>+filename:SKILL.md&sort=stars&order=desc

需自备 User-Agent，注意 API 速率限制。找到仓库后仍需可安装的归档 URL 再走 install-registry。

合并展示建议

向用户展示时标注来源：[ClawHub] / [GitHub]，并给出 slug 或 full_name。

1.8 KiB Raw Blame History Unescape Escape