ChemEngAI产品设计
系统架构
产品与系统设计 · v0.1 草案

Agent 原生项目工作区

文件、MCP、Skills 和资产库如何帮助 Agent 持续完成工程任务。

查看 Markdown

一个 Agent 进入项目后,需要知道什么

目标是什么、当前方案是哪一版、已有证据在哪里、哪些任务可以执行、哪些事情需要人参与,以及上次工作停在哪里。

这些信息来自业务记录和工作区清单。聊天历史只是交互记录之一。

候选文件结构

下面是便于人和 Agent 阅读、交换的工作区示意。它尚未固定为正式文件协议。

project/
  project.yaml          项目身份、工作区版本、当前基准
  briefs/               需求与设计基础的可读快照
  research/             问题、假设、下一步计划
  experiments/          实验清单与原始文件引用
  models/               工艺与仿真模型文件
  analyses/             数据处理脚本、笔记、图表
  skills/               当前项目启用的工作方法及版本
  assets.lock.yaml      本项目引用的资产版本
  proposals/            待审阅变更
  runs/                 Agent 与工具的执行记录
  deliveries/           发布包清单与导出文件

数据库负责结构化记录和协作状态,文件存储负责原始资料及产物,工作区提供可读写入口。一个文件夹不承担所有并发协作和权限判断。

Agent 可以怎样修改

  • 新建分析脚本、研究笔记和工作文件。
  • 通过工具接口创建实验计划、工况或变更提案。
  • 编辑受支持的交换文件,再由导入接口校验并生成业务变更。
  • 查看差异、修正错误、提交可被工程师审阅的结果。

直接改动文件不会自动覆盖数据库里的正式实验事实。导入需要识别对象、基准版本、单位和来源,并给出明确结果。

MCP 提供什么

MCP 是 Agent 调用能力的一种标准接入方式。模块先提供稳定业务接口,再暴露为查询和动作工具。

示例工具语义:查询证据、读取工况、创建实验计划、运行仿真、提交变更、获取任务状态。这里没有确定正式 API 路径或参数协议。

长任务返回任务编号。工具超时后先查询执行状态,再决定是否重试;同一个提交标识重复请求不会生成两次实验或重复发布。

Skills 提供什么

Skills 保存有版本的工作方法:适用问题、所需输入、步骤、调用工具、检查点和输出要求。工程模板与计算模型保存在资产库,由 Skill 引用。

例如“拟合分离效率”这个 Skill,需要说明哪些实验条件可比较、使用哪个分析程序、怎样检查拟合质量,以及结果适用范围如何表达。

业务规则和权限由系统执行,不能只写在提示词中。

人如何介入

人可以暂停任务、补充输入、锁定参数、修改计划或局部接受提案。恢复时校验此前引用版本是否变化,必要时重新计算。

资料、文献和客户附件被当作证据读取。它们不能改变 Agent 的授权范围,也不能替代工程师的明确决策。

完整执行机制见 Agent 与工具运行时,持续改进机制见研究规划与迭代。

本页内容