| | |
|---|
| | | # Apptag Project Rules |
|---|
| | | |
|---|
| | | ## Checkpoint workflow |
|---|
| | | 本项目 Hermes 必须严格遵守的规则 |
|---|
| | | |
|---|
| | | 每次开始任务前：`git status` 检查当前状态。 |
|---|
| | | ## 版本管理 & 需求记录铁律（每次任务都必须执行） |
|---|
| | | |
|---|
| | | 每次完成一个独立的功能或修复后，做一次 checkpoint commit： |
|---|
| | | 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（可选） |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | git add -A && git commit -m "checkpoint: <简短描述>" |
|---|
| | | ``` |
|---|
| | | ## 上下文管理规则 |
|---|
| | | |
|---|
| | | 任何时候用户可以喊：**"rollback to last checkpoint"** — 执行 `git reset --hard HEAD~1` 回滚到上一个 commit。 |
|---|
| | | - 每完成 5 个任务后，自动执行一次上下文压缩 |
|---|
| | | - 压缩完成后，在 DECISIONS.md 里新增一节 “压缩摘要” |
|---|
| | | |
|---|
| | | ## 恢复已删除的 checkpoint |
|---|
| | | ## |
|---|
| | | |
|---|
| | | 如果用户后悔回滚了，可以用 `git reflog` 找回被丢弃的 commit，然后 `git reset --hard <hash>` 恢复。 |
|---|
