检验指导书生成器

任务目标

• 本 Skill 用于：根据用户提供的产品技术文件自动生成检验指导书
• 能力包含：解析多种格式技术文件、支持模板定制、生成标准化检验指导书
• 触发条件：用户上传产品技术文件并需要生成检验指导书、质量检验标准或供应商检验要求

前置准备

• 依赖说明：scripts脚本所需的依赖包及版本

  openpyxl==3.1.2
  python-docx==1.1.0
  

操作步骤

步骤1：接收并解析技术文件

• 智能体读取用户上传的产品技术文件
• 支持格式：PDF、Word、Excel、图片等
• 提取关键信息：产品名称、技术参数、产品规格、测试报告、质量要求等

步骤2：询问用户模板需求

• 智能体向用户询问："您是否有检验指导书模板？如有请上传，如无将使用通用格式生成。"
• 用户响应处理：
  • 回复"有"并上传模板 → 进入步骤3-A
  • 回复"无"或未提供模板 → 进入步骤3-B

步骤3-A：有模板模式

• 智能体分析用户上传的模板文件
  • Excel模板：识别表头字段和表格结构
  • Word模板：识别表格结构和字段标记
• 验证模板是否包含必填字段（检验项目、检验方法、检验标准、检验频次）
• 如模板不符合要求，提示用户并建议使用通用格式
• 模板要求详见：references/template_requirements.md

步骤3-B：无模板模式

• 智能体使用通用检验指导书格式组织数据
• 必填字段：检验项目、检验方法、检验标准、检验频次
• 可选字段：备注、检验工具、抽样方案、责任部门
• 格式规范详见：references/inspection_guide_format.md

步骤4：组织检验数据

• 智能体根据技术文件内容，按以下结构组织检验数据：

  {
    "product_name": "产品名称",
    "inspection_items": [
      {
        "item": "检验项目名称",
        "method": "检验方法",
        "standard": "检验标准",
        "frequency": "检验频次",
        "remark": "备注（可选）",
        "tool": "检验工具（可选）",
        "sampling": "抽样方案（可选）",
        "department": "责任部门（可选）"
      }
    ]
  }
  

• 对于不明确的检验标准，在standard字段标注"需确认"并说明原因

步骤5：生成检验指导书

• 调用脚本生成Excel文件：

  python scripts/generate_inspection_guide.py \
    --product_name "产品名称" \
    --inspection_data '<JSON数据>' \
    --template_path "模板路径（可选）" \
    --output_dir "./"
  

• 脚本说明详见：scripts/generate_inspection_guide.py
• 生成的文件命名格式：{产品名称}_检验指导书_{YYYYMMDD}.xlsx

步骤6：返回结果

• 智能体告知用户检验指导书已生成
• 提供文件路径供用户下载
• 如有"需确认"的标准，提醒用户核实

资源索引

• 生成脚本：scripts/generate_inspection_guide.py（用途：根据结构化数据生成Excel检验指导书）
• 格式规范：references/inspection_guide_format.md（何时读取：无模板时参考通用格式）
• 模板要求：references/template_requirements.md（何时读取：用户提供模板时验证合规性）
• 默认模板：assets/default_template.xlsx（直接用于生成通用格式的检验指导书）

注意事项

• 仅在用户提供技术文件后才执行生成流程
• 模板询问是必需步骤，不得跳过
• 必填字段缺失时，智能体应主动提示用户补充
• 对于技术文件中未明确说明的标准，标注"需确认"而非自行推断
• 生成的文件保存在当前工作目录，供用户后续下载
• 充分利用智能体的文档解析能力，无需为内容提取编写脚本

TRACE 测评