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
2.0 KiB
2.0 KiB
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 流程
- 从
archives/中选取技能 - 复制到对应框架目录：
<framework>/skills/<skill-name>/ - 按需适配格式（参考
skill-publisher的格式适配规则） - 进入生命周期管理（测试 → 审计 → 发布）