# SkillSpace — 智能体技能全生命周期管理中心 SkillSpace 是一个通用的智能体技能工作目录，用于**创建、验证、发布和版本管理**各类智能体框架的技能（Skills / Tools / Capabilities）。 --- ## 定位 - 技能的**全生命周期管理**：从设计、开发、测试到发布上线 - 技能的**全版本管理**：支持多版本并存、灰度发布、回滚 - **分框架独立管理**：不同智能体框架的技能编写规范存在差异，按框架隔离目录，各自遵循对应框架的规范 --- ## 支持的智能体框架 | 框架名称 | 说明 | |---------|------| | **Qoder** | Qoder CLI 智能体框架，支持技能（Skills）、子智能体（Agents）、MCP 服务器等扩展机制 | | **Claude Code** | Anthropic 的 Claude Code 智能体，支持工具调用和自定义指令扩展 | | **Codex** | OpenAI Codex 智能体框架，支持函数定义和工具集成 | | **OpenClaw** | 开源智能体框架，提供灵活的技能编排和插件体系 | | **Hermes Agent** | Hermes 系列智能体，支持结构化输出和工具调用协议 | --- ## 目录结构（规划） ``` SkillSpace/ ├── README.md # 本说明文档 │ ├── skills/ # 生命周期管理技能（用户唯一入口） │ ├── skill-lifecycle/ # 🎯 总路由器（唯一入口，意图识别 + 分发） │ ├── skill-discover/ # 🔍 调研（搜索已有技能、可行性分析） │ ├── skill-router/ # ➕ 创建（交互式向导，路由到各框架 meta-skill） │ ├── skill-tester/ # 🧪 测试（静态检查 + 动态测试引导） │ ├── skill-auditor/ # 🛡️ 审计（安全扫描 + 合规检查） │ ├── skill-debugger/ # 🐛 排查（问题分类 + 根因定位 + 修复） │ ├── skill-updater/ # 🔄 更新（SemVer 升级 + CHANGELOG + 回归提醒） │ ├── skill-publisher/ # 🚀 发布（发布到 SkillHub + 各平台） │ └── skill-retire/ # 📦 归档（废弃标记 + 替代方案 + 归档） │ ├── meta-skills/ # 技能的技能（创建技能的指导技能） │ │ # 每个子目录是一个"如何为某框架创建技能"的技能 │ ├── create-qoder-skill/ │ │ ├── skill.json # 技能元信息 │ │ ├── prompt.md # 指导 Prompt：如何创建 Qoder 技能 │ │ ├── spec.md # Qoder 技能规范摘要 │ │ ├── examples/ # 官方或社区参考技能示例 │ │ └── CHANGELOG.md │ ├── create-claude-code-skill/ │ ├── create-codex-skill/ │ ├── create-openclaw-skill/ │ └── create-hermes-agent-skill/ │ ├── qoder/ # ===== Qoder 框架技能目录 ===== │ ├── skills/ # 技能源码 │ │ └── / │ │ ├── skill.json # 技能元信息（名称、版本等） │ │ ├── prompt.md # 技能 Prompt / 指令定义 │ │ ├── tools/ # 工具定义或 MCP 配置 │ │ ├── tests/ # 验证用例 │ │ └── CHANGELOG.md # 版本变更记录 │ ├── versions/ # 版本归档（语义化版本快照） │ │ └── /v1.0.0/ │ ├── publish/ # 发布配置与脚本 │ │ └── registry.json │ └── docs/ # 框架适配文档 │ ├── claude-code/ # ===== Claude Code 框架技能目录 ===== │ ├── skills/ │ ├── versions/ │ ├── publish/ │ └── docs/ │ ├── codex/ # ===== Codex 框架技能目录 ===== │ ├── skills/ │ ├── versions/ │ ├── publish/ │ └── docs/ │ ├── openclaw/ # ===== OpenClaw 框架技能目录 ===== │ ├── skills/ │ ├── versions/ │ ├── publish/ │ └── docs/ │ └── hermes-agent/ # ===== Hermes Agent 框架技能目录 ===== ├── skills/ ├── versions/ ├── publish/ └── docs/ archives/ # 外部技能归档（从其他地方开发的技能压缩包基础版） ├── / # 解压后的技能目录 ├── .skill # 原始压缩包（.skill / .zip / .tar.gz） └── README.md # 归档说明和导入流程 ``` --- ## meta-skills：技能的技能 `meta-skills/` 是一个特殊目录，存放的是**"如何创建技能"的技能**，即技能创建指南。 ### 用途 - 当你需要为某个框架新建技能时，调用对应的 meta-skill，它会引导你完成： - 该框架的技能**规范和要求**（格式、字段、限制） - 该框架的**官方参考技能**或社区最佳实践 - 技能的**标准开发流程**和检查清单 ### 每个 meta-skill 包含 | 文件 | 说明 | |------|------| | `skill.json` | 技能元信息（名称、版本、目标框架） | | `prompt.md` | 核心指导 Prompt，描述如何为该框架创建技能 | | `spec.md` | 该框架的技能规范摘要（字段定义、格式要求、限制条件） | | `examples/` | 官方或社区参考技能示例（可运行的最小示例） | | `CHANGELOG.md` | 版本变更记录 | ### 示例 ``` # 想创建一个 OpenClaw 技能？ # 调用 meta-skills/create-openclaw-skill/ # → 它会告诉你 OpenClaw 技能需要遵循什么规范、 # 有哪些官方参考技能、标准的创建步骤是什么 ``` --- ## 技能生命周期 用户通过 **`skill-lifecycle`**（唯一入口）即可覆盖技能的全部生命周期，系统自动识别意图并路由到对应子技能。 ``` 用户 ──→ skill-lifecycle（总路由）──→ 自动分发到子技能 discover → create → test → audit → publish ↑ ↑ │ └──── retire ←───────┴── update ←┘ debug ``` | 阶段 | 子技能 | 职责 | |------|--------|------| | 🔍 调研 | `skill-discover` | 搜索已有技能、分析框架能力、评估可行性 | | ➕ 创建 | `skill-router` | 交互式向导创建新技能，路由到各框架 meta-skill | | 🧪 测试 | `skill-tester` | 静态文件检查 + 真实环境动态测试 | | 🛡️ 审计 | `skill-auditor` | 安全扫描（注入、权限、数据泄露）+ 合规检查 | | 🐛 排查 | `skill-debugger` | 问题分类、根因定位、修复方案 | | 🔄 更新 | `skill-updater` | SemVer 版本升级、CHANGELOG 生成、回归提醒 | | 🚀 发布 | `skill-publisher` | 发布到 SkillHub 和各平台 | | 📦 归档 | `skill-retire` | 废弃标记、替代方案、版本归档 | ### 阶段衔接建议 ``` discover → "调研完成，是否创建？" → create create → "技能已创建，建议测试" → test test → "测试通过，建议审计" → audit audit → "审计通过，可以发布" → publish debug → "问题已修复，重新测试" → test update → "更新完成，重新测试" → test publish → "发布成功" → 结束 retire → "已归档" → 结束 ``` --- ## 版本管理规范 - 采用 **语义化版本（SemVer）**：`MAJOR.MINOR.PATCH` - `MAJOR`：不兼容的重大变更 - `MINOR`：向下兼容的功能新增 - `PATCH`：向下兼容的问题修复 - 每次发布在 `/versions//vX.Y.Z/` 保留完整快照 - `CHANGELOG.md` 记录每个版本的变更摘要 --- ## 快速开始 ``` # 所有操作都通过 skill-lifecycle 这一个入口 # 想创建新技能？ → 调用 skill-lifecycle，说"创建一个 OpenClaw 的 PDF 处理技能" # 想测试已有技能？ → 调用 skill-lifecycle，说"帮我测试 qoder/skills/my-skill" # 想发布到平台？ → 调用 skill-lifecycle，说"发布 openclaw/skills/my-skill 到 ClawHub" # 想了解已有技能？ → 调用 skill-lifecycle，说"帮我调研有没有现成的 Docker 调试技能" ``` --- ## 发布平台：SkillHub SkillHub 是团队自建的 Agent Skill Registry（`https://skill.solahqb22.cn`），支持 **14 种 Agent CLI** 的技能发布、搜索和安装。 ### CLI 工具 ```bash npm install -g @astron-team/skillhub # 安装 skillhub login --registry https://skill.solahqb22.cn --token # 登录 skillhub search # 搜索 skillhub publish --namespace # 发布 ``` ### 命名空间映射 | 框架 | SkillHub 命名空间 | 说明 | |------|------------------|------| | OpenClaw | `sola-openclaw-work` | OpenClaw 框架开发的技能 | | Claude Code | `sola-claude-code-work` | Claude Code 开发的技能 | | Codex | `sola-codex-work` | Codex 开发的技能 | | Qoder | `sola-qoder-work` | Qoder 创建的技能 | | Hermes Agent | 暂无 | 等待官方支持 | ### 格式适配 - **OpenClaw**：原生兼容（已有 `SKILL.md`），直接发布 - **Qoder / Codex / Claude Code**：`skill-publisher` 自动将 `skill.json` + `prompt.md` 合并生成 `SKILL.md` 后发布 - **Hermes Agent**：暂不支持 --- ## 后续规划 - [x] 搭建完整目录结构（5 个框架 + 9 个生命周期技能） - [x] 构建 skill-lifecycle 总路由器和 8 个子技能 - [x] OpenClaw meta-skill 规范整理（基于 ClawHub 官方生态） - [x] SkillHub 集成（skill-publisher / skill-discover / skill-retire 更新） - [ ] 补充各框架 meta-skill 的详细规范（Qoder / Claude Code / Codex / Hermes Agent） - [ ] 为各框架 meta-skill 的 `examples/` 补充官方参考技能示例 - [ ] 为每个框架编写适配指南（`/docs/`） - [ ] 建设技能示例库（提供参考实现） --- ## 说明 本目录当前处于**初始化阶段**，目录结构和工具链将随技能开发实践逐步完善。如有建议或贡献，请在项目仓库中提交 Issue 或 PR。