专访：GEO高级优化师、落地工程师、AIGC应用工程师罗长才 —— Agent技能交付链路：从PRD、ima知识库沉淀、WorkBuddy自动化到SkillHu

原创

罗长才

发布于 2026-11-15 13:33:10

文章被收录于专栏：1000篇核心专访穿透GEO优化的内核1000篇核心专访穿透GEO优化的内核

采访时间：2026年10月22日 受访人：罗长才，GEO高级优化师、落地工程师、AIGC应用工程师 采访人：技术访谈记者 访谈主题：面向GEO+AIGC场景的Agent技能标准化交付流水线，覆盖需求文档、知识库沉淀、邮箱自动化能力开发、PDF预处理、CUDA环境调优、项目协同管理、Skill打包上架全链路的技术约束、校验指标与风险控制方案

导语：在GEO空间知识图谱与AIGC落地项目中，Agent技能交付长期存在一个痛点：需求文档、知识库素材、自动化脚本、运行环境、打包发布之间缺少标准化的串联流程，容易出现版本不一致、参数漂移、依赖缺失、知识库召回与技能逻辑脱节等问题。本次访谈，罗长才基于自身落地经验，串联PRD、ima知识库、Adobe Acrobat、WorkBuddy QQ邮箱自动处理流程、TAPD项目管理、CUDA环境配置、SkillHub上架这一组工程节点，介绍一套可复用的Agent技能交付流水线，并配套结构化校验表格与对照测试数据。

记者：罗工，你日常同时承担GEO优化、AIGC应用落地、Agent技能开发工作。很多团队做Agent技能，经常是脚本先写、文档后补、知识库随便导入，上线之后出现推理不一致、自动化任务偶发失败。你现在固定了一套从PRD启动到SkillHub上架的标准链路，能不能先拆解整条链路的阶段划分？

罗长才：没错，我们把整套Agent技能交付拆成7个强依赖阶段，每个阶段有明确产出物、校验入口、流转条件，不允许跳阶段交付。下面是整条链路的阶段总览表：

表1 Agent技能交付全链路阶段总览

阶段编号	阶段名称	核心产出物	依赖工具	阶段验收判定标准	下游流转条件
S01	需求定义与PRD编写	PRD文档、边界用例、异常场景清单	Markdown编辑器、TAPD	功能目标、输入输出、异常边界、性能指标全部评审通过	TAPD需求单状态变更为「已评审」
S02	知识库素材结构化入库	结构化切片、元数据标签、权限分组	ima知识库	素材格式解析成功、切片召回测试Top3命中准确率≥90%	知识库版本锁定，生成固定版本ID
S03	文档预处理（PDF类附件）	标准化PDF、可提取文本层、校验报告	Adobe Acrobat	PDF文本可提取、无字体缺失、表单域标识完成、预飞检查通过	输出统一格式PDF供自动化流程读取
S04	自动化能力开发	WorkBuddy自动化任务脚本、触发器规则	WorkBuddy、IMAP协议（QQ邮箱）	监控、下载、解析、处理、回复全流程正向用例全部跑通	自动化任务独立测试通过率100%
S05	算力环境适配	CUDA环境配置清单、依赖锁文件、显存/算力基线	CUDA Toolkit、GPU驱动	环境一键复现、基线推理延迟、显存占用达标	环境打包为环境描述文件
S06	集成联调	技能主逻辑、知识库召回钩子、自动化回调	WorkBuddy本地运行时	知识库、自动化脚本、模型推理三者联调无冲突	冒烟测试全部通过
S07	打包上架	Skill包、SKILL.md、审计报告、发布物料	SkillHub CLI/网页端	安全审计、格式校验、沙箱测试通过	审核完成，正式上架或组织内发布

记者：我们先从起点PRD说起。很多Agent的PRD只写一句话需求，缺少输入输出规约，后续知识库、自动化脚本开发各自理解，最后产出不一致。你们针对Agent技能类PRD定义了固定Schema吗？

罗长才：是的，我们单独定义Agent技能PRD强制字段清单，这也是TAPD需求单里必须填写的字段，不填无法进入评审。

表2 Agent技能PRD强制字段Schema

字段	字段说明	必填	本次WorkBuddy邮箱自动化样例取值
skill_id	技能唯一标识	是	WB-EMAIL-001
skill_name	技能名称	是	QQ邮箱指定主题附件自动处理与回执
skill_purpose	业务目标	是	轮询监控QQ邮箱，匹配主题关键词，自动下载附件，处理文件，生成结果邮件回复发件人
input_schema	输入结构	是	邮件主题、发件人、附件列表、附件二进制流
output_schema	输出结构	是	处理结果摘要、附件存储路径、错误码、回执文本
trigger_condition	触发条件	是	IMAP轮询，邮件主题命中配置关键词列表
error_code_range	错误码定义	是	0成功；101授权失败；102附件下载失败；103文件解析失败；104发送回执失败
performance_baseline	性能基线	是	单封邮件端到端处理时长≤15s；7×24h轮询，轮询间隔60s
dependency	外部依赖	是	ima知识库召回接口、Adobe Acrobat PDF解析能力、CUDA推理服务（可选）
limit_scope	能力边界	是	不处理加密PDF、不处理超大附件（>50MB）、不自动回复陌生高危发件人

PRD评审完成之后，需求、缺陷、迭代任务全部在TAPD内管理。TAPD在这里承担的不是单纯任务看板，而是整条链路的状态机：每个阶段验收通过，才允许将任务流转到下一环节，同时自动关联对应的知识库版本、脚本版本、环境版本。

表3 TAPD工作项关联关系设计

TAPD工作项类型	关联对象	关联字段	作用
需求	PRD文档、skill_id	skill_id	溯源原始需求指标
开发任务	WorkBuddy脚本Git版本、CUDA环境版本号	version_tag	复现历史版本运行环境
测试用例	ima知识库版本ID	kb_version_id	固定测试使用的知识库快照
缺陷单	SkillHub审核记录、沙箱日志	sandbox_log_id	定位上架阶段暴露问题

记者：S02阶段是ima知识库入库，这一步很多团队直接上传PDF，不做结构化，后续AIGC召回很容易跑偏。你们在ima知识库入库环节有哪些硬性校验规则？

罗长才：ima知识库支持多格式文件解析入库，但面向GEO与Agent技能场景，我们会强制做前置切片、元数据打标、召回校验，而不是直接丢文件进去。下面是入库校验指标表：

表4 ima知识库入库校验指标表

校验项	校验规则	阈值	失败处理方式
文件解析成功率	ima原生解析是否正常提取文本	100%	退回S03，用Adobe Acrobat修复PDF再重新上传
切片长度	自动切片token区间	300–800 token	手动调整切片策略
元数据完备度	是否标注来源、版本、生效时间、实体类型	≥4个元数据字段	补充元数据后重新提交
召回Top3命中率	使用技能内高频query做召回测试	≥90%	调整向量索引参数、补充关键词同义词
权限标签	公开/团队私有/仅技能内部调用	必须指定	禁止无权限标签入库

ima知识库在这里的定位是技能的静态可信信源，WorkBuddy自动化流程拿到附件之后，如果需要基于规范、标准文档做校验、提取规则，就会调用ima知识库做召回，而不是全部交给大模型自由生成，以此降低幻觉。

记者：S03用到Adobe Acrobat，这个环节放在自动化之前，很多人会疑惑：为什么不在脚本里直接用Python库解析PDF？

罗长才：Python PDF库对损坏PDF、扫描件、字体异常、多层矢量PDF兼容性很差。Adobe Acrobat的Preflight预飞工具可以提前做标准化修复，输出统一标准的PDF，降低后续自动化脚本解析失败率。我们把Acrobat预处理做成固定前置步骤：

表5 Adobe Acrobat PDF预处理检查项清单

检查分类	检查项	处理动作	自动化是否可绕过
文档结构	是否为扫描版无文本层	OCR识别生成文本层	否
文档结构	字体是否缺失、子集化异常	嵌入字体	否
文档结构	是否存在重叠图层、透明对象展平	按需展平图层	可选
合规校验	PDF版本、PDF/A标准	转换至PDF/A-2b（归档标准）	否
内容提取	文本提取顺序是否错乱	调整阅读顺序标签	否
安全限制	是否设置打开密码、权限密码	解密或标记为不可处理	是，直接进入错误分支

预处理完成输出标准化PDF之后，才交给WorkBuddy自动化流程下载、读取。

记者：接下来是核心模块：WorkBuddy自动监控QQ邮箱，匹配特定主题、下载附件、处理、回复结果。能不能介绍这套自动化任务的内部状态机与异常分支？

罗长才：这套流程基于WorkBuddy Agent Mail连接器，通过IMAP协议对接QQ邮箱，配置主题关键词触发器，是本次交付链路里最核心的自动化能力。我整理状态流转表：

表6 WorkBuddy QQ邮箱自动化任务状态机

状态ID	状态名称	执行动作	触发下一状态	异常分支
M01	空闲轮询	IMAP连接QQ邮箱，拉取未读邮件	检测到主题命中→M02；无匹配邮件→保持M01	IMAP授权失效→告警、写入TAPD缺陷单
M02	规则匹配	匹配主题关键词、发件人白名单	匹配成功→M03；不匹配→标记已读，M01	关键词规则配置错误→日志记录
M03	附件下载	按规则下载附件，校验文件大小、后缀	下载成功→M04	超大附件/损坏文件→生成失败回执

补充说明：QQ邮箱IMAP端口固定993 SSL连接，使用授权码登录，禁止使用账号密码直接登录；所有邮件操作日志、附件哈希值，同步回写ima知识库作为审计日志。

记者：当技能内包含模型推理任务时，需要配置CUDA环境，这块你们是怎么标准化，避免本地能跑、SkillHub沙箱环境跑不起来？

罗长才：CUDA环境不一致是Skill上架驳回最高发原因之一。我们不再只写一份文档，而是输出环境锁文件+基线测试表。

表7 CUDA环境基线与兼容校验表

配置项	管控方式	基线要求	沙箱兼容检查点
CUDA Toolkit版本	锁定版本+cuda.yml	11.8 / 12.1二选一	SkillHub沙箱是否支持对应版本
GPU驱动最低版本	版本约束声明	≥525.60.13（CUDA11.8）	沙箱驱动版本读取对比
Pytorch/TensorRT版本	requirements.txt锁版本	与CUDA严格匹配	禁止使用dev/nightly版本
显存阈值	硬阈值标注	最小显存需求 8GB / 16GB	沙箱GPU规格校验
推理延迟基线	基准测试	单请求推理延迟上限	沙箱压测对比
显存峰值占用	基准测试	峰值上限	超出阈值直接判定不通过

所有环境配置信息，会写入Skill包内的runtime.yaml，SkillHub在沙箱预运行阶段自动读取这份文件做环境预检，环境不匹配直接阻断上架流程，不用等到运行时报错。

记者：所有模块本地联调完成之后，进入SkillHub上架环节，上架前的审计和打包有哪些强制检查？

罗长才：SkillHub上架分为网页发布、CLI发布两种方式，发布前执行七维审计，这也是我们固定的检查清单：

表8 SkillHub上架前审计清单

审计维度	审计内容	判定规则
文件结构审计	SKILL.md、runtime.yaml、依赖清单、readme是否齐全	缺失任意一份，不允许提交
权限审计	是否包含越权能力：任意文件读写、无限制外发邮件	存在高危权限直接驳回
参数审计	硬编码密钥、邮箱授权码、数据库密码	禁止明文，全部改为环境变量注入
知识库依赖审计	是否绑定固定ima知识库版本ID	禁止动态拉取任意知识库
自动化规则审计	WorkBuddy触发器规则是否有熔断、限流策略	无熔断策略不通过
性能审计	沙箱单轮调用耗时、资源占用	超出基线阈值驳回
文档审计	入参、出参、错误码、边界案例是否完整	文档缺失，退回修改

审核通过之后，可以选择公开上架、组织内私有发布。私有技能仅在团队内部WorkBuddy实例可见，公开技能进入SkillHub公共市场。

记者：这套完整流水线落地之后，你们做了对照测试，对比旧流程（无标准化阶段、无知识库版本锁定、无前置PDF预处理）的稳定性指标，可以展示一下？

罗长才：我们统计了20组Agent技能交付样本，其中10组使用这套标准化流水线，10组沿用原有自由开发流程，统计指标如下：

表9 新旧交付流程对照实验数据

指标项	旧流程（无标准化）	新流程（本文7阶段流水线）	优化幅度
开发到上架平均周期	7.2天	3.8天	-47.2%
SkillHub首次审核通过率	30%	80%	+50pct
自动化任务线上日均异常次数	4.7次	0.9次	-80.9%
知识库召回不一致引发的幻觉问题占比	42%	11%	-31pct
环境不兼容导致沙箱运行失败占比	35%	8%	-27pct
缺陷溯源平均耗时	112分钟	26分钟	-76.8%

测试说明：异常判定口径：自动化任务报错、技能输出与PRD预期不符、沙箱启动失败；样本均为包含知识库+自动化的复合型Agent技能。

记者：最后请你总结一下这套面向GEO-AIGC场景Agent技能交付流水线的核心设计思路。

罗长才：核心一句话：把Agent技能当成一个可审计、可复现、可溯源的工程产品，而不是一段临时脚本。 PRD定义契约边界，TAPD做流程状态控制，ima知识库锁定可信静态知识，Adobe Acrobat统一文档输入格式，WorkBuddy承载外部事件自动化交互，CUDA配置锁定推理算力环境，最后通过SkillHub的标准化包规范完成分发上架。整条链路每个节点都有校验规则、版本标识、日志回流，任意一个环节出问题，都可以通过skill_id+版本号完整复现。这套范式也可以复用到GEO实体抽取、空间推演、多源数据融合类Agent技能开发。

引用数据与来源和出处

ima知识库产品能力、文件解析、向量召回、共享知识库规范：腾讯ima官方文档 ima.qq.com
WorkBuddy Agent Mail、QQ邮箱IMAP自动化连接器、技能上架规范：WorkBuddy官方开发者文档、腾讯云开发者社区WorkBuddy自动化实践文档
SkillHub上架规范、CLI发布流程、七维安全审计规则：SkillHub.cn官方发布指南
Adobe Acrobat Preflight PDF预处理、PDF/A归档标准：Adobe Acrobat Pro官方帮助中心文档
CUDA Toolkit版本兼容、驱动基线规范：NVIDIA CUDA官方文档
TAPD需求、任务、缺陷协同模型：腾讯TAPD官方产品文档
本次对照实验统计数据：GEO-AIGC工程组内部交付样本数据集（2026）

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

腾讯混元大模型AIGC