github-mirrors/edict

Fork 0

mirror of https://mirror.skon.top/github.com/cft0808/edict synced 2026-04-30 14:00:45 +08:00

Files

luoyanglang f21c0b293a fix(skills): remove broken default skills hub

2026-04-25 07:39:55 +00:00

10 KiB

Raw Permalink Blame History

远程 Skills 资源管理指南

概述

三省六部现已支持从网上连接和增补 skills 资源，无需手动复制文件。支持从以下来源获取：

GitHub 仓库 (raw.githubusercontent.com)
任何 HTTPS URL (需返回有效的 skill 文件)
本地文件路径
默认 Skills 源 (经验证可访问的内置导入源)

功能架构

1. API 端点

`POST /api/add-remote-skill`

从远程 URL 或本地路径为指定 Agent 添加 skill。

请求体：

{
  "agentId": "zhongshu",
  "skillName": "code_review",
  "sourceUrl": "https://raw.githubusercontent.com/org/skills-repo/main/code_review/SKILL.md",
  "description": "代码审查专项技能"
}

参数说明：

agentId (string, 必需): 目标 Agent ID (验证有效性)
skillName (string, 必需): skill 的内部名称 (仅允许字母/数字/下划线/汉字)
sourceUrl (string, 必需): 远程 URL 或本地文件路径
- GitHub: https://raw.githubusercontent.com/user/repo/branch/path/SKILL.md
- 任意 HTTPS: https://example.com/skills/my_skill.md
- 本地: file:///Users/bingsen/skills/code_review.md 或 /Users/bingsen/skills/code_review.md
description (string, 可选): skill 的中文描述

响应成功 (200)：

{
  "ok": true,
  "message": "技能 code_review 已添加到 zhongshu",
  "skillName": "code_review",
  "agentId": "zhongshu",
  "source": "https://raw.githubusercontent.com/...",
  "localPath": "/Users/bingsen/.openclaw/workspace-zhongshu/skills/code_review/SKILL.md",
  "size": 2048,
  "addedAt": "2026-03-02T14:30:00Z"
}

响应失败 (400)：

{
  "ok": false,
  "error": "URL 无效或无法访问",
  "details": "Connection timeout after 10s"
}

`GET /api/remote-skills-list`

列出所有已添加的远程 skills 及其源信息。

响应：

{
  "ok": true,
  "remoteSkills": [
    {
      "skillName": "code_review",
      "agentId": "zhongshu",
      "sourceUrl": "https://raw.githubusercontent.com/org/skills-repo/main/code_review/SKILL.md",
      "description": "代码审查专项技能",
      "localPath": "/Users/bingsen/.openclaw/workspace-zhongshu/skills/code_review/SKILL.md",
      "lastUpdated": "2026-03-02T14:30:00Z",
      "status": "valid"  // valid | invalid | not-found
    }
  ],
  "count": 5
}

`POST /api/update-remote-skill`

更新已添加的远程 skill 为最新版本。

请求体：

{
  "agentId": "zhongshu",
  "skillName": "code_review"
}

响应：

{
  "ok": true,
  "message": "技能已更新",
  "skillName": "code_review",
  "newVersion": "2.1.0",
  "updatedAt": "2026-03-02T15:00:00Z"
}

`DELETE /api/remove-remote-skill`

移除已添加的远程 skill。

请求体：

{
  "agentId": "zhongshu",
  "skillName": "code_review"
}

CLI 命令

添加远程 Skill

python3 scripts/skill_manager.py add-remote \
  --agent zhongshu \
  --name code_review \
  --source https://raw.githubusercontent.com/org/skills-repo/main/code_review/SKILL.md \
  --description "代码审查专项技能"

列出远程 Skills

python3 scripts/skill_manager.py list-remote

更新远程 Skill

python3 scripts/skill_manager.py update-remote \
  --agent zhongshu \
  --name code_review

移除远程 Skill

python3 scripts/skill_manager.py remove-remote \
  --agent zhongshu \
  --name code_review

默认 Skills 源

MiniMax CLI Skill

默认导入源包含经验证可访问的 MiniMax CLI skill。旧的 openclaw-ai/skills-hub 仓库当前不可用，因此不再作为默认官方源。

可用 skills 列表：

Skill 名称	描述	适用 Agent	源 URL
`mmx_cli`	MiniMax 多模态 CLI 技能	门下省/尚书省	https://raw.githubusercontent.com/MiniMax-AI/cli/main/skill/SKILL.md

如果你维护自己的 Skills Hub，可以使用以下方式指定 Hub base URL。指定后，import-official-hub 会按 <base>/<skill_name>/SKILL.md 解析 code_review、api_design、security_audit、data_analysis、doc_generation、test_framework 等传统 skill 名称。

export OPENCLAW_SKILLS_HUB_BASE=https://your-hub/raw-base

# 或写入本地配置
echo "https://your-hub/raw-base" > ~/.openclaw/skills-hub-url

一键导入默认 skills

python3 scripts/skill_manager.py import-official-hub \
  --agents menxia,shangshu

看板 UI 操作

快捷添加 Skill

打开看板 → 🔧 技能配置 面板
点击 ➕ 添加远程 Skill 按钮
填写表单：
- Agent: 选择目标 Agent
- Skill 名称: 输入 skill 的内部 ID
- 远程 URL: 粘贴 GitHub/HTTPS URL
- 中文描述: 可选，简述 skill 功能
点击确认按钮

管理已添加的 Skills

看板 → 🔧 技能配置 → 远程 Skills 标签
查看已添加的所有 skills 及其源地址
操作：
- 查看: 展示 SKILL.md 内容
- 更新: 从源 URL 重新下载最新版本
- 删除: 移除本地副本（不影响源）
- 复制源 URL: 快速分享给他人

Skill 文件规范

远程 skills 必须遵循标准的 Markdown 格式：

最小必需结构

---
name: skill_internal_name
description: Short description
version: 1.0.0
tags: [tag1, tag2]
---

# Skill 名称

详细描述...

## 输入

说明接收什么参数

## 处理流程

具体步骤...

## 输出规范

输出格式说明

完整示例

---
name: code_review
description: 对 Python/JavaScript 代码进行结构审查和优化建议
version: 2.1.0
author: openclaw-ai
tags: [code-quality, security, performance]
compatibleAgents: [bingbu, xingbu, menxia]
---

# 代码审查技能

本技能专门用于对生产代码进行多维度审查...

## 输入

- `code`: 要审查的源代码
- `language`: 编程语言 (python, javascript, go, rust)
- `focusAreas`: 审查重点 (security, performance, style, structure)

## 处理流程

1. 语言识别与语法验证
2. 安全漏洞扫描
3. 性能瓶颈识别
4. 代码风格检查
5. 最佳实践建议

## 输出规范

```json
{
  "issues": [
    {
      "type": "security|performance|style|structure",
      "severity": "critical|high|medium|low",
      "location": "line:column",
      "message": "问题描述",
      "suggestion": "修复建议"
    }
  ],
  "summary": {
    "totalIssues": 3,
    "criticalCount": 1,
    "highCount": 2
  }
}

适用场景

兵部（代码实现）的代码产出审查
刑部（合规审计）的安全检查
门下省（审议把关）的质量评估

依赖与限制

需要 Python 3.9+
支持文件大小: 最多 50KB
执行超时: 30 秒


---

## 数据存储

### 本地存储结构

~/.openclaw/ ├── workspace-zhongshu/ │ └── skills/ │ ├── code_review/ │ │ ├── SKILL.md │ │ └── .source.json # 存储源 URL 和元数据 │ └── api_design/ │ ├── SKILL.md │ └── .source.json ├── ...


### .source.json 格式

```json
{
  "skillName": "code_review",
  "sourceUrl": "https://raw.githubusercontent.com/...",
  "description": "代码审查专项技能",
  "version": "2.1.0",
  "addedAt": "2026-03-02T14:30:00Z",
  "lastUpdated": "2026-03-02T14:30:00Z",
  "lastUpdateCheck": "2026-03-02T15:00:00Z",
  "checksum": "sha256:abc123...",
  "status": "valid"
}

安全考虑

URL 验证

✅ 允许的 URL 类型:

HTTPS URLs: https://
本地文件: file:// 或绝对路径
相对路径: ./skills/

❌ 禁止的 URL 类型:

HTTP (非 HTTPS): http:// 被拒绝
本地模式 HTTP: http://localhost/ (避免环回攻击)
FTP/SSH: ftp://, ssh://

内容验证

格式验证: 确保是有效的 Markdown YAML frontmatter
大小限制: 最多 10 MB
超时保护: 下载超过 30 秒自动中止
路径遍历防护: 检查解析后的 skill 名称，禁用 ../ 模式
checksum 验证: 可选的 GPG 签名验证（适用于可信发布源）

隔离执行

远程 skills 在沙箱中执行（由 OpenClaw runtime 提供）
无法访问 ~/.openclaw/config.json 等敏感文件
只能访问分配的 workspace 目录

故障排查

常见问题

Q: 下载失败，提示 "Connection timeout"

A: 检查网络连接和 URL 有效性：

curl -I https://raw.githubusercontent.com/...

Q: Skill 显示 "invalid" 状态

A: 检查文件格式：

python3 -m json.tool ~/.openclaw/workspace-zhongshu/skills/xxx/SKILL.md

Q: 能否从私有 GitHub 仓库导入？

A: 不支持（安全考虑）。可以：

将仓库设为公开
在本地下载后直接添加
通过 GitHub Gist 的公开链接

Q: 如何创建自己的 skills 库？

A: 按 <skill_name>/SKILL.md 的结构创建自己的仓库，然后：

git clone https://github.com/yourname/my-skills-hub.git
cd my-skills-hub
# 创建 skill 文件结构
# 提交 & 推送到 GitHub

然后通过 URL 添加，或通过 OPENCLAW_SKILLS_HUB_BASE / ~/.openclaw/skills-hub-url 配置为自定义 Hub 后导入。

最佳实践

1. 版本管理

始终在 SKILL.md 的 frontmatter 中标注版本号：

---
version: 2.1.0
---

2. 向后兼容

更新 skill 时保持输入/输出格式兼容，避免破坏现有流程。

3. 文档完整

包含详细的:

功能描述
适用场景
依赖说明
输出示例

4. 定期更新

设置定期检查更新（周期可在看板中配置）：

python3 scripts/skill_manager.py check-updates --interval weekly

5. 贡献社区

成熟的 skills 可以沉淀到你自己的公开 Skills Hub，并通过 OPENCLAW_SKILLS_HUB_BASE 分享给团队使用。

API 完整参考

详见任务分发流转架构文档的第三部分（API 与工具）。

_{用开放的生态，赋能制度化的 AI 协作}

10 KiB Raw Permalink Blame History Unescape Escape

远程 Skills 资源管理指南

概述

功能架构

1. API 端点

POST /api/add-remote-skill

GET /api/remote-skills-list

POST /api/update-remote-skill

DELETE /api/remove-remote-skill

CLI 命令

添加远程 Skill

列出远程 Skills

更新远程 Skill

移除远程 Skill

默认 Skills 源

MiniMax CLI Skill

看板 UI 操作

快捷添加 Skill

管理已添加的 Skills

Skill 文件规范

最小必需结构

完整示例

适用场景

依赖与限制

安全考虑

URL 验证

内容验证

隔离执行

故障排查

常见问题

最佳实践

1. 版本管理

2. 向后兼容

3. 文档完整

4. 定期更新

5. 贡献社区

API 完整参考

10 KiB

Raw Permalink Blame History

`POST /api/add-remote-skill`

`GET /api/remote-skills-list`

`POST /api/update-remote-skill`

`DELETE /api/remove-remote-skill`