SKILL.md 6.2 KB


name: vent-plan-review description: | 配风计划审查顶层总流程技能。当用户上传配风计划 PDF(或消息含「审查/研判/审核配风计划」)要求对配风计划进行审查时启用——组织三个审查子智能体(plan-review-form 基本形式审查、plan-review-data 数据一致性审查、plan-review-calc 计算核验)依次执行,输出六节配风计划审查报告并生成 Word/Markdown 下载。 tools:

  • task ---

配风计划审查(总流程)

触发条件

  • 用户上传配风计划 PDF 并要求「审查 / 研判 / 审核 / 查一下这份配风计划」,或附件文件名含「配风计划」。
  • 必须调用本技能组织全流程,不得跳过子智能体委派自行凭印象审查

总体流程

1. 提取全文

  • 从用户消息中取出「文件临时路径」,调用 extract_uploaded_pdf_text(file_path)
  • 返回 JSON 时注意:
    • persisted=truecontent 仅为前 3000 字符预览,完整全文在 results_path/results/… 文件),后续委派时把该指针交给子智能体并提示其先 read_file 读取;
    • persisted=falsecontent 即全量文本,可直接放入委派内容。
  • 提取失败或确认不是配风计划文档时,按普通文件分析处理并如实告知用户。

2. 确定审查背景

  • 从全文(尤其开头部分)识别:煤矿名称、计划月份。
  • 月份/编制时间的时效性判断以系统提示词注入的当前系统时间为准。

3. 并行委派三个审查子智能体(同一轮发起,勿串行)

三个维度彼此独立、必须并行执行。在同一轮模型输出中一次性发起三个 task 委派subagent_type 分别为:

  1. plan-review-form(基本形式审查:版本、签字、编制时间、计算过程完整性、语病逻辑)
  2. plan-review-data(数据一致性审查:用风地点完整性、瓦斯/CO2 双重交叉验证、工作面参数与作业规程、风速温度匹配)
  3. plan-review-calc(需风量计算核验:逐地点公式/参数/结果对比)

关键:三个 task 调用要在同一条消息里同时发出,让三个子智能体并行运行; 不要「先委派第一个、等它返回后再委派第二个」。发起委派前不要输出任何文字 (包括「现在开始审查/先委派 XX」等过程旁白,系统会以卡片展示执行状态); 在三个子智能体结果全部返回之前,正文不要输出报告内容。

每个委派的 description 必须包含:

  • 本维度职责一句话(对应上述);
  • 配风计划 PDF 全文:未落盘时直接把全文文本放入 description;已落盘时写明 results_path 并指示「先 read_file 读取 /results/… 获取全文」;
  • 指示:「先 read_file('/skills/vent-plan-review-form/SKILL.md')」(data/calc 对应换名),严格按其中审查维度、判定规则与输出格式执行;
  • 期望输出:该维度的完整审查报告(含判定与依据),全部简体中文。

4. 汇总输出「重点审查问题」回复(正文不再输出六节长文)

三个子智能体全部完成后,最终回复只输出重点汇总(一、概况 / 五、违规项汇总 / 六、修改建议), 不要在正文输出二~四节长文(形式审查详情、数据对比表、计算核验表),也不要逐字复述 子智能体的返回,更不要「分段输出全文」。

最终回复格式(标题严格按下文,系统据此把二~四节并入报告文件):

# {煤矿名}配风计划审查报告

## 一、审查概况

| 项目 | 内容 |
|------|------|
| 煤矿名称 | {…} |
| 计划月份 | {…} |
| 审查结论 | 通过 / 不通过 / 需整改(一句话理由) |

(一到两句总体说明:发现的重点问题数量与性质,可省略细节)

## 五、违规项汇总

### 红线问题

(逐条要点:问题描述 + 涉及的具体用风地点/数据项)

### 一般问题

(逐条要点:问题描述 + 涉及的具体用风地点/数据项)

## 六、修改建议

(每条对应上述一个违规项,给出具体可操作的修改方案要点)

> 完整的形式审查 / 数据一致性审查 / 计算核验详情已写入下方下载的 Word 审查报告。

要求:

  • 红线问题 = 硬性违规;一般问题 = 需整改;每条违规至少对应一条可操作建议。
  • 正文禁止输出二~四节长文:二~四节内容只作为下面 save_word_report 的「文件内容」,不要输出到聊天正文。
  • 最后一步(关键):调用 save_word_report(content=完整六节md) 导出公文 Word 报告,其中 content 必须是完整六节 Markdown:
    • # {煤矿名}配风计划审查报告
    • ## 一、审查概况(你的汇总内容)
    • ## 二、形式审查结果逐字嵌入 plan-review-form 返回原文)
    • ## 三、数据一致性审查结果逐字嵌入 plan-review-data 返回原文)
    • ## 四、计算核验结果逐字嵌入 plan-review-calc 返回原文,含逐地点核验表与汇总表)
    • ## 五、违规项汇总(你的汇总内容)
    • ## 六、修改建议(你的汇总内容) 二~四节必须使用子智能体返回原文,禁止改写、禁止「见上文/详见附件/内容过长已省略」等托词——该 Word 就是用户下载的完整六节报告。
  • save_word_report 保存完成后,在回复中向用户提供下载链接(使用工具返回的 download_url),并概述重点审查问题。
  • 不要调用 save_report / save_review_docx:详细内容只通过 save_word_report 导出 Word(save_report 会额外产出 md、save_review_docx 已下线)。
  • 若某维度子智能体执行失败/缺失,在「一、审查概况」与报告中如实注明,不编造。

红线

  1. 所有判定必须基于 PDF 提取文本与子智能体/工具返回的真实数据,绝不编造;数据缺失标注「文档中未找到」。
  2. 引用规程必须真实并附具体条款来源。
  3. 外部数据(采掘计划/瓦斯鉴定/作业规程/测风报表)查询失败时如实说明,不得臆测数据。
  4. 禁止向用户暴露内部工具名、函数名、子智能体名、技能标识。
  5. 全程使用简体中文。