【AI Agent实战】一个 AI Skill，帮你自动生成一份规范的专利技术交底书
一个 AI Skill，把你的代码/文档/图片/描述，自动变成一份规范的专利技术交底书（.docx）
核心思路
你的输入（代码/文档/图片/描述） ↓ AI分析理解 技术方案 + 创新点 ↓ AI撰写 专利语言内容 ↓ 代码生成 标准 .docx 交底书AI 负责"看懂"和"写清楚"，代码引擎负责"输出规范文件"——两层分工，互不越界。
四种输入，一个出口
| 模式 | 你给什么 | AI怎么用 |
|---|---|---|
| A1 代码 | 代码文件/文件夹 | 读代码 → 找架构+算法+创新点 |
| A2 文档 | PDF / DOCX / PPTX | 提取文本 → 分析技术方案 |
| A3 图片 | 架构图 / 流程图 | 视觉识别 → 转化为文字描述 |
| B 描述 | 你打字描述的方案 | 直接理解 → 补全细节 |
四种可以混合用（代码 + 架构图 + 说明文档一起扔进去）。
七个阶段
1. 信息收集 → 2. 技术分析 → 3. 大纲确认（你参与） ↓ 7. 验证输出 ← 6. 写入DOCX ← 5. 生成流程图 ← 4. 撰写内容第3阶段是唯一需要你确认的节点：AI展示各章节大纲，你同意了才继续写，改了再写——避免写完全部才发现方向不对。
核心引擎：声明式构建
最关键的设计在第6阶段。AI不直接编辑 Word 的 XML（那东西几千行，改坏了文件就废了）。
实际流程：
模板.docx ↓ unpack（解压成文件夹） unpacked/ ↓ AI写 patent_content.json ←← 这是AI真正做的事 patent_content.json ↓ patent_builder.py（自动编辑XML） unpacked/（修改后） ↓ pack（重新打包 + 校验） 最终.docxpatent_content.json是声明式描述——AI只需要写"第4.2节要放这段文字"，引擎自动搞定 XML。
JSON 描述 6 种段落类型
| 类型 | 作用 | 例子 |
|---|---|---|
text | 正文段落 | {"type": "text", "content": "步骤S1：..."} |
heading | 小标题 | {"type": "heading", "content": "4.2 技术侧"} |
formula | 独立数学公式 | {"type": "formula", "omml": "...", "num": 1} |
inline | 行内公式混排 | {"type": "inline", "parts": ["其中，", {omml}, " 为变量"]} |
image | 插图（含流程图） | {"type": "image", "path": "flowchart.png"} |
empty | 空行 | {"type": "empty"} |
数学公式用 Office 原生的 OMML 格式（不是 LaTeX），这样输出的 .docx 公式在 Word 里可以直接编辑。
流程图：Mermaid → PNG → 插入文档
mermaid（源文件）→ mmdc 渲染 → PNG → 自动插入 .docx
AI 写 Mermaid 语法，脚本自动渲染成高清 PNG，再通过 JSON 的image类型注入文档。流程图节点和第4.2节的步骤编号（S1、S2…）一一对应。
增量修改：不用重头来
改某个章节？只改patent_content.json里对应的段落，再跑一次 builder + pack，不需要重新分析和撰写。
一句话总结
patent-writing Skill = AI理解输入 + AI写专利语言 + 代码引擎生成规范Word文档
你提供素材，它负责翻译成专利能看懂的语言，然后自动打包成能交给专利代理人的文件。