git-commit

Git 提交流程

以经范围校验的 staged diff 创建本地提交。只读预览可使用尚未暂存的候选， 但必须标为草稿。<git-commit-skill-dir> 指实际加载的本 Skill 目录。

任务与边界

任务	结果
起草或预览	根据 staged 内容或获准候选返回草稿，不改变 Git。
创建提交	在有效提交授权下完成范围判断、预览、暂存、提交和校验。
汇报已有提交	读取指定提交或范围的真实消息与统计，不启动新提交。
为组合 Skill 推导分支名	只返回合法候选，不暂存、提交或创建分支。

本 Skill 不运行 git push、rebase 或 merge。调用方传入真实任务、允许范围和已有证据， 不需要采用本 Skill 的内部字段。

选择模式

• 只命名或汇报已有提交：只完成该任务；未指定提交对象时先明确对象。
• 仅预览、起草或只读：不暂存、不创建消息文件、不提交。已有 staged 内容时 只用其起草；索引为空时使用获准范围内的候选。
• 确认模式：展示完整预览并等待批准。未单独获准时，确认前不暂存。
• 默认模式：明确调用本 Skill 或宿主已授权自动本地提交时，展示预览后直接提交。

用户的禁止、范围、确认和暂缓要求持续有效；“不提交”不自动授权暂存。

范围与 Git 状态保护

1. 记录调用目录，使用 git rev-parse --show-toplevel 定位仓库根目录；相对路径先按原调用目录解析。
2. 读取 HEAD、分支、status、最近提交、staged/unstaged raw diff 和相关 untracked 内容， 区分用户已有变更与本任务候选。
3. 准备写入时复验 HEAD、索引、候选路径和内容。发现冲突、归属不明或非预期漂移时 停止，不覆盖、清理或自动 amend。
4. 获准后只执行一次选定的暂存动作，并比较 staged paths 与 raw patch 是否与候选完全一致。 不一致时停止，不通过第二次 git add 修正范围；不创建空提交。

情况	暂存动作
已有索引	不运行 git add，只提交既有 staged 内容；超出请求范围时停止。
显式交付、空索引、限定路径	一次 git add -- <selected-paths>。
显式交付、空索引、未限定路径	未禁止暂存且非 staged-only 时，在仓库根目录一次 git add .。
宿主授权自动提交	一次 git add -- <expected-commit-paths>，禁止 git add .。

宿主自动提交还必须有首次写入前的 HEAD、初始 Git 状态、允许路径和内容归属证据。 初始索引非空、唯一暂存前出现非 Agent staged 内容、验证失败或仍有暂缓要求时， 停止自动提交。这不反向限制用户已明确授权的 staged-only 提交。

提交主流程

1. 起草提交时读取 提交信息契约。在主对话以 text 代码围栏展示 完整、将要使用的消息；仅预览到此结束，确认模式等待批准。
2. 完成唯一暂存并复验后，将与预览完全一致的内容写入本任务专用消息文件。 候选或消息变化时重新审核和展示；用户要求确认时不复用旧批准。
3. 使用 Skill 内校验器检查消息，再运行 git commit -F <message-file>。
4. 以新建完整 commit hash 执行提交后消息一致性校验。校验失败时保留消息文件， 不 amend，不声称交付完成。
5. 校验通过后删除本任务消息文件，读取 统计与提交回执，根据 Git 真实结果交付。

任何技能或 Agent 需要拟定、分类或校验分支名称时，读取 统一分支命名 并使用其中工具，不进入提交流程。

完成与停止条件

只有范围与 staged raw patch 一致、必要验证通过、Git 真实消息与预览一致，且最终 状态和统计已核对时，才算创建提交完成。范围无法证明、出现冲突或漂移、权限被拒、 提交前/后校验失败、hook 改写结果或统计不一致时保留现场并报告具体阶段， 不自动扩大暂存、重试写入、amend 或清理用户状态。