必须创建专用于审阅的agent(docreviewer),配置系统指令、上下文变量及工具权限,绑定术语校验skill,并通过craft任务触发审阅流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让WorkBuddy自动识别技术文档中的术语不一致、层级错乱、逻辑矛盾等隐性错误,并生成带依据的修改建议,必须创建一个专用于审阅的Agent,而非在普通对话中零散提问。
创建审阅专用Agent
打开WorkBuddy控制台 → 左侧导航栏点击【Agent管理】→ 点击右上角【新建Agent】。
填写名称为DocReviewer,描述字段写明“专责审阅Markdown/Word/PDF技术文档,检测术语规范性、标题层级、前后逻辑矛盾及格式合规性”,【切勿勾选文件写入权限】,只启用文本解析、正则匹配、多文档比对三项工具——误开写入权限会导致AI擅自覆盖原始文档。
保存后确认状态为“已激活”,若右侧出现红色警告图标,说明工具权限与描述职责不匹配,需返回编辑页修正。
配置审阅规则与上下文变量
进入该Agent的编辑页 → 切换到【系统指令】标签页 → 粘贴以下结构化指令(可直接复制):
你是一名企业级技术文档审阅专家。每次执行前先检查输入文档是否符合公司《技术文档编写规范V3.2》:① 一级标题必须为“# 文档名称”,二级标题必须为“## 模块名”,三级标题必须为“### 子功能”;② 所有技术术语必须与术语库完全一致(如“API网关”不可写作“网关API”);③ 参数描述中同一字段在不同章节出现时,类型、默认值、是否必填必须完全相同;④ 每处错误必须标注原文位置(行号或段落编号)、违反条款编号、正确写法示例、规范依据原文。输出格式严格为Markdown表格,含四列:错误位置|问题类型|规范条款|修正建议。
返回【上下文配置】标签页 → 新增变量user_doc_type,类型选string,初始值填“接口设计说明书”——这个值后续可通过任务触发器动态替换,比如换成“数据库设计文档”或“上线变更方案”。
绑定文档处理能力
方法一:对接本地文件系统
在Agent编辑页 → 【工具权限】区域 → 勾选“本地文件读取”,并指定允许访问的路径,例如D:\projects\tech-docs。注意路径中【不能含中文或空格】,否则读取失败且无明确报错提示。
方法二:通过Skill增强审阅逻辑
前往【Skill管理】→ 点击【新建Skill】→ 名称填“术语一致性校验”,类型选“正则校验”,在规则字段粘贴:(?i)网关api|api网关|gateway api → 替换为“API网关”。保存后回到DocReviewer编辑页,在【附带Skill】列表中勾选该项。这一步能让Agent自动拦截所有大小写混用、词序颠倒的术语变体。
测试审阅流程
第一步:新建一个任务 → 模式选Craft → 在对话框输入:“请用DocReviewer审阅当前工作空间下的接口设计_v2.md”。
第二步:确保该文件已上传至当前工作空间,且文件名不含特殊符号(如括号、&、#)。
第三步:发送指令后等待响应,观察产物区是否生成带行号定位的审阅表格。若返回“未检测到术语库”类提示,说明上下文变量user_doc_type未生效,需检查是否在任务触发时漏传了参数。










