助手能做什么与授权
研枢向助手开放的操作,以及研发项目怎样授权。
AI 助手能做什么
下面是研枢向 Agent 开放的操作。授权名是 read 或 write,都授在研发项目上。研枢没有 Nexus 审批页上的审批档位。发起、退回、放弃和采纳这几个写操作,平台本身不强制人确认,助手规则要求用户明确要求后才调用。
| 操作 | 做什么 | 授权 | 助手的做法 |
|---|---|---|---|
project.list、project.get | 列出有读授权的研发项目,按编码读取项目及其绑定。 | read | 无需确认 |
project.docs | 读项目绑定的相关文档范围,供 docs_search 使用。 | read | 无需确认 |
issue.search、issue.get | 查询需求和缺陷,读详情(描述、验收标准、附件链接、评论、关联编号)。 | read | 无需确认 |
iteration.progress | 迭代进度:按状态和类型统计,完成比例,逾期、阻塞和无人处理的事项。 | read | 无需确认 |
my_items | 指派给我的未关闭需求与缺陷。 | read | 无需确认 |
trace | 需求或缺陷关联的合并请求、提交、流水线和 AI 编程任务。 | read | 无需确认 |
mr.search、mr.get | 查询合并请求,读详情和评审意见。 | read | 无需确认 |
pipeline.status、pipeline.log | CI 状态;失败作业的日志尾部,默认 32 KiB,已去掉颜色控制符。 | read | 无需确认 |
task.list、task.get | 读任务列表和一个任务的说明、结果、判定、采纳写入和 CI。 | read | 无需确认 |
task.mine | IDE 领取:列出我发起、等 IDE 完成的任务。 | read | 无需确认 |
task.lessons | 整理注意事项的材料:上次整理之后的问题任务,含标题、命令与状态、判定原因、开发者的退回意见和阻塞评审意见,不含命令输出。 | read | 无需确认 |
hint.list、hint.ack | 列出可交给 AI 的提示;把提示标为已处理,只对自己生效。 | read | 无需确认 |
task.create | 发起 AI 编程任务。 | write | 平台不强制确认;助手规则要求用户明确要求后才调用 |
task.report | 回报结果:结束情况、自述、变更统计、验证结果,由客户端或 IDE 里的 Agent 调用。 | write | 无需确认,由客户端或 IDE 里的 Agent 调用 |
task.rework | 退回重做或换工具重做。 | write | 平台不强制确认;助手规则要求用户明确要求后才调用 |
task.abandon | 放弃进行中或待验收的任务。 | write | 平台不强制确认;助手规则要求用户明确要求后才调用 |
task.adopt | 采纳结果:创建合并请求、评论工作项、可改状态。 | write | 平台不强制确认;助手规则要求用户明确要求后才调用 |
在 MCP 服务 nexus-engineering 里,对应的工具是 issue_search、issue_get、iteration_progress、my_items、trace、mr_search、mr_get、pipeline_status、pipeline_log,以及 IDE 领取用的 task_list_mine、task_get、task_report。知汇已安装并授权、项目也绑定了相关文档时,还会多一个 docs_search。工具会话的令牌只能用其中的读上下文工具。
「指派给我」按人员目录里登记的外部 ID 对应上游账号。在「组织 › 组织架构」里打开人员,在「外部 ID」里每行写一个「体系编码:账号」,例如 gitlab:zhangsan。体系编码默认是 gitlab、github、gitee、zentao、yunxiao。GitHub 和 Gitee 登记的是登录名,云效登记的是 24 位的云效用户 ID,不是登录名或邮箱。
授权到多细
研枢的授权只到研发项目一级,不能细分到仓库、分支或任务类型。可以授给 Agent、人员、岗位角色和单位,继承规则与其他模块相同,见授权、审批与审计。动作只有两个:
| 动作 | 界面上的名称 | 含义 |
|---|---|---|
read | 读研发数据 | 读取该研发项目的需求、缺陷、迭代、合并请求、CI 状态,以及任务与结果。 |
write | 发起任务与采纳 | 在该研发项目中发起 AI 编程任务,采纳结果,即创建合并请求、在需求和缺陷上评论或改状态。 |
配置位置是「接入中心 › 授权管理」,模块选研枢,资源是研发项目。也可以在「研枢」面板右上角的「更多」菜单里点「授权管理(研发项目的授权)」直接跳过去。只有读授权的 Agent 不能发起任务,也不能采纳结果。归档项目保留授权,但 Agent 看不到它。
合入由上游系统自己的规则决定,例如分支保护和合并请求审批。研枢不另设审批,也不代替上游审批。