用途:从当前工作区创建精心撰写的本地提交。不推送、不创建 PR;完整发布流程应使用 ce-commit-push-pr。完成标准是每个逻辑改动都以明确的文件列表和说明结果的提交信息提交,且这些改动在 git status 中干净。工作区干净(无可提交内容)时停止。
主要能力:先收集上下文,每条命令单独作为一次 shell 调用(仅程序与参数),不要用 ;、&&、||、管道、$(...) 或重定向连接,否则在 Windows PowerShell 下会失败;非零退出是需解读的正常状态,而非需压制的失败。上下文命令包括 git status(工作区状态,非 git 仓库则停止)、git diff HEAD(未提交改动)、git branch --show-current(当前分支,空表示分离头指针)、git log --oneline -10(近期信息风格)、git rev-parse --abbrev-ref origin/HEAD(远程默认分支,无 origin/HEAD 时尝试 gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name',否则 main)。默认分支名需去掉 origin/ 前缀,用于判断是否在默认分支。
使用方式:按工作流执行。先收集上下文;若无暂存、修改或未跟踪文件则报告并停止(不要仅凭 git diff HEAD 判断干净,它会漏掉未跟踪文件)。若处于分离头指针或默认分支,则从改动内容创建特性分支(git checkout -b <name>)并重新读取当前分支,不询问。提交约定优先匹配项目已有约定,其次近期日志模式,最后用 conventional commits(type(scope): description);fix/feat 都适用时默认 fix:,用户覆盖优先。若改动文件明显分为不同关注点,可做 2–3 个文件级提交(不用 git add -p),否则一个提交。提交信息主题用祈使句并说明结果而非文件列表,动机或权衡不明显时才写正文;若手头已有计划实现单元 ID,可在括号中追加该单元 U-ID(如 (U3)),跨单元或不清楚时省略。暂存并提交时只暂存指定文件(绝不用 git add -A 或 git add .),尊重 exclude:<paths>,将完整信息写入仓库外文件后分两次调用:git add file1 file2 file3 与 git commit -F <message-file> -- file1 file2 file3。提交命令末尾的路径列表是必需的,否则会带入索引中已有内容。最后用 git status 确认并报告哈希与主题。
适用场景:需要按仓库习惯生成高质量本地提交、拆分逻辑改动、避免误提交已暂存内容时。
限制:仅本地提交,不推送、不创建 PR;不处理计划查找;不提供收费、价格、平台或效果信息(资料未提供)。