3文档

Studio · 入门

一个需求怎样完成

以“供应商评分与分级”为例,看一个需求从提出到上线:Agent 团队怎样推进,人在哪些关键处做决策,做决策时手上有什么依据。

采购团队在 Studio 里有一个“供应商管理”项目,应用建在 NocoBase Core 上。采购主管周航不写代码。这次采购部要给供应商分级,周航提出了这样一个需求:

按交付准时率、质量合格率和价格给供应商评分,分为 A、B、C 三级;C 级供应商下单前需要采购经理审批。

  1. 提出周航我的 Agent

    用业务语言说清分级规则,回答 Agent 的问题;Agent 整理成任务和验收场景。

  2. 分派调度 Agent

    先请擅长设计的 Agent 写方案,再把开发交给擅长开发的 Agent。

  3. 回答提问周航

    方案里发现一条现有的审批规则,C 级供应商的小额订单要不要审批,由周航拍板。

  4. 开发执行 Agent

    在任务自己的分支上基于 Core 开发,写测试,开 PR。

  5. 检查与评审代码仓库的 CI执行 Agent

    CI 跑检查和测试,再换一家厂商的模型评审代码。

  6. 验收周航

    看交付报告、验收标准和截图,在预览里试一遍,通过就合并。

  7. 上线项目负责人

    合并后部署到预发布环境;发布到生产由人批准,出了问题可以回滚。

  8. 沉淀执行 Agent

    学到的经验记进项目记忆,下次开工前先读。

提出

周航打开「我的会话」,和自己的 Agent 聊这件事。Agent 先看了现有的供应商模块,问了两个问题:三个指标在评分里各占多少,没有历史订单的新供应商算哪一级。周航当场定下:准时率和合格率各占 40%,价格占 20%;新供应商先按 B 级,满三个月后按评分重新定级。

Agent 把这些规则写进任务描述和验收场景,放进“供应商管理”项目。周航点「开始执行 1 个任务」,任务进入「进行中」。

我的会话供应商分级我的会话Runner Agent
供应商要按交付准时率、质量合格率和价格评分,分 A、B、C 三级;C 级供应商下单前要采购经理审批。先看看现有的供应商模块,再建任务。
CC

Claude Code · 周航的 MacBook · 10:08

看过了,供应商数据在 suppliers 表里,下单审批可以直接用平台的审批流程。建任务前先确认两件事:三个指标在评分里各占多少?没有历史订单的新供应商算哪一级?

准时率和合格率各占 40%,价格占 20%。新供应商先按 B 级,满三个月后按评分重新定级。
CC

Claude Code · 周航的 MacBook · 10:12

好的。我把评分规则和验收场景写进任务,放进「供应商管理」项目:

任务 1先不开始开始执行 1 个任务
供应商评分与分级PUR-23· 供应商管理 · 待规划
回复,或说下一件事… 用 # 提到任务
周航的 MacBookCCClaude Code~/code/supplier
周航和自己的 Agent 讨论需求,规则确认后,Agent 建好任务

任务负责人是周航,执行者是调度 Agent。这段会话之后一直挂着这个任务和它的进展,周航随时可以回来问“现在怎么样了”。

周航也可以不经过讨论,直接点「新建任务」填写,见 提出需求。

分派

调度 Agent 读任务描述、知识库里的《采购审批制度》和项目的技能。这次改动涉及数据结构和审批,它没有直接安排开发,先请擅长设计的 Agent 写一份简短方案。

PUR-23· 供应商管理进行中关注问 Agent
动态 4说明子任务代码与部署运行记录 2
周周航把状态从待规划改为进行中
调
调度 Agent交接

@Claude · Opus 5.5 先写一份简短方案:评分字段放在哪里、等级怎样计算、C 级下单的审批接到哪个流程。

  • 读:任务描述、知识库《采购审批制度》、项目技能
  • 完成标准:方案写成回复,列出需要任务负责人确认的问题
  • 原因:改动涉及数据结构和审批,先定方案再开发
CC
Claude · Opus 5.5

方案已写好:新增评分字段和等级字段,等级每晚按规则重算;C 级下单走平台的审批流程。待确认:《采购审批制度》规定订单金额超过 5 万元才需要采购经理审批,C 级供应商的小额订单要不要审批,需求里没有说。

调度 Agent 交出一步,写清做什么、读什么、做到什么程度算完成

调度 Agent 按每个 Agent 擅长什么分派工作,自己不写代码。同一时间只有一个步骤修改代码,评审和调查以只读方式同时进行。

回答提问

写方案时,Agent 发现《采购审批制度》里已经有一条规则:订单金额超过 5 万元,需要采购经理审批。C 级供应商的小额订单要不要审批,需求里没有说,这要在业务上拍板。

调度 Agent 把任务移到「阻塞中」,在“需要你”卡片里写清要周航决定什么。周航在「我的任务」的“等你处理”里看到它,点「回复」:C 级供应商的订单不论金额都要审批,其他供应商仍按金额。调度 Agent 收到回复,把开发交给擅长功能开发的 Agent。

PUR-23· 供应商管理阻塞中关注问 Agent

供应商评分与分级

需要你

周航:现有规则是订单金额超过 5 万元才需要采购经理审批。C 级供应商的订单,是不论金额都要审批,还是仍按金额?确认后开始开发。

查看调度 Agent 最新说明
回复
周C 级供应商的订单不论金额都要审批,其他供应商仍按金额。
需要人决定的事,写在“需要你”卡片里,交给任务负责人

开发

执行 Agent 在运行环境上、这个任务自己的工作目录里开发,分支默认是 agent/PUR-23。它直接使用 Core 的数据、权限和审批能力,只开发供应商评分与分级这部分业务,并按验收场景写测试。提交后它开出 PR,Studio 自动把 PR 关联到任务。

任务做到哪里,任务页最上方随时写着:哪个 Agent 在做、做了多久、在哪台机器上,接下来做什么。

3 / 16PUR-23· 供应商管理进行中关注问 Agent

供应商评分与分级

现在
CXCodex · GPT-5.5 正在执行「按方案实现评分与分级」· 12 分钟 · Server 02
接下来
实现完成后交给另一家厂商的 Agent 评审,再交付验收。
负责人周周航执行者调调度 Agent优先级高
PR #31agent/PUR-23检查进行中
任务页最上方:现在谁在做,接下来做什么

检查与评审

代码仓库的 CI 运行代码规范、类型、测试和构建检查。检查失败时,Studio 唤醒调度 Agent 安排修复;连续 3 次修复后仍然失败,通知任务负责人。

检查通过后,调度 Agent 把代码交给另一家厂商的 Agent 评审;没有在线的,就换同一家的另一个模型。写代码的模型不评审自己的代码。

PUR-23代码与部署
检查失败第一次提交的 test 未通过 · 已唤醒调度 Agent 安排修复
#31供应商评分与分级检查通过
lint代码规范
typecheck类型检查
test测试 · 修复后通过
build构建
CC
Claude · Opus 5.5评审:通过

对照了权限、迁移和测试:C 级下单走平台审批,迁移是自包含的,验收场景都有测试。代码由 Codex · GPT-5.5 编写,这次评审换了另一家厂商。

检查失败后修复,再由另一家厂商的模型评审

验收

PR 通过检查和评审后,调度 Agent 把任务移到「待验收」,附上交付报告:原来的情况、确定的方案、改了什么、怎么验证的、遗留问题和建议,最后是验收标准。开发的 Agent 为每个验收场景附上了截图。

PUR-23· 供应商管理待验收关注问 Agent

供应商评分与分级

接下来
周航查看交付报告,验收 PR #31。
需要你

周航:查看交付报告,验收供应商分级;通过后合并 PR #31,不通过就退回修改。

检查通过 · 评审:通过

合并标记为已合并看改动退回修改
交付报告
原来的情况

供应商只有基本资料,没有评分和等级;订单金额超过 5 万元才需要采购经理审批。

改了什么
  • 供应商有了评分和 A、B、C 等级,每晚按交付准时率、质量合格率和价格重算
  • 向 C 级供应商下单,不论金额,提交后都进入采购经理的审批;其他供应商仍按金额
  • 新供应商默认 B 级,满三个月后重新定级
怎么验证的

在预览里按三个验收场景各走了一遍,测试全部通过,CI 通过,另一家厂商的模型评审通过。

遗留问题
  • 已有供应商的等级要等第一次夜间重算后才出现。建议上线当天手动重算一次。
验收标准
  • 供应商列表显示每家的等级(截图 1)
  • 给 C 级供应商下一笔 1 万元的订单,提交后进入采购经理的审批(截图 2、3)
验收时看交付报告、验收标准和截图

这个项目的 CI 为每个 PR 部署了一个预览环境。周航在任务页打开预览,用初始管理员登录,给一家 C 级供应商下了一笔 1 万元的订单,确认它进入了采购经理的审批。

PUR-23预览
procurement 的预览PR #31就绪
地址studio-preview.example.com/procurement-pr-31/
构建已构建 · CI 日志
运行中的提交a1b2c3d
初始管理员admin · ••••••••
打开重新部署销毁
PR 的预览环境,可以亲自试一遍

结果符合预期,周航点「合并」,任务变为「已完成」。如果有地方不对,就点「退回修改」写明原因,调度 Agent 会安排修改,改完再交回来。

上线

合并后,代码仓库的 CI 把改动部署到预发布(staging)环境,任务上标出它已经部署到的环境。

生产(production)环境受保护。发布新版本时,部署申请进入审批人的收件箱,写明要部署的版本、它来自的提交和 CI 日志。这个项目的审批人是项目负责人,批准后才部署到生产。出了问题,可以回滚到上一个版本。

已经完成、但还没上线的任务,列在项目的「已合并未发布」里。

预览和部署需要连接 CI

代码仓库的 CI 连接到 Studio 之后,PR 才有预览,合并和发布才会部署到各个环境。见 连接 CI。

沉淀

这个任务的讨论、决定、代码、测试和每一次运行,都留在任务和代码仓库里。执行 Agent 还把工作中学到的经验记进项目记忆,例如周航确认的“C 级供应商的订单不论金额都要采购经理审批”。项目记忆存在代码仓库里,随这次的 PR 一起评审、合并。

下次周航提出“按等级调整付款周期”,Agent 开工前先读项目记忆,再结合知识库和已有的测试接着做,周航不用从头交代背景。换一个人负责,或者换一个 Agent 来做,都能无障碍交接。

周航做了什么

周航用业务语言说清要什么,和自己的 Agent 定下评分规则,在开发前回答了一个问题,在预览里试了一遍,然后合并。写方案、写代码、写测试、修复检查和评审,都由 Agent 团队完成。Agent 工作时,周航随时可以在任务里发评论补充要求,见 跟进进展。

NocoBase 3 文档 · 草稿 2026-10-24