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
60 lines
1.3 KiB
Markdown
60 lines
1.3 KiB
Markdown
# 里程碑文档同步模式（通用模板）
|
||
|
||
**创建日期**: 2026-06-30
|
||
**适用场景**: MVP/里程碑完成后，需要同步代码和文档到远程仓库
|
||
|
||
---
|
||
|
||
## 触发条件
|
||
|
||
- 重大功能完成（如 MVP v1.0）
|
||
- 里程碑文档创建完成
|
||
- 需要备份/共享项目文档
|
||
|
||
## 同步流程
|
||
|
||
### 步骤 1: 代码和里程碑文档 → 远程仓库
|
||
|
||
```bash
|
||
# 进入项目目录
|
||
cd <项目目录>
|
||
|
||
# 查看未跟踪文件
|
||
git status
|
||
|
||
# 添加里程碑文档和关键代码
|
||
git add milestone/ <其他关键文件>
|
||
|
||
# 提交
|
||
git commit -m "feat: <版本> <功能描述>
|
||
|
||
- <成果1>
|
||
- <成果2>"
|
||
|
||
# 推送到远程仓库
|
||
git push origin <分支>
|
||
```
|
||
|
||
### 步骤 2: 核心文档 → 文档库（可选）
|
||
|
||
如有独立的文档仓库，同步核心 .md 文档：
|
||
|
||
```bash
|
||
# 进入文档库
|
||
cd <文档库目录>
|
||
|
||
# 复制核心文档
|
||
cp -r <项目目录>/milestone/ <文档库目录>/<项目名>/
|
||
|
||
# 提交
|
||
git add <项目名>/
|
||
git commit -m "feat: 添加 <项目名> <版本> 里程碑文档"
|
||
git push origin main
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **先主仓库后文档库** — 确保代码和文档先在版本控制中
|
||
2. **选择性同步** — 文档库只同步核心 .md 文档，不同步二进制/大文件
|
||
3. **milestone 命名** — 格式 `YYYY-MM-DD-v<版本>-<标签>`
|