Doc Intake

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

chenychenyu eced4f2 6 files · 11.3 KB Updated

File contents

文档接入与补全

先确定模式

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

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

执行流程

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

交付约束

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

chenychenyu/wl-skills-design/tree/main/files/.github/skills/doc-intake commit eced4f2514

Frequently asked questions

npx skillmds@latest add chenychenyu/doc-intake