用途:把代码库转成提交计划(commit plan)。它先画出模块及其依赖方向的导航图,再把代码拆成一串提交,使每个提交都能构建且测试通过。最终输出是一个文件,列出 #1 到 #N 的提交,每条含提交消息和确切文件集。全过程不执行提交、不推送,也不写入被分析的仓库。
主要能力:以只读方式在临时克隆或临时工作树中操作;建立覆盖证明,确保每个受跟踪路径恰好落入一个提交(用 git ls-files 做集合运算验证);按依赖图确定提交顺序(叶子在前、深度即顺序、循环依赖成员必须同属一个提交);在临时分支上按计划逐个提交并运行仓库自身的构建与测试命令,形成“门禁阶梯”(每个门禁从第几个提交开始通过);按仓库自身约定生成提交消息。
使用方式:命令为 /awesome-commit-plan <repository-url-or-path> [--out <file>] [--commits N] [--granularity coarse|default|fine] [--verify full|build|off] [--strategy layered|vertical|manual] [--slice on|off]。仓库地址或路径必填;缺少时应先询问,不能从当前工作目录猜测。运行前检查 git --version 与仓库自身工具链,并检测平台以选择 shell(bash 代码块为 POSIX shell,Windows 上需在 Git Bash 中运行)。流程分阶段:确定目标与工作区、读取提交消息规则、构建导航图、应用可二分性规则、拆分、验证阶梯、撰写消息。
适用场景与限制:适用于需要审查式、可回溯的提交拆分(分层、纵向或手工策略)与历史重建前准备。限制包括:不提交、不推送、不修改用户检出;无法运行的门禁记为不可用而非通过;若在 --verify off 下运行,计划标记为未验证且不使用 bisectable 一词;存在既有构建失败时只能如实报告,无法由拆分修复;未分配路径或重复分配均为停止条件。费用、价格与平台支持等资料暂未提供。