# 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. 进入生命周期管理（测试 → 审计 → 发布）