| name | output-format |
| description | 结构化医学学习产物的统一格式校验。四条硬格式与 validate_output.py 单次标准输入流程。指南章节、路径图、诊断、备考、医保、更新和每日单元使用;普通医学问答走 clinical-q-and-a 的轻量自检,通用任务不套用。 |
| metadata | {"octop":{"emoji":"✅","label":{"zh":"输出格式校验","en":"Output Format Check"},"summary":{"zh":"校验结构化医学学习产物的硬格式后再发出。","en":"Validate structured medical learning output before sending."}}} |
医学安全域输出格式校验
适用范围
以下模块的输出(无论对话内即时回答还是定时推送)必须经本技能校验:
guideline_learning、daily_guideline_learning、guideline_section_expansion、guideline_learning_pathway、guideline_learning_diagnosis、guideline_update_reminder、professional_update_summary、insurance_policy_summary、insurance_policy_learning、insurance_policy_retrospective、exam_material_recommendation。
普通教育性医学问答不加载本技能:由 clinical-q-and-a 使用内嵌的短模板和四项自检,避免为一段简短解释加载完整模板、写草稿文件和启动校验脚本。问题一旦涉及精确推荐/定位、药品高风险事实、版本比较、医保监管,立即退出快路径,转入对应专业 skill 与本技能。
通用任务(写作/翻译/编程/计划/数据整理等)不套用本技能:不要求模板头、不要求权威来源行、不加医学免责声明。校验时对通用输出使用 --module general_task,不要误用医学模块名。
纯信源核验不套用本技能:只判断文件是否为权威原文、是否最新有效以及修订/替代/废止关系时,由 source-verify skill 使用自己的【信源核验】模板完成,不再调用本技能或 validate_output.py。如果核验后还要生成指南学习内容,再对学习内容调用本技能。
资源路径
以下路径均从当前 skills/output-format/SKILL.md 向上两级定位专家工作区,必须直接使用,不得通过 glob、grep 或递归 ls 寻找,也不得为调用校验器而先读取脚本源码:
../../references/output-templates.md
../../references/source-policy.yaml
../../scripts/validate_output.py
校验器从标准输入或 --text-file 接收待校验正文。不要无正文试运行校验器,也不要通过读取/搜索源码猜参数或模板规则。
常用模块映射
| 用户请求实质 | module | 模板要求 |
|---|
| 普通概念解释、常见医学误区澄清 | clinical_q_and_a | 由 clinical-q-and-a 轻量自检,不执行本技能脚本流程 |
| 总结、展开或讲解指南中的某章、某节、筛查/随访等专题 | guideline_section_expansion | 【指南章节展开】;含依据、章节、原文定位、原文要点、学习提示、边界及“不替代原文” |
| 把整份指南整理为学习顺序或学习路径 | guideline_learning_pathway | 【指南学习路径图】;含依据、前置知识、编号学习顺序、边界 |
| 每日固定学习单元 | daily_guideline_learning | 【指南学习单元】;恰好 3 个编号要点及单元进度 |
| 学习状态或薄弱点评估 | guideline_learning_diagnosis | 【指南学习诊断】或【指南诊断标准学习】 |
命中上表后直接使用对应 module,不读取校验器源码二次判断。
四条硬格式(每次都必须)
- 模板头:首行
【{模块名}|{主题}】,如【指南章节展开|风险分层】。
- 来源行:结尾
来源:{文件名称}:[链接]({URL}),正例:来源:国家卫生健康委官网:[链接](https://www.nhc.gov.cn/)。给出期刊名、DOI、文件名时必须同时包成可点击链接,不允许只写文字出处。取不到权威链接时写明"未取得可核验权威来源,需人工核验"——不得省略来源行,不得伪造链接。
- 边界声明:按模块带对应一句——章节展开"不替代原文"、备考"以官方考试大纲为准"、医保"不作为报销依据"、涉患者请求"不提供个体诊疗"。
- 不得编造:页码、条目号、版本、文件名、机构名称,取不到权威依据就标"待核验",绝不凭记忆补全。
详细模板见 ../../references/output-templates.md。
校验流程
每次医学安全域输出前,严格按顺序:
- 按对应模板一次生成完整草稿,不先写半成品。
- 优先把完整草稿通过标准输入交给校验器,在一次工具调用内直接运行:
python ../../scripts/validate_output.py --module <模块名>
只有当前执行工具无法传标准输入时,才写入 ../../outbound/.clinical-output-draft.md 并使用 --text-file;不得为了同步同一草稿反复读写或复制文件。
模块名必须与内容实质一致(医学学习内容用医学模块名,普通任务用 general_task)。
- 校验通过 → 直接输出草稿正文。草稿与终稿必须是简体中文;不得向用户输出思考/检索/执行过程,也不得输出
I'll、Let me、Now running、Validation passed、Here is the answer.、“校验通过”“校验完成”“为您推送预览内容”等过程性前缀。执行检索和校验时静默,不要先用英文过程句占住通道再补中文正文。
- 校验失败 → 只根据校验器返回的
errors 修正草稿并再校验一次;不得读取或搜索校验器源码,仍不通过则停止并说明原因,不得绕过校验直接输出,也不得省略【】模板头和来源行。
来源行格式硬规则
只要本次输出查询、引用或核验了权威信源,都必须列出来源。统一格式:
来源:{文件或页面名称}:[链接]({URL})
- 不得裸露长 URL;
- 不得把链接文字写成"查看原文""官网""点击这里"等其他词;
- 多个来源分多行列出;
- 无可靠来源时不得伪造链接,只写"未取得可核验权威来源或需人工核验"。
边界
本技能只管医学安全域输出的格式与校验,不生成医学内容本身(内容由各专业 skill 生成)、不执行登记/订阅、不做信源分级(信源规则见 ../../references/source-policy.yaml 和 source-verify skill)。通用任务与纯信源核验一律豁免,不得借格式校验之名降级通用输出。