# Dual Doc Faq > 双文档答疑工作流：用户对某份主文档提问时，在主文档中添加简短注解，同时在配套 FAQ 文档中添加完整 Q&A 条目。 适用于任何"主文档 + FAQ 文档"的答疑场景。 Use when the user asks to explain terms, concepts, or mechanisms from a document and wants both a brief inline annotation and a detailed FAQ entry, or mentions "答疑", "解释一下", "啥意思", "什么意思", "介绍下", "补充进文档", "补充说明". - Skill: `zxremail/dual-doc-faq` (Agent Skill) - Install (CLI): `npx skillmds@latest add zxremail/dual-doc-faq` - Raw SKILL.md: https://api.skillmd.com/api/skills/zxremail/dual-doc-faq/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: zxremail (https://skillmd.com/u/zxremail) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/zxremail/dual-doc-faq --- # 双文档答疑工作流 用户在阅读一份**主文档**时提问术语和概念。每次回答需**同步更新两个文件**：主文档保持精炼，FAQ 文档保持详尽。 ## 前提 使用本 Skill 前，需要确认两个目标文件： | 角色 | 说明 | 更新策略 | |------|------|----------| | **主文档** | 用户正在阅读的文档（架构设计、技术方案等） | **简短**：在原文附近插入 blockquote 注解 + 扩展术语表（如有） | | **FAQ 文档** | 配套的答疑参考文档 | **详尽**：完整 Q&A 条目（多层子节、表格、类比、一句话总结） | 如果 FAQ 文档尚不存在，按 [附录 A：FAQ 文档初始化模板](#appendix-a) 创建。 --- ## 工作流 ### Step 1：定位原文 在主文档中找到用户引用的原文位置（章节号、段落），确认上下文语境。 ### Step 2：更新主文档（简短注解） 在**原文附近**（紧接段落之后、表格之后、或相关注解组内）插入一条简短注解。 根据主文档格式选择合适的注解形式： **Markdown 主文档**： ```markdown > **名词解读 · {术语名}**：{2-4 句话的精炼解释}。 > **常见疑问：{问题}？** {2-4 句话的精炼回答}。 ``` **HTML 主文档**： ```html
名词解读 · {术语名}：{2-4 句话的精炼解释}。
``` 如果主文档有术语表/词汇表章节，检查是否已包含该术语： - **已有**：视需要微调措辞 - **没有**：在术语表末尾追加条目 ### Step 3：更新 FAQ 文档（详尽 Q&A） 依次完成以下修改： #### 3a. 导航 在侧边栏/目录的列表末尾追加链接，N = 当前最大编号 + 1： ```html
  • QN · {短标题}
    • ``` #### 3b. Q&A 条目 在内容区末尾（`` 之前）插入完整条目： ```html
    QN
    {问题全文} 原文：§X.Y — "{引用的原文片段}"

    {子话题 1}

    {详细说明}

    {子话题 2}

    维度AB
    .........
    一句话总结：{一句话概括核心要点}。
    ``` #### 3c. 内容要求 | 要求 | 说明 | |------|------| | **深度** | 假设读者了解本领域但不了解该术语，从"为什么需要"讲起 | | **结构** | 每个 Q&A 至少 2-3 个 `

    ` 子节 + 一个对比/总结表格 | | **类比** | 尽量提供一个日常生活类比帮助理解 | | **一句话总结** | 必须有，放在 `
    ` 中 | --- ## 注意事项 - 主文档注解要**简短克制**（≤ 4 行），不要让主文档变臃肿 - FAQ 条目要**详尽充分**，不怕长，定位就是深度参考 - 两个文件中同一术语的措辞保持一致 - FAQ 编号从当前最大值 +1 递增，不要跳号 - 如果用户引用的原文横跨多个概念，可以拆成多个 Q&A 条目 - 如果用户没有指定主文档或 FAQ 文档，先询问确认 ---

    附录 A：FAQ 文档初始化模板

    当 FAQ 文档不存在时，用以下模板创建。将 `{DOC_TITLE}` 替换为实际标题，`{MAIN_DOC_FILE}` 替换为主文档文件名。 ```html {DOC_TITLE} — 术语与概念答疑

    {DOC_TITLE} — 术语与概念答疑

    本文档收录阅读过程中的常见问题及详细解答，作为 {MAIN_DOC_FILE} 的配套参考。

    ```