8dafa5bc52
- Add archives/ directory for immutable external skill snapshots - Strict immutability rule: only README/CHANGELOG can be modified - First import: dev-pipeline-universal v1.0.0 (Hermes Agent) - Import dev-pipeline-universal into hermes-agent/skills/ with CHANGELOG - Update hermes-agent/publish/registry.json with imported skill - Rewrite meta-skills/create-hermes-agent-skill/ with full spec: - SKILL.md frontmatter fields and validator constraints - Recommended body structure (Overview → When to Use → Pitfalls → Verification) - Progressive disclosure (3-level loading) - 8 writing quality principles - Official reference skills from GitHub repo - Tool chain docs (skill_manage, /learn, skill_view) - Update README.md with archives/ in directory structure
55 lines
2.0 KiB
Markdown
55 lines
2.0 KiB
Markdown
# SkillSpace Archives — 外部技能归档
|
||
|
||
本目录用于存放从其他地方开发的技能压缩包基础版，作为参考和导入来源。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
archives/
|
||
├── README.md # 本说明文档
|
||
├── <skill-name>/ # 解压后的技能目录（便于查看和引用）
|
||
│ ├── SKILL.md
|
||
│ ├── references/
|
||
│ └── ...
|
||
├── <skill-name>.skill # 原始压缩包（.skill / .zip / .tar.gz）
|
||
└── ...
|
||
```
|
||
|
||
## 命名规范
|
||
|
||
- 解压目录与压缩包使用相同的 `<skill-name>` 前缀
|
||
- 如有多个版本，追加版本号：`<skill-name>-v1.0.0.skill`
|
||
|
||
## 不可变规则（强制）
|
||
|
||
> **`archives/` 是最原始的数据来源，技能后续的版本迭代和优化严禁修改此目录下的任何技能文件。**
|
||
|
||
| 允许修改 | 禁止修改 |
|
||
|---------|---------|
|
||
| `<skill-name>/README.md`（归档说明日志） | `SKILL.md`、`prompt.md`、`_meta.json` 等技能核心文件 |
|
||
| `<skill-name>/CHANGELOG.md`（归档日志） | `references/`、`scripts/`、`templates/` 等所有子目录和文件 |
|
||
| 本文件 `archives/README.md` | 原始压缩包（`.skill`、`.zip`、`.tar.gz`） |
|
||
| | `skill.json`、`tools/`、`tests/` 等所有文件 |
|
||
|
||
**原因**：archives/ 是技能的**原始快照**，用于：
|
||
- 与迭代后的版本进行 diff 对比
|
||
- 在导入版本出问题时回溯到原始状态
|
||
- 作为不可变的审计基线
|
||
|
||
如需修改技能内容，必须在对应框架目录（`<framework>/skills/<skill-name>/`）中操作，而非 archives/。
|
||
|
||
---
|
||
|
||
## 用途
|
||
|
||
- **参考学习**：查看其他团队或社区的优秀技能实现
|
||
- **导入复用**：将外部技能适配后纳入 SkillSpace 生命周期管理
|
||
- **基础版本归档**：保留技能的初始版本快照，便于对比迭代
|
||
|
||
## 导入到 SkillSpace 流程
|
||
|
||
1. 从 `archives/` 中选取技能
|
||
2. 复制到对应框架目录：`<framework>/skills/<skill-name>/`
|
||
3. 按需适配格式（参考 `skill-publisher` 的格式适配规则）
|
||
4. 进入生命周期管理（测试 → 审计 → 发布）
|