# Doc Intake

> 接入、评估并补全既有或半成品设计文档。识别已有 spec、数据库、接口、流程图与词典产物，按五类文件结构归位并铸造 draft design-model，输出差距报告和补全任务清单，在授权范围内补全结构缺口。用于文档接入、文档整理、文档补全、差距分析、半成品文档完善；不要用于代码补全、自动补全配置或文档翻译。

- Skill: `chenychenyu/doc-intake` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add chenychenyu/doc-intake`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chenychenyu/doc-intake/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: chenychenyu (https://skillmd.com/u/chenychenyu)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chenychenyu/doc-intake

---


# 文档接入与补全

## 先确定模式

- `validate` / `review`：只读评估既有文档，输出差距报告，不修改任何文件。
- `create` / `maintain`：在用户明确给出补全范围后，补全结构缺口并复验；业务事实一律 `【待补充：说明】`+Pending，不得编造。

至少确认既有文档路径或集合。目标规范域、是否已有 design-model、允许自动补全的范围可从上下文推断；无法推断时只追问最关键的一项。

## 执行流程

1. [采集与归位](./sub/01-collect.md)：读入全部既有产物，按编码体系分类，识别不了的进「未归类区」。
2. [差距分析](./sub/02-gap-analysis.md)：逐域执行 机械验证（`wl-skills-design verify`）+ 语义判断，检测字典值漂移与名称近似漂移。
3. [补全计划与执行](./sub/03-complete.md)：差距映射为补丁任务（复用变更影响分析的 P0/P1/P2 格式），按授权范围执行并复验。
4. 报告使用 [接入差距报告模板](./templates/intake-report.md)；需要质量对照时读取 [匿名样例](./examples/01-intake-report.md)。

## 交付约束

- 默认产物：INTAKE 差距报告（对话内返回）；仅当用户明确要求保存时写入 `docs/intake/INTAKE_{项目代号}_{日期}.md`。
- 结构缺口（缺章节、缺表列、缺编码、编码不连续）可在授权范围内自动补；业务事实（字段口径、状态值、规则文案）只登记待补问题清单。
- 铸造的 draft design-model 写入 `docs/design-model.json` 前必须先展示并获得确认；与既有内容冲突时报告，不静默覆盖。
- 最终说明已采集文件数、各域差距计数、P0 断点、未归类项和补全执行状态。