# Doc Gap Filler

> Fill in missing content like 【待补充】or placeholders in documents based on reference materials and templates. Use whenever the user mentions completing a partially-filled report, contract attachment, project acceptance document, or application form using source materials; when they say "fill in the blanks", "complete the missing parts", or "refer to the contract to finish this section"; or when they provide a document alongside reference materials (contracts, specifications, data records) and need the gaps filled with factually accurate and contextually appropriate content.

- Skill: `finger88/doc-gap-filler` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add finger88/doc-gap-filler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/finger88/doc-gap-filler/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: finger88 (https://skillmd.com/u/finger88)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/finger88/doc-gap-filler

---


# doc-gap-filler

帮助用户根据参考资料补全文档中的缺失内容（如【待补充】、空白占位符等），并生成可直接使用的可编辑文档。

使用场景：工作汇报、项目验收材料、合同附件、申报书等，当文档部分内容已填写，剩余部分需根据原始资料（合同、规范、数据记录等）和/或参考模板补全时触发。

---

## 触发条件

用户意图符合以下任一情形时调用本 Skill：
- 文档中存在「待补充」「待填写」「【 】」「[xxx]」等占位标记需要填充
- 用户提供了「待补全文档 + 参考资料」的组合
- 用户说"参照前面写好的部分，把后面的补全"
- 需要基于合同/规范/原始数据，生成报告中的对应章节

---

## 执行步骤

### 1. 文件诊断
- 遍历用户提供的文件，识别真正的**可编辑源文档**
- 排除扫描版/图片版文档（即使后缀是 .docx，若正文为图片嵌入则不可编辑）
- 若源文档为 .doc 等旧格式，需转换或重新生成 .docx

### 2. 定位缺失位置
- 读取源文档全文，标记所有待补全位置
- 分析每个缺失位置所在的上下文结构（标题层级、段落序号、表格单元格等）
- 统计缺失项数量和分布

### 3. 学习参考模板
- 若文档中存在已完成部分，仔细分析其：
  - **结构模式**：段落组织、条目编号、层级关系
  - **语言风格**：公文语气、专业术语、固定句式、时间表述方式
  - **信息密度**：每段覆盖的内容范围、详略程度
  - **格式特征**：字体、缩进、表格样式、对齐方式
- 将观察到的模式整理为隐式的"写作模板"

### 4. 提取与映射参考资料（事实性 + 延展性）
- 读取用户提供的参考资料（合同、规范、数据表、会议纪要等）
- **准确切块**：根据章节标题、项目编号、关键词，将参考资料精确切分为与待补全位置一一对应的信息块
- **事实提取**：从对应切块中提取关键事实：时间、金额、工作内容、成果要求、责任方、技术指标等
- **延展关联**：识别参考资料中的关联信息（如一个子项目的工期会影响另一个子项目的进度描述，或合同总条款对具体验收计划有约束），将这些延展性信息纳入对应位置的填充内容
- **冲突校验**：若不同参考资料对同一事实存在矛盾，优先以最新、最权威的文件为准，必要时向用户确认

### 5. 整合优化与合理推断
- **基于理解的整合**：不是简单拼接原文，而是基于对上下文结构（文档角色、段落功能、语气节奏）和参考资料内容（技术内涵、逻辑关系）的理解，对提取的信息进行重组、提炼和转写，使其既忠实于原文事实，又自然融入目标文档的表达方式
- **真实准确 + 合情合理**：
  - **真实准确**：填充内容必须有明确的资料来源，数字、日期、专有名词不得捏造
  - **合情合理**：对于无法直接从参考资料中找到的内容，基于以下逻辑进行合理推断：
    - **时间推断**：根据合同期限和当前日期推断合理进度（如外业已结束、内业进行中）
    - **逻辑推断**：根据工作流程的先后顺序推断当前阶段
    - **惯例推断**：参考同类型项目的常规表述
- **推断结果必须在生成内容中自然体现，但不向用户过度解释推断过程**
- 若存在重大不确定信息，先向用户确认再填充

### 6. 生成完整文档
- 将补全后的内容按照学习到的模板风格写入文档
- 保持原有已完成部分**一字不改**
- 确保新旧内容在语气、格式、结构上完全一致
- 优先输出为 **.docx** 格式；若源文档为其他格式（如 .md、.txt），按用户要求或同格式输出

### 7. 输出说明
- 向用户报告：补全了哪些位置、依据了哪些资料、做了哪些合理推断
- 说明生成文件的路径

---

## 注意事项

- **不改动原文**：除非缺失位置本身需要替换，否则不修改用户已完成的内容
- **风格优先**：若参考资料的表述过于口语化或技术化，需按照参考模板的公文风格进行转写
- **格式还原**：尽量保留源文档的字体、字号、行距、缩进、表格结构
- **多对一映射**：一个待补全位置可能需要从参考资料的多个章节中提取信息并整合
- **扫描版陷阱**：遇到后缀为 .docx/.pdf 但无法选中文字的文档，高度怀疑是扫描版，需主动告知用户

---

## 输出格式

向用户返回时包含以下结构：

1. **补全概览**：待补全项数、已补全项数、主要依据
2. **推断说明**：基于时间和逻辑的合理推断简述
3. **文件路径**：生成文档的完整路径