用途:在 OpenSpace 的本地注册表与云端技能库中发现、浏览技能。当用户询问“有哪些技能可用”“有没有做 X 的技能”,或遇到不熟悉的任务、需要决定自行处理还是委派给 OpenSpace 时使用。
主要能力:search_skills 为本地搜索,接收自然语言或关键词查询,query 必填,limit 可选(默认 20,最大结果数)。若需要云端结果,或云端操作提示密钥缺失/无效,则先配置云端访问再使用 cloud_browse_skills。cloud_browse_skills 是单个云端工具,用返回的 next_actions[].action 持续调用,例如 search_skills、local_placement、import_skill。仅在需要包发现或包大纲时使用 recall 与 pull_projection;具体技能搜索应从 search_skills 开始。
使用方式:配置云端需提供 email 与 agent_name,密码仅通过安全密文输入,长度 8 至 72 字符;不要索取 passcode/OTP,因为 cloud_auth_flow 不接受。示例:cloud_auth_flow(action="bootstrap_agent_key", email="user@example.com", password="<secure-password>", agent_name="openspace-local-agent")。若无安全密码输入,请用户运行:openspace-cloud-auth bootstrap-agent-key --email user@example.com --agent-name openspace-local-agent。之后使用 cloud_browse_skills。local_category_path 用于用户本地包分类,形状与云端包路径相同但独立存储,可更具体;导入前用 local_placement 查看现有路径并创建相邻子路径。
结果处理:结果返回给使用者而非直接执行。云端导入在 cloud_browse_skills(action="import_skill", ...) 后返回 local_path。匹配到技能且可自行执行时,读取 local_path 下的 SKILL.md 并遵循其指令;匹配但缺乏能力时,通过 execute_task 委派(见 delegate-task 技能);无匹配则自行处理或委派。
限制:本工具用于发现,由使用者查看结果后决定;直接执行应使用 delegate-task 技能中的 execute_task。应始终告知用户发现了什么或未发现什么,以及建议。其余细节暂未提供。