SkillSpace/hermes-agent/skills/dev-pipeline-universal/references/doc-sync-pattern.md
sinohqb 8dafa5bc52 Add archives, import dev-pipeline skill, and complete Hermes Agent spec
- 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
2026-07-02 00:46:13 +08:00

1.3 KiB
Raw Blame History

里程碑文档同步模式(通用模板)

创建日期: 2026-06-30 适用场景: MVP/里程碑完成后,需要同步代码和文档到远程仓库


触发条件

  • 重大功能完成(如 MVP v1.0
  • 里程碑文档创建完成
  • 需要备份/共享项目文档

同步流程

步骤 1: 代码和里程碑文档 → 远程仓库

# 进入项目目录
cd <项目目录>

# 查看未跟踪文件
git status

# 添加里程碑文档和关键代码
git add milestone/ <其他关键文件>

# 提交
git commit -m "feat: <版本> <功能描述>

- <成果1>
- <成果2>"

# 推送到远程仓库
git push origin <分支>

步骤 2: 核心文档 → 文档库(可选)

如有独立的文档仓库,同步核心 .md 文档:

# 进入文档库
cd <文档库目录>

# 复制核心文档
cp -r <项目目录>/milestone/ <文档库目录>/<项目名>/

# 提交
git add <项目名>/
git commit -m "feat: 添加 <项目名> <版本> 里程碑文档"
git push origin main

注意事项

  1. 先主仓库后文档库 — 确保代码和文档先在版本控制中
  2. 选择性同步 — 文档库只同步核心 .md 文档,不同步二进制/大文件
  3. milestone 命名 — 格式 YYYY-MM-DD-v<版本>-<标签>