tisfeng Git 提交流程
以经范围校验的 staged diff 创建本地提交。只读预览可使用尚未暂存的候选，
但必须标为草稿。<git-commit-skill-dir> 指实际加载的本 Skill 目录。
任务与边界
| 任务 | 结果 |
|---|---|
| 起草或预览 | 根据 staged 内容或获准候选返回草稿，不改变 Git。 |
| 创建提交 | 在有效提交授权下完成范围判断、预览、暂存、提交和校验。 |
| 汇报已有提交 | 读取指定提交或范围的真实消息与统计，不启动新提交。 |
| 为组合 Skill 推导分支名 | 只返回合法候选，不暂存、提交或创建分支。 |
本 Skill 不运行 git push、rebase 或 merge。调用方传入真实任务、允许范围和已有证据，
不需要采用本 Skill 的内部字段。
选择模式
- 只命名或汇报已有提交：只完成该任务；未指定提交对象时先明确对象。
- 仅预览、起草或只读：不暂存、不创建消息文件、不提交。已有 staged 内容时 只用其起草；索引为空时使用获准范围内的候选。
- 确认模式：展示完整预览并等待批准。未单独获准时，确认前不暂存。
- 默认模式：明确调用本 Skill 或宿主已授权自动本地提交时，展示预览后直接提交。
用户的禁止、范围、确认和暂缓要求持续有效；“不提交”不自动授权暂存。
范围与 Git 状态保护
- 记录调用目录，使用
git rev-parse --show-toplevel定位仓库根目录；相对路径先按原调用目录解析。 - 读取 HEAD、分支、status、最近提交、staged/unstaged raw diff 和相关 untracked 内容， 区分用户已有变更与本任务候选。
- 准备写入时复验 HEAD、索引、候选路径和内容。发现冲突、归属不明或非预期漂移时 停止，不覆盖、清理或自动 amend。
- 获准后只执行一次选定的暂存动作，并比较 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 提交。
提交主流程
- 起草提交时读取 提交信息契约。在主对话以
text代码围栏展示 完整、将要使用的消息；仅预览到此结束，确认模式等待批准。 - 完成唯一暂存并复验后，将与预览完全一致的内容写入本任务专用消息文件。 候选或消息变化时重新审核和展示；用户要求确认时不复用旧批准。
- 使用 Skill 内校验器检查消息，再运行
git commit -F <message-file>。 - 以新建完整 commit hash 执行提交后消息一致性校验。校验失败时保留消息文件， 不 amend，不声称交付完成。
- 校验通过后删除本任务消息文件，读取 统计与提交回执，根据 Git 真实结果交付。
仅为 submit-pr 或 worktree-rebase-merge 推导分支名时，读取
分支命名，不进入提交流程。
完成与停止条件
只有范围与 staged raw patch 一致、必要验证通过、Git 真实消息与预览一致，且最终 状态和统计已核对时，才算创建提交完成。范围无法证明、出现冲突或漂移、权限被拒、 提交前/后校验失败、hook 改写结果或统计不一致时保留现场并报告具体阶段， 不自动扩大暂存、重试写入、amend 或清理用户状态。