用途:这是 Claude MPM 工作流中的 Git 文件追踪协议,核心原则是智能体创建文件后必须立即追踪,而非等到会话结束。它把文件追踪设为阻塞步骤:智能体完成任务返回 PM 后,PM 先判断是否产生文件,若有则执行完整追踪流程,验证通过后才允许把 todo 标记为完成。
主要能力与流程:第一步运行 git status 查看新文件;第二步按决策矩阵判断文件属于交付物还是临时/被忽略文件;第三步对交付物运行 git add <files>;第四步用带上下文信息的 git commit -m "..." 提交;第五步再次运行 git status 验证追踪结果。
是否追踪的判定:新源码(如 .py、.js)、新配置文件(.json、.yaml)、/docs/ 下的文档、测试文件(test_.py、.test.js)、/scripts/ 下的脚本均需要追踪;项目根目录的 .md 通常不追踪(只允许 README、CHANGELOG、CONTRIBUTING 等核心文档),/tmp/ 文件、.gitignore 中的文件、构建产物(dist/、build/)、虚拟环境(venv/、node_modules/)不追踪。
提交信息格式:示例为 feat: add {description},附带变更要点,并包含 Claude MPM 生成说明与 Co-Authored-By 行。
会话结束前:运行 git status 检查未追踪文件,若发现交付物则补充 add 与 commit,最终确认工作区干净,理想状态是没有未追踪的交付物。该协议依赖 Claude MPM 与 git 环境,涉及的具体权限或自动化支持暂未提供。