| name | guideline-section-expansion |
| description | 把已核验的权威指南按原文结构逐节展开讲解,并给出原文定位,帮医生读懂原文;也可把指南整理为学习路径图(学习顺序)。不得生成诊疗方案、床旁处置步骤、疾病 SOP、急诊行动卡、个体患者建议或药物剂量说明。 |
| metadata | {"octop":{"emoji":"📑","label":{"zh":"章节展开","en":"Section Expansion"},"summary":{"zh":"按原文结构展开指南章节,或整理学习路径图。","en":"Expand verified guideline sections or build a learning pathway."}}} |
指南章节展开与学习路径图
用户反馈里最常见的两句话是「指南查到了但展不开」和「能不能把指南总结成流程」。本 skill 处理这两件事,并把它们严格限定为学习产物。
最小必读集
- 用户只要求总结筛查、随访、质控等某一专题时,本 skill 已内嵌学习边界、常用信源规则和输出字段;不再读取
source-policy.yaml、compliance-boundary.md 或 output-templates.md。最终仍由 validate_output.py 使用完整策略校验。
- 用户要求完整章节展开或学习路径图时,再按需读取
../../references/compliance-boundary.md 和 ../../references/output-templates.md。
- 上述均为确定路径;不得通过
glob、grep 或递归 ls 定位。
先分清用户要哪一种
| 用户说法 | 使用 |
|---|
| 展开这一章、细看、详解、这节讲了什么、看全文 | 章节展开 |
| 总结指南中某一专题的学习要点,例如筛查、随访、质控 | 章节展开 |
| 怎么学这份指南、学习顺序、总结成流程、给我路径 | 学习路径图 |
| 我掌握得怎么样、测一下、薄弱点 | guideline-learning-diagnosis skill |
| 建立每日连续学习 | guideline-learning skill |
命中「总结某一专题的学习要点」时,直接跳到「专题总结快速路径」;该节已给出完整执行规则,不再另外读取参考文件。
用户说「流程」时必须先确认他要的是学习顺序。如果他实际想要的是「遇到这种病人先做什么再做什么」,那是床旁处置请求,按 compliance-boundary.md 的高风险口径拒绝,并说明可以改为学习路径图。
前置:必须先有可核验的原文
展开和路径图都必须绑定已核验的权威文件:完整名称、发布机构、版本/年份、权威原文链接。
- 取不到权威原文时,不得凭记忆展开。只能说明「未取得可核验权威原文」,并给出候选来源方向。
- 完整章节或路径图只能使用 source-policy.yaml 白名单内的最终依据;专题总结按下方快速路径内嵌的同等规则执行。聚合平台默认只作线索;仅在原始正文明确访问受限、同时取得 S/A 正式元数据并完成标题/机构/版本/DOI/全文完整性/现行状态核验时,source-policy.yaml 指定的 B+ 平台才可作为正文承载渠道。
- 用户明确指定国际指南,或国内现行正式文件未覆盖主题时,读取
../../references/international-guideline-source-routes.yaml。普通补充只从 WHO、NICE、ESC、ADA、KDIGO 默认池选择最匹配的 1 站;明确涉及 GINA、GOLD、ACG、EASL 等体系时直接访问对应官网。首站确实不覆盖时最多增加 1 站,不得并行遍历。不得用国际建议静默覆盖中国大陆现行规范。
- 版本必须写清。指南改版频繁,展开旧版时要标注这是哪一版。
章节展开怎么做
完整章节展开使用 output-templates.md 的「指南章节展开」模板;专题总结直接使用下方快速路径的字段清单。要点:
- 给出原文定位:章号、节号、条目号或页码范围,让用户能回到原文核对。这是本能力的核心价值。
- 按原文结构讲,不重排成自己的逻辑;说明本节在指南整体结构中的位置和与上下游章节的关系。
- 只做结构化摘要,不整段复制全文。目标是帮用户读懂,不是替代原文,也要避免版权问题。
- 标注证据等级、推荐强度(原文有则写,没有不编)。
- 点明易混淆处——这是医生真实的学习痛点。
- 结尾必须声明不替代原文,以权威原文为准。
允许展开指南中的定义、诊断标准、鉴别框架、分层概念、检查与随访要求、质控指标、章节间的概念关系。不得把这些条款代入某个真实患者得出结论,不得改写成院内可执行文件。
专题总结快速路径(性能硬约束)
当用户要求面向基层总结筛查、随访、质控等单一专题时:
- 默认只选 1 份能够直接覆盖问题的现行主指南。用户未要求跨指南比较时,不主动扩展老年专项、基层专项或其他并行文件;只有主指南确实缺少该主题时才补第 2 份。搜索、抓取、B+ 降级、草稿校验和改稿共享同一份累计工具预算,任何阶段都不得重新计数。
- 直接读取
../../references/verified-source-entrypoints.yaml,先按 aliases 匹配主题。命中时直接 web_fetch 该条目的 canonical_url,页面标题和 DOI 均匹配后才可作最终依据;不得用本地表项替代原文核对。
- 命中条目且当前日期未超过
recheck_after 时,该次原文抓取即是实时核验,不再广泛搜索。只有用户明确询问「最新/现行/替代」,或已超过 recheck_after,才再加 1 次限定官方域名的时效检索。
最终来源行必须使用命中条目的 canonical_url;official_index_url 只辅助核对卷期/DOI,不取代原文链接。订阅墙导致只能核对摘要或公开附录时,必须把未能核对的具体条款标为「待核验」,不得用二手内容补全。
2.1 未命中高频入口、但主题能对应专业学会或专科分会时,直接读取 ../../references/professional-society-source-routes.yaml,按分会名称或 aliases 选择一个最相关的官方域名做第 1 次限定检索;不得并行遍历全部分会。标记为 official_discovery_pending_fulltext_acceptance 的域名只用于找到完整正式原文,不能直接作为最终来源。
- 原始正文遇到 412、验证码、JS 阻断、超时或正文不可获取时,才允许 B+ 受控降级:先用原始发布方/正式期刊元数据页核对标题、机构、年份/版本和 DOI/文号,再抓取指定 B+ 平台的完整正式正文并检查完整性与现行状态。最终同时列“原始元数据”和“正文承载”两条来源;只有 B+ 页面或任一字段不一致时立即停止,不生成学习要点。
- 未命中入口表时,正常目标为 1 次定向搜索 + 1 次正文抓取,整个用户回合的总工具预算硬上限为最多 3 次
searchfree_search 和 3 次 web_fetch,包括失败、超时、空结果、国际补充、B+ 降级、C 级全网转述、校验后补链和改稿。每层最多一次定向查询:国内 A → 国际 A(仅在用户指定或国内无覆盖时)→ B 级发现/B+ 承载或 C 级全网。不得换旧版文件或猜测 URL 继续试探。找到 1 份能覆盖主题的现行正式主指南后立即停止搜索。
- 预算内未取得现行权威原文时,不得生成“原文展开”或声称掌握原文。若 C 级网页明确给出原始权威期刊/机构、完整标题、年份/版本及 DOI/文号信息,可输出单独的“背景转述”失败回执,并按
source-verify 的 C 级格式披露;否则答复「未取得可核验的现行权威原文,本次不生成学习要点」。C 级转述不得涉及精确推荐、证据等级或药品高风险信息。
- 最终依据默认 1 份、最多 2 份:1 份现行主指南;仅在主指南确实不覆盖问题或用户明确要求比较时补 1 份专项指南。只接受正式指南、共识、规范或质控文件;综述、原始研究、科普、转载、会议材料和搜索摘要不得作最终依据。
- 常用国内原始来源域名包括
.gov.cn、.nhc.gov.cn、.ndcpa.gov.cn、.chinacdc.cn、.cma.org.cn、.medjournals.cn、.cmda.net、.cpma.org.cn、.pmph.com、cs.medjournals.cn、bi-dmp-cs.yiigle.com 和 rs.yiigle.com。国际 A 级域名以 international-guideline-source-routes.yaml 为准。搜索结果只用于定位原文;起草前先选定原文详情页或正式附件链接。通用列表页只能作候选,不能在无法对应具体文件时当作原文链接。
- 未命中入口表时,第 1 次查询必须同时包含主题、「最新/现行」和注册表匹配到的专业分会/学会域名;没有专业路由时才优先
site:rs.yiigle.com 与 site:cs.medjournals.cn。第 2 次查主管部门或正式期刊平台;第 3 次只用于确认版本替代关系或在原始正文访问受限后定位 B+ 完整正文。必须先确认现行版本,再摘要内容;新版已发布时不得回退到旧版凑答案。
- 草稿中所有 URL(包括正文和来源行)必须属于原始来源白名单,或满足“原始元数据 + B+ 正文承载”的成对降级规则;不得先写入 CDN、搜索结果或其他非白名单 URL,再依赖校验器反复修改。
学习路径图怎么做
用 output-templates.md 的「指南学习路径图」模板。要点:
- 每一步写清:学什么 → 对应原文哪一节 → 预计用时 → 掌握标志(用户能自查)。
- 顺序按认知依赖排(先定义 → 再框架 → 再细则 → 再随访质控),不按临床时间轴排。
- 写明前置知识,并按用户可投入时间调整颗粒度;有学习目标(如备考)时按目标裁剪重点。
- 给「可选深入」,让用户自主选择深入方向——这正是反馈里要的「再选择进一步学习的范围」。
- 每一步必须能对应到原文章节;对应不上就标注待核验,不要凑数。
硬约束:不得出现「处置流程」「诊疗流程」「抢救流程」「处理流程」「急诊行动卡」等表述,也不得把学习顺序写成床旁执行顺序。区分标准是——「先学定义再学分层」是学习顺序;「先给氧再开通静脉」是处置流程,属禁止项。
与学习轨道的衔接
路径图确认后,用户可要求把它保存为连续学习轨道。此时转入 guideline-learning skill,把路径图的每一步作为固定学习单元(ordinal + source_anchor + objectives)落库。
路径图本身是只读产物:不创建投递账本、不推进学习进度。若用户只是看看,正文首行写【格式预览|不计入学习进度】。
输出与校验
发送或提供正式草稿前,按 output-format skill 的约定一次生成完整草稿,并优先通过标准输入在一次工具调用中直接运行校验器,避免写文件与执行环境之间的同步往返:
python3 ../../scripts/validate_output.py --module guideline_section_expansion
或:
python3 ../../scripts/validate_output.py --module guideline_learning_pathway
不得无正文试运行校验器,也不得读取或 grep 校验器源码。校验失败时只按返回的 errors 修正一次;不得绕过。