| | |
|---|
| | | # Apptag Project Rules |
|---|
| | | |
|---|
| | | 本项目 Hermes 必须严格遵守的规则 |
|---|
| | | |
|---|
| | | ## 版本管理 & 需求记录铁律（每次任务都必须执行） |
|---|
| | | |
|---|
| | | 1. 任何修改文件前，必须先执行 checkpoint： |
|---|
| | | git add -A && git commit -m "checkpoint: [本次任务简要描述]" |
|---|
| | | |
|---|
| | | 2. 任务完成后，**必须**更新 DECISIONS.md： |
|---|
| | | - 在文件最顶部追加一节新内容（使用当前日期） |
|---|
| | | - 格式必须严格遵守下面的模板 |
|---|
| | | |
|---|
| | | 3. 最后执行正式 commit： |
|---|
| | | git add DECISIONS.md .hermes.md && git commit -m "docs: 更新 DECISIONS.md [任务描述]" |
|---|
| | | |
|---|
| | | 4. 如果是重大功能，自动推送 GitHub PR（可选） |
|---|
| | | |
|---|
| | | ## DECISIONS.md 记录模板（必须完全按照这个格式） |
|---|
| | | ## 上下文管理规则 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | ## [YYYY-MM-DD] 任务标题 |
|---|
| | | **需求来源**：（你当时说的原话或简要描述） |
|---|
| | | **决策理由**：（为什么这么实现，有什么取舍） |
|---|
| | | **实现内容**：（做了哪些改动） |
|---|
| | | **影响文件**：（列出修改的文件） |
|---|
| | | **回滚命令**：git revert <本次commit-hash> 或 git checkout <上一个checkpoint> |
|---|
| | | **测试命令**：（如果有） |
|---|
| | | ``` |
|---|
| | | - 每完成 5 个任务后，自动执行一次上下文压缩 |
|---|
| | | - 压缩完成后，在 DECISIONS.md 里新增一节 “压缩摘要” |
|---|
| | | |
|---|
| | | 此文件由 Hermes 自动维护，请勿手动删除历史记录。 |
|---|
| | | |
|---|
| | | ## |
|---|
| | | |
|---|
