Coze【软件测试助手】Skill 完整搭建实操指南

区分：两种实现路径 路径 A（新手首选）：智能体 Bot （日常对话问答，直接聊天使用） 路径 B（复用能力）：独立 Skill 技能，可被其他 Bot 调用、组合工作流 下面完整流程，同时覆盖智能体搭建 + 独立 Skill 开发方案。

一、整体搭建顺序（7 大阶段）

1. 前期资料准备
2. 创建知识库（RAG，重中之重，减少 AI 幻觉）
3. 创建智能体 / 创建独立 Skill
4. 填入【系统提示词 Prompt】
5. （进阶）搭建工作流 Workflow，实现文档上传自动解析
6. 参数调优、测试调试
7. 边界约束配置、风险提示、发布

二、分步详细操作

阶段 1：前期素材准备

知识库待上传文档清单（工业软件测试专用）

1. 公司《软件测试规范》《测试报告标准模板》
2. 测试理论文档：黑盒 / 白盒 / 灰盒测试、单元测试执行方法
3. GB/T 9386 软件测试文档规范
4. 历史项目测试方案、缺陷案例、工控上位机测试经验
5. 缺陷分级标准、测试范围界定模板

✅格式：优先 PDF、Word、Markdown；尽量使用可复制文字，避开纯扫描图片

阶段 2：创建知识库（Coze 控制台）

1. 登录coze.cn → 左侧【资源库】→【+ 资源】→【知识库】→选择【文本知识库】
2. 填写名称：工控软件测试知识库
3. 导入类型：本地文档，批量上传准备好的资料
4. 解析策略配置（关键）
   • 解析模式：精准解析
   • 分段长度：500 字符，重叠 50 字符
   • 开启表格识别
5. 等待文档向量化处理，预览分段，删除乱码片段
6. 保存知识库

后续智能体 / Skill 内绑定该知识库，设置自动检索，优先基于私有资料作答，降低编造概率。

阶段 3：方案 A｜新建智能体 Bot（推荐日常使用）

1. 左侧【开发】→【+ 新建智能体】

2. 基础信息

   • 名称：软件测试助手（工控厂务版）
   • 头像、简介：辅助工程师完成测试方案、用例、测试报告编写，测试理论答疑

3. 【人设与提示词】区域，粘贴之前给到的完整系统 Prompt

4. 知识库绑定：在智能体设置→知识，添加刚刚建好的知识库，检索模式【自动调用】

5. 模型参数调优（减少发散、幻觉）

   • 模型：豆包 Pro
   • 温度 temperature：0.2 ~ 0.3（越低越严谨，减少自由发挥）
   • TopP：0.4
   • 上下文轮数：6 轮

6. 开场白配置（直接复制）

   你好，我是工业软件测试助手！
   我可以实现：
   ✅ 软件测试理论答疑（黑/白/灰盒、单元测试、测试报告编写）
   ✅ 根据需求文档生成测试点、测试用例初稿
   ✅ 缺陷分级、根因分析
   ✅ 按照标准模板输出软件测试报告
   ✅ 输出Mermaid流程图/思维导图用于PPT
   ⚠️所有AI输出仅作为初稿，必须人工复核，不可直接交付！
   你可以粘贴需求描述、接口文档，或者直接提出测试相关问题。

阶段 4：方案 B｜创建独立 Skill 技能（可复用、供其他智能体调用）

如果你需要封装成可调用的 Skill：

1. 左侧【技能商店】→【创建技能】
2. 技能名称：软件测试辅助生成技能
3. 技能描述：用于工业工控软件测试，生成测试用例、测试方案、标准化测试报告、测试知识解答
4. 进入开发界面，将完整系统 Prompt 填入技能指令
5. 在技能内关联知识库
6. 定义入参：
   • input_text：用户输入文本（需求 / 缺陷描述 / 提问）
   • output_mode：可选【markdown / 表格 /mermaid】
7. 保存技能，完成后可在任意智能体中「添加技能」进行调用

👉简单区分： 日常自己使用 → 做【智能体 Bot】 多个 Bot 共用、工作流调用 → 封装成【独立 Skill】

阶段 5：进阶优化｜搭建工作流 Workflow（强烈建议）

实现能力：用户直接上传 PDF 需求文档 → 自动解析 → 提取内容 → 生成测试点 / 测试用例 工作流节点顺序： 开始节点（接收用户文本/文件）→文档解析插件→大模型节点（测试生成Prompt）→结束输出

1. 左侧【工作流】→新建工作流
2. 拖拽节点： ① 开始：定义变量 user_input（文本）、file（文件） ② 插件节点：文档读取插件，解析上传 PDF/Word ③ 大模型节点：填入精简版测试助手提示词 ④ 条件分支：区分用户需求（问答 / 生成用例 / 生成报告）
3. 工作流保存后，在智能体内设置：匹配关键词自动触发 触发关键词：生成测试用例、生成测试报告、分析需求、编写测试方案

阶段 6：测试、调优、避坑验证

测试用例自测清单：

1. 提问：黑盒测试和白盒测试优缺点
2. 粘贴一段功能需求，要求生成测试用例
3. 粘贴测试原始数据，生成标准测试报告
4. 故意提问知识库内存在的规范，检验是否引用内部文档
5. 提问知识库不存在的标准，检验是否主动说明、不胡乱编造

常见优化手段：

• AI 经常编造参数 → 调低温度，在 Prompt 强化：信息不足直接说明，禁止猜测
• 输出格式混乱 → 在 Prompt 强制要求 Markdown、表格、Mermaid 规范格式
• 太长内容截断 → 调整最大输出 Token

阶段 7：硬性约束配置（工控软件必备，规避风险）

1. 在系统 Prompt 强制追加风险声明，每次输出末尾自动带出

plaintext

⚠️重要声明：本文档由AI辅助生成，仅作为工作初稿。所有测试用例、测试结论、风险分析需要测试工程师人工完整评审；不能直接作为正式交付文件，不可单独作为软件上线判定依据。

1. 禁止 AI 输出确定性上线结论，所有风险判定交给人；
2. 不允许 AI 自主评估高可靠工控系统安全风险。

三、Mermaid 架构图

四、快速上手路线

1. 第一阶段（1 天完成）：新建智能体 + 导入知识库 + 粘贴 Prompt，实现基础问答、生成测试用例
2. 第二阶段（进阶）：搭建文档解析工作流，支持上传需求文件
3. 第三阶段（长期）：拆分功能，封装独立 Skill，实现和其他智能体联动