Agent API

Agent 判断当前能力不足时，通过以下 API 发现并安装 Skill。Base URL：/api/v1

POST /api/v1/search

Request:
{
  "task": "分析Excel并生成经营汇报PPT",
  "agent": "codex",
  "inputs": ["xlsx"],
  "outputs": ["pptx"],
  "domain": "business",          // 可选：领域/场景/能力筛选
  "scene": "business-reporting", // 可选
  "capability": "chart-generation", // 可选
  "limit": 5                     // 可选，默认 10，最大 50
}

Response:
{
  "query_understanding": { "task": "create-presentation", "capabilities": [...], ... },
  "results": [
    {
      "skill": { "slug": "executive-presentation", "score": 94, "trust": 98, ... },
      "match": 0.79,
      "reason": ["匹配任务: 制作一份PPT", "支持输入: xlsx", "输出: pptx", "Codex Tested"]
    }
  ]
}

GET /api/v1/skills/[slug]

Response:
{
  "slug": "executive-presentation",
  "permissions": ["read-files", "write-files"],
  "risk_level": "LOW",
  "versions": [{ "version": "2.1.0", ... }],
  "skill_md": "---\nname: ...",
  "agent_prompt": "Install executive-presentation from YouDian Skills."
}

GET /api/v1/skills/[slug]/install

Response:
{
  "skill": "anthropic/executive-presentation",
  "install_command": "youdian add anthropic/executive-presentation",
  "agent_prompt": "Install executive-presentation from YouDian Skills.",
  "skill_md": "..."
}

POST /api/v1/publish

Headers:
  Authorization: Bearer sk_live_xxx

Request:
{ "name": "my-skill", "skillMd": "---\nname: my-skill\ndescription: ...", "publish": false }

Response (201):
{
  "skill": "anthropic/my-skill",
  "status": "draft",
  "install_command": "youdian add anthropic/my-skill",
  "admin_url": "/admin/skills/...",
  "auto_tags": {                       // 首次发布自动预分类（Auto-DNA）
    "capabilities": ["summarization"],
    "inputs": ["pdf"], "outputs": ["docx"],
    "scenes": ["weekly-report"], "tasks": [],
    "trigger_keywords": ["pdf", "总结"]
  },
  "security_scan": { "risk_level": "LOW", "findings": [] }
}

发布时自动执行安全扫描与分类推断（Auto-DNA 复用搜索理解词典），Skill 无需人工分类即可被筛选搜索命中；管理员可在后台修正。

友点 Skills Meta Skill

youdian install youdian

安装后 Agent 获得 search_skills / recommend_skill / compare_skills / get_skill / check_skill / check_update 能力。未经用户授权，不要自动安装高权限 Skill。