统一技能安装与 Skills 市场接入链路。

新增公开安装工具与多来源 provider 支持，补齐管理端与目录加载逻辑，并同步更新相关测试与文档以保证可见性和路径安全。

Made-with: Cursor

runtime/tools/public/skills_install_tool.py

@@ -0,0 +1,141 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from oclaw.platform.config.paths import db_path
+from oclaw.platform.persistence.sqlite_store import SqliteStore
+from oclaw.runtime.skill_installer import install_skill_from_registry_archive
+from oclaw.runtime.skills import default_skills_root
+from oclaw.runtime.skills_market import get_market_adapter, normalize_skill_market_provider_setting
+from oclaw.runtime.tools.base import ToolSpec
+
+
+def _store() -> SqliteStore:
+    return SqliteStore(db_path())
+
+
+def _agent_workspace_skills_root() -> Path:
+    # Agent-origin installs are isolated under _workspace lane.
+    return default_skills_root() / "_workspace"
+
+
+def skill_market_install_tool() -> ToolSpec:
+    def _handler(args: dict[str, Any]) -> dict[str, Any]:
+        payload = args if isinstance(args, dict) else {}
+        slug = str(payload.get("slug") or "").strip()
+        if not slug:
+            return {"ok": False, "error_code": "slug_required", "error": "slug_required"}
+        version = str(payload.get("version") or "").strip() or None
+        overwrite = bool(payload.get("overwrite"))
+        store = _store()
+        provider_arg = str(payload.get("provider") or "").strip()
+        if provider_arg:
+            provider = normalize_skill_market_provider_setting(provider_arg)
+        else:
+            provider = normalize_skill_market_provider_setting(str(store.get_setting("AIA_SKILL_MARKET_PROVIDER") or ""))
+        try:
+            adapter = get_market_adapter(provider)
+            archive_url, chosen_version = adapter.resolve_archive_url(slug=slug, version=version)
+        except Exception as exc:
+            return {
+                "ok": False,
+                "error_code": "market_resolve_failed",
+                "error": f"market_resolve_failed:{type(exc).__name__}",
+                "provider": provider,
+                "slug": slug,
+            }
+        if not str(archive_url or "").strip():
+            return {
+                "ok": False,
+                "error_code": "archive_url_unavailable",
+                "error": "archive_url_unavailable",
+                "provider": provider,
+                "slug": slug,
+            }
+        out = install_skill_from_registry_archive(
+            store=store,
+            archive_url=str(archive_url),
+            overwrite=overwrite,
+            skills_root=_agent_workspace_skills_root(),
+        )
+        return {
+            "ok": bool(out.ok),
+            "result": {
+                "name": out.name,
+                "target_dir": out.target_dir,
+                "detail": out.detail,
+                "error_code": out.error_code,
+                "retryable": bool(out.retryable),
+            },
+            "provider": provider,
+            "slug": slug,
+            "version": str(chosen_version or version or ""),
+        }
+
+    return ToolSpec(
+        name="skill_market_install",
+        description="Install a skill from configured market by slug/version.",
+        parameters={
+            "type": "object",
+            "properties": {
+                "slug": {"type": "string"},
+                "provider": {"type": "string", "description": "Optional provider override: clawhub or cocoloop."},
+                "version": {"type": "string"},
+                "overwrite": {"type": "boolean"},
+            },
+            "required": ["slug"],
+            "additionalProperties": False,
+        },
+        handler=_handler,
+        tags=frozenset({"skill", "installer", "market"}),
+        risk_level="medium",
+        timeout_s=120.0,
+    )
+
+
+def skill_registry_install_tool() -> ToolSpec:
+    def _handler(args: dict[str, Any]) -> dict[str, Any]:
+        payload = args if isinstance(args, dict) else {}
+        archive_url = str(payload.get("archive_url") or "").strip()
+        if not archive_url:
+            return {"ok": False, "error_code": "archive_url_required", "error": "archive_url_required"}
+        overwrite = bool(payload.get("overwrite"))
+        out = install_skill_from_registry_archive(
+            store=_store(),
+            archive_url=archive_url,
+            overwrite=overwrite,
+            skills_root=_agent_workspace_skills_root(),
+        )
+        return {
+            "ok": bool(out.ok),
+            "result": {
+                "name": out.name,
+                "target_dir": out.target_dir,
+                "detail": out.detail,
+                "error_code": out.error_code,
+                "retryable": bool(out.retryable),
+            },
+        }
+
+    return ToolSpec(
+        name="skill_registry_install",
+        description="Install a skill from archive URL (registry/market artifact).",
+        parameters={
+            "type": "object",
+            "properties": {
+                "archive_url": {"type": "string"},
+                "overwrite": {"type": "boolean"},
+            },
+            "required": ["archive_url"],
+            "additionalProperties": False,
+        },
+        handler=_handler,
+        tags=frozenset({"skill", "installer", "registry"}),
+        risk_level="medium",
+        timeout_s=120.0,
+    )
+
+
+__all__ = ["skill_market_install_tool", "skill_registry_install_tool"]
+