feat(git): 完善 Worktree 生命周期与发布约定
This commit is contained in:
@@ -98,3 +98,14 @@ plugins/<plugin>/skills/<skill>/
|
||||
- 提交前执行 `git status --short`、`git diff --cached --check` 并检查暂存文件清单。
|
||||
- 不提交本地配置、凭据、缓存、运行产物和 IDE 私有状态。
|
||||
- 不使用破坏性历史改写,也不推送,除非用户明确授权。
|
||||
|
||||
## 分支与发布约定
|
||||
|
||||
- 一个完整主题使用一个短生命周期开发分支;分支只包含同一能力闭环,不为凑版本混入无关变更。
|
||||
- 分支命名优先遵循仓库现有约定;没有更具体规则时使用 `feature/<short-name>`、`fix/<short-name>`、`docs/<short-name>` 或 `chore/<short-name>`。
|
||||
- 工作区不干净、当前 checkout 被 IDE/服务/测试占用,或用户要求不影响主工作区时,使用独立 Worktree。分支任务完成后必须通过安全清理门禁移除额外 Worktree,保留分支和提交。
|
||||
- 已验证的开发分支合入 `master` 后,先在 `CHANGELOG.md` 的 `Unreleased` 累计;形成一组相关、完整、可交付的能力后再发布,不因每次普通修改单独发版。
|
||||
- 阻断性缺陷、安全问题或已发布能力的明确回归可以单独发布修订版本;不得为等待批次延迟必要修复。
|
||||
- 仓库整体版本遵循 SemVer:不兼容变化升级主版本,向后兼容的新能力升级次版本,向后兼容的问题修复升级修订版本。
|
||||
- `dev`、`doc`、`git`、`knowledge` 和 `skill` 插件清单版本按实际变化独立维护;修改某个插件的可见能力时同步评估其 `plugin.json` 版本。
|
||||
- 发布前必须确认工作区、发布范围、版本号、验证证据、`CHANGELOG.md`、插件清单版本、标签目标和远程地址。版本提交、标签和推送分别按用户授权执行。
|
||||
|
||||
Reference in New Issue
Block a user