AC Commit Manager 用于在自主编码过程中管理 Git 提交,主要场景是每个功能实现完成后创建结构良好的提交,以保证版本控制规范和项目历史清晰。
用途 在功能完成后创建结构化的 Git 提交,确保版本控制正确、项目历史清晰。
主要能力
- 提交工作流:依次执行校验(确保变更可安全提交)、暂存相关文件、生成描述性提交信息、创建提交、验证提交已创建,以及可选的里程碑打标签。
- 提交信息格式:采用类似 feat(auth): implement user registration (#auth-001) 的格式,并附带变更要点、测试与覆盖率信息、功能编号和状态。
- 提交结果:返回包含成功状态、提交哈希、功能 ID、提交信息、变更文件列表以及插入/删除/文件数统计的 JSON 结果。
- 提交类别:根据功能类别使用 feat、fix、refactor、test、docs、chore、perf 等前缀。
- 提交前检查:通过 pre_commit_check 校验,检查项包括无未提交的敏感文件、所有测试通过、代码检查通过、无合并冲突。
- 原子提交:每个功能对应一个提交,包含实现与测试,自包含且可回滚,提交信息带有上下文。
- 回滚支持:可回滚最近一次提交,或回滚到指定功能。
- 配置项:可设置是否要求测试通过、是否要求代码检查通过、是否自动暂存测试、提交信息模板、受保护文件列表以及是否签名提交。
使用方式 通过脚本导入 CommitManager: from scripts.commit_manager import CommitManager manager = CommitManager(project_dir) result = await manager.commit_feature("auth-001")
提交前可先运行校验: validation = await manager.pre_commit_check() if validation.can_commit: await manager.commit_feature(feature_id)
回滚示例: await manager.rollback_last_commit() await manager.rollback_to_feature("auth-003")
集成关系 使用 ac-code-validator 进行提交前检查;输入来自 ac-task-executor 的已完成功能;将提交信息更新到 ac-state-tracker。完整实现参见 scripts/commit_manager.py。
适用场景 适用于自主编码流程中需要按功能粒度提交、保持提交历史清晰、并在提交前执行测试与代码检查的场景。
限制 资料未提供关于平台支持、收费方式、价格、具体效果或性能的说明;这些信息暂未提供。