tomevault-io Git 管理规范
目标
在阶段性交付和大改动场景下，确保代码始终可回滚、可追溯、可交接。
触发条件
满足以下任一条件时调用本技能：
- 已形成阶段性成果（功能跑通、Bug 闭环、文档更新自洽）。
- 准备进行大改动（跨模块重构、批量文件改动、核心链路调整）。
执行流程
1) 阶段性成果提交
git add -A
git commit -m "<type>: <milestone-summary>"
要求：
- 提交信息必须表达业务结果，不只写技术动作。
- 一次提交只聚焦一个目标，避免混合无关内容。
提交后立即获取锚点：
git rev-parse --abbrev-ref HEAD
git rev-parse --short HEAD
2) 大改动前保护点
至少执行一项，建议两项都执行：
git branch backup/<date>-<topic>
git tag -a checkpoint/<date>-<topic> -m "before large change"
3) 大改动中提交节奏
- 每完成一个可验证子目标即提交一次。
- 避免“超大单提交”，降低回滚与定位成本。
4) 回写开发日志（必做）
- 将本轮
branch / commit / tag / backup branch回写到对应docs/dev_logs/...日志的“Git 锚点”章节。 - 若本轮未提交，写明
commit: N/A与原因，保证后续追溯链不丢失。
质量门禁
提交到主开发分支前必须通过：
bash scripts/check_errors.sh
若涉及测试变更，补充：
cd web && npm run test
禁止行为
- 无备份点直接执行破坏性改动。
- 多个无关目标混入同一次提交。
- 跳过开发日志
docs/dev_logs直接结束任务。
Converted and distributed by TomeVault — claim your Tome and manage your conversions.