Skip to content

任务提交与归档 ​

文档导航 · 写入范围 · 任务执行

Git 仓库的正常收尾顺序为:实施、适用检查、核对验收、确认提交内容、提交、用户要求归档。选择自行提交时保留当前任务,提交后再继续归档。检查成功或智能体说“完成”都不能代替提交。

使用 ​

用自然语言要求“检查并提交当前任务改动”,智能体会调用以下工具。工具不是终端命令。

ts
wenext_commit({ action: "status" })
wenext_commit({ action: "commit", message: "fix: 修复计数", files: ["src/counter.ts", "test/counter.test.ts"] })

status 返回任务待提交文件、外部文件、当前 HEAD 和基线以来观测到的提交;观察到的提交不代表全部由当前任务产生。提交必须使用精确文件路径,不接受目录、通配符或 git add -A。智能体按实际改动拆分逻辑提交,经过真实界面确认后执行。没有交互预览能力时由用户自行提交。

提交前预览 ​

确认区默认只显示简短提交说明、文件数量和文本增删行数。增删行数来自文本 diff,二进制文件计入文件数量。默认选中“查看完整详情”,直接回车只打开预览。

  • 用 ↑↓ 选择“查看完整详情”“确认提交”或“取消,返回对话”,Enter 执行所选操作。
  • 详情包含完整提交说明、文件清单和 diff;用 ↑↓ 滚动,PgUp / PgDn 翻页,Home / End 跳到首尾。Enter 返回摘要,不会提交。
  • 摘要和详情中均可按 Esc 取消整个提交并返回对话,恢复输入草稿;查看详情不等于批准提交。
  • 预览随终端尺寸调整,详情最多显示 20 行,并为其它界面内容保留空间。窗口小于 36 列或 12 行时暂停确认,只能取消或放大窗口后继续。

长说明、路径和 diff 不再直接铺入普通确认框。摘要会缩略,完整内容仍可在详情中查看;显示时过滤终端控制序列,不修改实际提交内容。取消不改变真实暂存区或 HEAD。

提交保护 ​

  • 文件必须属于当前任务已解决的写入范围,且仍有 Git 可见改动;待决归属、历史冲突、撤销的审查或过期方案会阻止提交。
  • 任务开始时已有未提交内容的文件,即使后来纳入任务,也须手动拆分和提交;不能因为路径相同就把用户原有修改一起提交。
  • 检查整个暂存区。存在本次清单之外的暂存内容时拒绝操作并保留原状,不自动取消暂存、不把其它修改顺带提交。
  • 确认后再次核验任务绑定、审查、文件内容、HEAD 和暂存区;变化后必须重新审阅。取消不执行暂存或提交。
  • 使用独立临时索引,持有真实索引锁与项目写入租约;普通提交失败保留原暂存区和 HEAD。正常 Git 钩子继续运行。若钩子或并发操作已产生提交但最终核验失败,明确报告现有提交,要求检查,不能自动重试。
  • 成功后记录 <task>/commits/<hash>.json 与范围事件;不自动 push、amend 或归档。

工具要求从 Git 仓库根目录启动。若项目根是仓库子目录,用户需从仓库根手动提交;不猜测兄弟项目的范围。单次最多 1000 个文件、diff 最多 256000 字符,超出应拆分提交。

活动任务中常见的 Shell git add/git commit 会被拦截并提示使用工具;该判断不是完整 Shell 解析器,也不能隔离任意脚本、扩展或 Git 钩子。它保护受控入口,不宣称提供操作系统级安全隔离。

完成条件 ​

wenext_finish 及底层完成接口均检查任务的 Git 未提交内容,无关外部文件可保持未提交。归档过程中新增的仓库规范也必须先提交。人工提交后,若范围提示历史发生变化,先按现有范围流程确认实际历史,再归档。

非 Git 目录和无任务改动的分析任务不要求空提交。任务原来有 Git、后来无法读取 Git 状态时明确阻断,不能视为非 Git 豁免。失败或阻塞归档也保留这道门禁,失败代码是否提交仍由用户决定。

提交会改变质量输入中的 Git 历史;旧检查指纹失效时按现有规则重新检查,不能把旧证据改写成新检查成功。