一次任务的全过程
从发起任务到验证、采纳或退回的全过程,以及任务与结果记录。
一次任务的全过程
1. 发起
任务可以来自一个需求或缺陷、一次 CI 失败、一个合并请求(评审它)、另一个任务的结果(交叉评审),或者开发者直接输入的目标。类型有三种:「代码变更」(修缺陷、做需求、补测试、修 CI)、「评审」(评审合并请求)和「分析」(排查问题、影响面分析、方案调研)。发起需要研发项目的写授权。
助手会先和开发者确认项目、类型、目标和验证命令,开发者明确同意后才发起,不会因为聊天里一句「看起来不错」就动手。几个要点:
- 工作区:默认在本机仓库的一个独立 git 工作区里做,分支名是
nexus/<任务编号>,不动开发者自己的分支和未提交的文件,可以并行。开发者也可以选直接在目录里改。本机没有这个仓库时,客户端先克隆。 - 验证命令:默认从仓库根目录的文件自动识别,发起时可以改,本机会记住每个仓库上次改后的命令。识别规则见下表。
- 本机任务:不属于任何研发项目的任务也可以交给工具,不需要授权,结果只留在本机,不能采纳为合并请求。
- 项目注意事项:任务说明会提醒工具先读仓库里的
AGENTS.md或CLAUDE.md。
| 仓库里有 | 识别出的验证命令 |
|---|---|
package.json | 按锁文件选 pnpm、yarn、bun 或 npm,依次运行 scripts 里存在的 lint、typecheck、test。三者都没有时运行 build。 |
pom.xml | ./mvnw -q verify,没有 mvnw 时用 mvn -q verify。 |
build.gradle | ./gradlew check,没有 gradlew 时用 gradle check。 |
go.mod | go build ./... 和 go test ./...。 |
pyproject.toml 等 | pytest。有 uv.lock 用 uv run pytest,有 poetry.lock 用 poetry run pytest。 |
Cargo.toml、*.sln 或 *.csproj、Makefile | cargo test、dotnet test,以及 Makefile 里的 make test(Makefile 含 test: 目标,且前面都没识别到时才使用)。 |
一个仓库识别出多种类型时,各自的命令都会运行。识别不到时没有验证命令。Node(pnpm)、Maven、Go 和 Python 四类仓库的识别和执行,已经用真实工具验证过。
2. 工具读取上下文
客户端启动工具会话时,为它挂载研枢的 MCP 服务 nexus-engineering。工具通过它主动读需求、缺陷、迭代进度、合并请求和 CI 日志,不需要 Nexus 预先把内容塞给它。会话用的是一个短期的只读令牌:只覆盖本任务所在的研发项目,读不到其他项目,看不到回报结果用的 task_report,任务离开「进行中」后失效,最长 12 小时。工具拿不到开发者自己的 Key。
工具执行中的权限请求,按工具自己的权限设置处理。需要确认的由客户端原样转给开发者,只能由开发者自己回答(/nexus dev task answer),Nexus 和助手都不会代答。ACP 工具声明了会话模式时(例如 Claude Code 的 Accept edits,Codex 的 Workspace access),发起时可以选,按工作区记住。跳过全部确认的模式可以为单个任务选用,会给出警告,不会记成默认。选哪个模式由开发者权衡,Nexus 不另加规则。
3. 客户端独立验证,给出初步判定
工具说完成了不等于真的完成了。工具结束后,Nexus 助手在同一个工作区里自己执行 git diff 和 git log 收集变更,并依次运行验证命令,不只依赖工具的自述。然后给出初步判定,只供参考,不会自动采纳:
| 判定 | 条件 |
|---|---|
| 通过 | 正常完成,有变更(变更任务)或有报告(评审、分析任务)。变更任务还要求有验证命令,并且全部通过。 |
| 未通过 | 验证命令失败、超时或无法运行,或工具出错、超时。 |
| 需要人看 | 没有任何变更;评审、分析任务没有报告;变更任务没有验证命令;工具自述有未完成事项;改动超过 50 个文件;工具要求人介入;会话被取消;IDE 里的工具自己回报的结果,在客户端独立验证之前。 |
结果进入「待验收」。开发者可以在本机看变更摘要和完整差异(/nexus dev task <任务编号> diff),也可以在 IDE 里打开工作区。服务端只保存摘要、变更统计、验证与 CI 结果和合并请求链接,完整差异和过程记录只在本机。
4. 采纳前的两项检查
- 冲突预检:结果进入待验收时,以及采纳推送前,客户端在本机把任务分支试合并到目标分支,不动工作区和分支,批量采纳时依次叠加,能报出两个任务之间的冲突。有冲突只提示,不阻止采纳,也不改初步判定。开发者可以选择带着冲突文件退回重做,任务说明会写明目标分支和冲突文件,要求在任务分支上合入目标分支并解决冲突。冲突解决得对不对,仍由开发者判断。
- 交叉评审:对待验收的代码变更,可以交给另一个工具评审。评审在只读的临时工作区里进行,结论是「无阻塞问题」「有阻塞问题」或「未给出结论」,与初步判定并排显示,不改判定,不自动退回,也不能单独采纳。本机只有一个工具时,用同一工具另开会话并注明。被评审的任务采纳或退回时,评审随之结束,采纳时合并请求描述里只附一行评审结论。
5. 人来决定
| 操作 | 效果 |
|---|---|
| 采纳 | 变更任务:用开发者自己的 git 凭据把分支推送到所选远程仓库(可以是个人 fork,合并请求从 fork 发往主仓库),由研枢创建合并请求,描述里写明任务、工具、关联的工作项和验证结果,同时在需求或缺陷上评论结果摘要。同一任务分支上已有打开的合并请求时,沿用它,只在上面评论新结果,记录里标「沿用已有的合并请求」。可以选择改工作项状态(禅道缺陷可以标为已解决,也可以关闭)、创建草稿合并请求、不在工作项上评论。评审任务:意见写成合并请求的评论。分析任务:报告保存在任务里。几个「通过」的结果可以勾选后一起采纳,各自生成合并请求。 |
| 退回重做 | 带上开发者的意见和失败的验证输出,让工具继续。支持的工具在原会话里继续,不支持的开新会话并附上次的结果。 |
| 换工具重做 | 用另一个工具新建任务,附上次的结果和失败原因。 |
| 自己接手 | 在 IDE 里打开工作区,人工修改后点「完成」,客户端重新验证,再采纳。 |
| 放弃 | 清理本机工作区和本地分支。 |
合并请求和评论由模块经研发系统的服务账号创建,并注明是哪位同事经 Nexus 创建的。有写授权的人可以采纳、退回、放弃该研发项目里任何人发起的任务,不限发起人。
6. 采纳之后
- CI:合并请求创建后,CI 结果会补充到任务里。CI 失败时任务回到「待验收」,可以退回重做。合并请求已合入之后,CI 失败只记录,不再让任务回去。
- 合并请求的结局:研枢只读地读回合并请求的结局,在「已采纳」下显示「待合入」「已合入」或「已关闭未合入」。读回靠 Webhook 触发,另有约 10 分钟一次的轮询兜底。采纳满 30 天仍未合入的,不再跟踪。研枢不合入、不审批、不关闭合并请求,评审和合入由上游的规则决定。
- 整理项目注意事项:同一个研发项目在上次整理之后累计 3 个问题任务(被退回、被放弃、CI 失败、验证未通过、交叉评审指出阻塞问题)时,客户端提示一次「可以整理注意事项」。整理是一个普通的代码变更任务,只修改仓库根目录的
AGENTS.md或CLAUDE.md,改了其他文件会判为「需要人看」,照常验证、采纳为合并请求、由上游评审。Nexus 不保存注意事项本身。要留意的一点:一次性的验证命令可能被工具当成项目惯例写进规则,评审合并请求时请留意。
任务与结果记录
「研发(研枢) › 任务与结果记录」是服务端保存的记录,只读。可以按关键字、研发项目编码和状态(进行中、待验收、已采纳、已退回、已放弃)筛选。列表显示任务、研发项目、类型与工具、状态、初步判定、合并请求和发起人。点开一个任务,详情分这几块:
- 概要:任务编号、研发项目、类型、来源、关联工作项、所用工具及调用方式、代码仓库、工作区分支、发起人和时间。
- 执行结果:结束情况、初步判定及理由、回报方、实际变更(提交和文件增删行数)、工具自述、未完成事项、假设和建议的下一步、验证命令的结果(通过、失败、超时、出错,含耗时和退出码)。
- 交叉评审:评审任务、评审工具、结论、意见条数、状态。
- 采纳:采纳人和时间、合并请求及其结局、合并请求评论数、各工作项的写入结果。
- 合并请求的 CI:状态和各条流水线的结果。
- 经过:任务状态变化的时间线。
本机任务不在这里列出,要在客户端「Nexus 管理 › 研枢」里看。