Fix OpenClaw format, add git hook info, clarify staging directory

This commit is contained in:
sinohqb 2026-07-03 15:20:09 +08:00
parent 5f77e1b8e5
commit 5fa75cb089

View File

@ -21,7 +21,7 @@ SkillSpace 是一个**文档工程**,不是应用代码仓库。产出物是
- `docs/` — 框架适配文档 - `docs/` — 框架适配文档
此外: 此外:
- **`archives/`** — 外部技能压缩包及解压目录,**不可变**。严禁修改其中的技能文件,仅允许更新其 `README.md``CHANGELOG.md`。技能迭代必须在 `<framework>/skills/<name>/` 中进行。 - **`archives/`** — 外部技能压缩包及解压目录,**不可变**。严禁修改其中的技能文件,仅允许更新其 `README.md``CHANGELOG.md`。技能迭代必须在 `<framework>/skills/<name>/` 中进行。命名约定:`<name>-<version>`(解压目录)、`<name>-<version>.zip`(压缩包)、`<name>-<version>_server`(服务端变体)。
- **`SKILL-REGISTRY.md`** — 全仓库技能总清单,增删技能时必须同步。 - **`SKILL-REGISTRY.md`** — 全仓库技能总清单,增删技能时必须同步。
- **`AGENTS.md`** — 面向所有 AI 助手的规则文件,本 CLAUDE.md 是其超集。 - **`AGENTS.md`** — 面向所有 AI 助手的规则文件,本 CLAUDE.md 是其超集。
@ -31,9 +31,9 @@ SkillSpace 是一个**文档工程**,不是应用代码仓库。产出物是
| 框架 | 核心文件 | 备注 | | 框架 | 核心文件 | 备注 |
|------|---------|------| |------|---------|------|
| OpenClaw | `SKILL.md` + `_meta.json` | SKILL.md 含 YAML frontmatter原生兼容 SkillHub | | OpenClaw | `SKILL.md` | SKILL.md 含 YAML frontmatter原生兼容 SkillHub。技能目录通常还包含 `QUICKSTART.sh`、`assets/`、`scripts/`、`references/` |
| Hermes Agent | `SKILL.md` | frontmatter 含 `metadata.hermes`description ≤1024 字符且以 `"Use when ..."` 开头 | | Hermes Agent | `SKILL.md` | frontmatter 含 `metadata.hermes`description ≤1024 字符且以 `"Use when ..."` 开头 |
| Qoder / Codex / Claude Code | `skill.json` + `prompt.md` | 发布到 SkillHub 前需合并生成临时 `SKILL.md`(放在 `<framework>/publish/.staging/` | | Qoder / Codex / Claude Code | `skill.json` + `prompt.md` | 发布到 SkillHub 前需合并生成临时 `SKILL.md`(放在 `<framework>/publish/.staging/`,临时目录,不提交 git |
## 发布流程SkillHub ## 发布流程SkillHub
@ -79,6 +79,7 @@ SkillSpace 是一个**文档工程**,不是应用代码仓库。产出物是
- Commit message 使用**英文**、描述性风格。 - Commit message 使用**英文**、描述性风格。
- 远程仓库:`https://git.solahqb22.cn/solahqb/SkillSpace.git`(凭证已通过 `credential.helper store` 配置)。 - 远程仓库:`https://git.solahqb22.cn/solahqb/SkillSpace.git`(凭证已通过 `credential.helper store` 配置)。
- **Git post-commit hook**:每次提交会自动调用 `qodercli commit --hook` 上报至 Qoder 追踪系统。不要移除或绕过此 hook。
## 关键文件索引 ## 关键文件索引