# Guideline Section Expansion

> 把已核验的权威指南按原文结构逐节展开讲解，并给出原文定位，帮医生读懂原文；也可把指南整理为学习路径图（学习顺序）。不得生成诊疗方案、床旁处置步骤、疾病 SOP、急诊行动卡、个体患者建议或药物剂量说明。

- Skill: `tencentcloud/guideline-section-expansion` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tencentcloud/guideline-section-expansion`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tencentcloud/guideline-section-expansion/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tencentcloud (https://skillmd.com/u/tencentcloud)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tencentcloud/guideline-section-expansion

---


# 指南章节展开与学习路径图

用户反馈里最常见的两句话是「指南查到了但展不开」和「能不能把指南总结成流程」。本 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. **按原文结构讲**，不重排成自己的逻辑；说明本节在指南整体结构中的位置和与上下游章节的关系。
3. **只做结构化摘要，不整段复制全文**。目标是帮用户读懂，不是替代原文，也要避免版权问题。
4. 标注证据等级、推荐强度（原文有则写，没有不编）。
5. 点明易混淆处——这是医生真实的学习痛点。
6. 结尾必须声明**不替代原文**，以权威原文为准。

允许展开指南中的定义、诊断标准、鉴别框架、分层概念、检查与随访要求、质控指标、章节间的概念关系。**不得**把这些条款代入某个真实患者得出结论，不得改写成院内可执行文件。

### 专题总结快速路径（性能硬约束）

当用户要求面向基层总结筛查、随访、质控等单一专题时：

0. 默认只选 1 份能够直接覆盖问题的现行主指南。用户未要求跨指南比较时，不主动扩展老年专项、基层专项或其他并行文件；只有主指南确实缺少该主题时才补第 2 份。搜索、抓取、B+ 降级、草稿校验和改稿共享同一份累计工具预算，任何阶段都不得重新计数。
1. 直接读取 `../../references/verified-source-entrypoints.yaml`，先按 `aliases` 匹配主题。命中时直接 `web_fetch` 该条目的 `canonical_url`，页面标题和 DOI 均匹配后才可作最终依据；不得用本地表项替代原文核对。
2. 命中条目且当前日期未超过 `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` 的域名只用于找到完整正式原文，不能直接作为最终来源。
3. 原始正文遇到 412、验证码、JS 阻断、超时或正文不可获取时，才允许 B+ 受控降级：先用原始发布方/正式期刊元数据页核对标题、机构、年份/版本和 DOI/文号，再抓取指定 B+ 平台的完整正式正文并检查完整性与现行状态。最终同时列“原始元数据”和“正文承载”两条来源；只有 B+ 页面或任一字段不一致时立即停止，不生成学习要点。
4. 未命中入口表时，正常目标为 1 次定向搜索 + 1 次正文抓取，**整个用户回合的总工具预算**硬上限为最多 3 次 `searchfree_search` 和 3 次 `web_fetch`，包括失败、超时、空结果、国际补充、B+ 降级、C 级全网转述、校验后补链和改稿。每层最多一次定向查询：国内 A → 国际 A（仅在用户指定或国内无覆盖时）→ B 级发现/B+ 承载或 C 级全网。不得换旧版文件或猜测 URL 继续试探。找到 1 份能覆盖主题的现行正式主指南后立即停止搜索。
5. 预算内未取得现行权威原文时，不得生成“原文展开”或声称掌握原文。若 C 级网页明确给出原始权威期刊/机构、完整标题、年份/版本及 DOI/文号信息，可输出单独的“背景转述”失败回执，并按 `source-verify` 的 C 级格式披露；否则答复「未取得可核验的现行权威原文，本次不生成学习要点」。C 级转述不得涉及精确推荐、证据等级或药品高风险信息。
6. 最终依据默认 1 份、最多 2 份：1 份现行主指南；仅在主指南确实不覆盖问题或用户明确要求比较时补 1 份专项指南。只接受正式指南、共识、规范或质控文件；综述、原始研究、科普、转载、会议材料和搜索摘要不得作最终依据。
7. 常用国内原始来源域名包括 `.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` 为准。搜索结果只用于定位原文；起草前先选定原文详情页或正式附件链接。通用列表页只能作候选，不能在无法对应具体文件时当作原文链接。
8. 未命中入口表时，第 1 次查询必须同时包含主题、「最新/现行」和注册表匹配到的专业分会/学会域名；没有专业路由时才优先 `site:rs.yiigle.com` 与 `site:cs.medjournals.cn`。第 2 次查主管部门或正式期刊平台；第 3 次只用于确认版本替代关系或在原始正文访问受限后定位 B+ 完整正文。必须先确认现行版本，再摘要内容；新版已发布时不得回退到旧版凑答案。
9. 草稿中所有 URL（包括正文和来源行）必须属于原始来源白名单，或满足“原始元数据 + B+ 正文承载”的成对降级规则；不得先写入 CDN、搜索结果或其他非白名单 URL，再依赖校验器反复修改。
10. 输出校验因辅助来源域名或文档类型失败时，删除该辅助来源并使用已经核验的主指南重新起草；累计预算已耗尽时不得继续搜索补链。直接按以下字段生成一份完整草稿：【指南章节展开｜主题】、依据、章节、原文定位、原文要点、章节关系、易混淆点、学习提示、边界、来源。不先写半成品，不为猜模板再读其他文件。

## 学习路径图怎么做

用 output-templates.md 的「指南学习路径图」模板。要点：

1. 每一步写清：学什么 → 对应原文哪一节 → 预计用时 → 掌握标志（用户能自查）。
2. 顺序按**认知依赖**排（先定义 → 再框架 → 再细则 → 再随访质控），不按临床时间轴排。
3. 写明前置知识，并按用户可投入时间调整颗粒度；有学习目标（如备考）时按目标裁剪重点。
4. 给「可选深入」，让用户自主选择深入方向——这正是反馈里要的「再选择进一步学习的范围」。
5. 每一步必须能对应到原文章节；对应不上就标注待核验，不要凑数。

**硬约束**：不得出现「处置流程」「诊疗流程」「抢救流程」「处理流程」「急诊行动卡」等表述，也不得把学习顺序写成床旁执行顺序。区分标准是——「先学定义再学分层」是学习顺序；「先给氧再开通静脉」是处置流程，属禁止项。

## 与学习轨道的衔接

路径图确认后，用户可要求把它保存为连续学习轨道。此时转入 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` 修正一次；不得绕过。

