分支、同步方向与里程碑治理¶
- 沉淀时间：2026-09-09
- 来源：
branch-strategy.md与 2026-09-09 全分支审计 - 成熟度：
provisional - 适用范围：稳定主线与高风险横切实验需要并行演进的仓库
先区分改动形态¶
| 类型 | 特征 | 合并策略 |
|---|---|---|
| 垂直模块 | 新增独立目录，少改公共入口 | 可并行进入稳定开发主线 |
| 横切改造 | 修改公共 Skill、共享状态或执行语义 | 串行进入对应轨道，每个改造基于上一个已合入点 |
| 实验性横切改造 | 风险高、需要多次校准、可能影响所有用户 | 隔离到实验轨，成熟后单独 backport |
双轨条件¶
只有在实验改造需要持续存在、且不能短期通过 feature branch 完成时，才建立稳定轨和实验轨。同步方向保持单向：稳定轨的新垂直模块可以进入实验轨；实验轨不能整体反向污染稳定轨。
develop（稳定轨） ──周期性同步──→ experiment（实验轨）
↑ │
垂直模块 └─成熟能力另开 backport
里程碑 tag 固定实验起点和可回退点。Tag 必须对应已验证提交，不能把一个会持续移动的分支当作回溯基线。
治理门禁¶
- 分支必须能追溯到 Issue；PR 标明目标轨道和改动形态。
- feature branch 不长期承担主线职责。
- 每次里程碑前，实验轨先同步稳定轨并解决冲突。
- 分支文档标明来源提交和成熟度，未合入内容不能伪装成主线现状。
- 本地独有提交、远端独有提交和已合入内容分别统计。
- 分支删除或归档只在归属、合入和回溯需求明确后进行。
现实审计带来的修正¶
原方案规划 develop-short 和 baseline-long-context-v1，实际仓库只有停在旧提交的 origin/feature/short-context，且没有规划 tag。这说明策略文档本身不能证明策略已执行。看板必须同时显示“目标结构”和“实际 Git 引用”，偏差进入待办。
反模式¶
- 用分支名推断是否已合入或已验收。
- PR 合并后继续在同一分支追加提交，却不新开 PR。
- 多个横切改造并行修改同一批 Skill 文件。
- 实验轨长期不吸收稳定主线，最终无法收敛。
- 计划中写了 tag 和主轨，但从不检查 Git 中是否存在。
限制¶
本仓的双轨方案尚未实际落地，因此本条目确认的是决策方法和审计门禁，具体分支名、同步频率及是否继续双轨仍待项目维护者决定。