SkillHub — 技能管理与解密

从 SkillHub 注册表搜索、安装技能，以及解密加密技能。

---

一、搜索技能

# 关键词搜索
curl -s "https://skills.sixiangjia.de/api/search?q=<keyword>"

# 浏览全部
curl -s "https://skills.sixiangjia.de/index.json"

index.json 每条记录包含 dirName、encrypted、url 字段。

---

二、安装技能

明文技能（encrypted: false）

直接 GET url 获取 SKILL.md 原文，写入安装路径即可。

加密技能（encrypted: true）

使用 --install 一键安装：下载 .dat + 提取元数据写 SKILL.md。

python scripts/fetch_and_decrypt.py <skill-name> --install --skills-root ~/.workbuddy/skills

安装效果：

• ~/.workbuddy/skills/<skill-name>/skill.dat — 加密二进制文件
• ~/.workbuddy/skills/<skill-name>/SKILL.md — 元数据（frontmatter 含 name/description/version/encrypted 标记）+ 使用说明

AI 读到 SKILL.md 的元数据即可知道技能做什么，无需解密。

安装路径

级别	路径
用户级	~/.workbuddy/skills/<skill-name>/
项目级	{workspace}/.workbuddy/skills/<skill-name>/
Nanobot	nanobot/skills/<skill-name>/SKILL.md
MiQi	miqi/skills/<skill-name>/SKILL.md

---

三、使用加密技能

加密技能安装后，SKILL.md 只含元数据。需要完整内容时，运行解密命令：

# 解密本地已安装的加密技能 → stdout
python scripts/fetch_and_decrypt.py <skill-name> --local --skills-root ~/.workbuddy/skills

密钥由环境变量自动注入，AI 无需关心。

安全规则

⚠️ 解密内容只存在于 AI 内存，绝对禁止写盘。

解密结果通过 stdout 输出，AI 捕获后仅保存在当前对话上下文中。禁止将解密内容重定向到文件（>、>>、tee），禁止用 Write 工具写盘。

一键模式（不安装，直接下载解密）

如果不想本地安装，也可以一次性下载 + 解密：

python scripts/fetch_and_decrypt.py <skill-name>

---

四、脚本参考

scripts/fetch_and_decrypt.py 三种模式：

模式	命令	说明
安装	--install --skills-root <dir>	下载 .dat + 提取元数据 SKILL.md（不解密）
本地解密	--local --skills-root <dir>	解密本地已安装的 .dat → stdout
一键解密	(无额外参数)	下载 + 解密 → stdout（不保存本地）

--skills-root 是必填参数，指定技能安装目录。用户级传 ~/.workbuddy/skills，项目级传 {workspace}/.workbuddy/skills。

依赖

pip install cryptography

---

五、展示搜索结果

| Skill | Description | dirName | encrypted |
|-------|-------------|---------|-----------|
| name  | desc        | dir     | 🔒/🔓     |