TTMusic/openspec/changes/improve-git-collaboration-workflow/proposal.md

Why

当前项目缺少统一、可执行的 Git 协作规范，导致 git pull 后频繁出现可避免冲突，以及本地未提交文件被覆盖或误处理。需要尽快建立分支、同步、提交与冲突处理的标准流程，降低协作成本并提升代码安全性。

What Changes

• 新增团队级 Git 协作与同步规范，覆盖分支命名、日常同步、提交与推送、冲突处理。
• 新增“本地改动保护”机制要求，包括 pull 前检查、stash/临时分支保护策略和高风险命令禁用约定。
• 新增统一的 .gitattributes 与基础忽略策略建议，用于减少跨平台与文本归一化引发的伪冲突。
• 新增仓库内操作手册与故障排查流程，明确遇到冲突、覆盖风险时的标准处置步骤。

Capabilities

New Capabilities

• git-collaboration-policy: 定义团队分支策略、提交规范、同步与合并基线流程。
• local-change-protection: 定义本地改动保护与 pull 前安全检查、回滚与恢复流程。
• conflict-prevention-baseline: 定义减少无效冲突的仓库基线配置（如 .gitattributes 与相关规范）。

Modified Capabilities

• 无

Impact

• 影响代码与文档：doc/ 下新增或更新协作手册，可能新增仓库根目录 .gitattributes 与 .gitignore 规则。
• 影响开发流程：所有开发者的日常 pull/rebase/merge 操作将遵循统一流程。
• 影响 CI/质量门禁：可选接入提交前检查或 PR 模板校验，确保流程落地。
• 对运行时 API 与业务功能无直接破坏性变更。