patent-disclosure-skill

专利挖掘与交底书生成

本技能覆盖 专利点挖掘 → 查新与差异化 → 交底书生成 → 自检完善 全流程；分步指令在 prompts/，每步执行前 Read 对应文件，与步骤的对照见「Prompt 文件映射」。

环境与约定

• 语言：默认与用户语种一致；专利与法律术语采用行业常用表述。
• 图示定稿（Step 7）：3.2/3.4 用 fenced mermaid；执行方式、mmdc 安装与降级规则见下表「交底书定稿交付」行及 tools/README.md（正文不要求 ASCII 框图或 PlantUML）。

---

触发条件

在用户使用以下任一方式时启用本技能：

• 明确提及：专利挖掘、专利点、技术交底书、交底书、专利交底书、查新、现有技术对比等
• 斜杠或简短指令：如 /patent-disclosure-skill、/patent-disclosure、/交底书
• 迭代模式（按意图识别）：当用户意图明显是在已有交底书或上一轮输出上继续工作（如改章节、补实施例、补材料、修正参数/事实、调整表述等），无需用户写出「迭代」等固定词，也不必询问是否进入迭代——Agent 应 Read prompts/iteration_context.md，再 Read prompts/merger.md（侧重新材料、扩展合并）或 prompts/correction_handler.md（侧重纠错、与事实或风格不符），严格按该文件开头的「执行门禁」（优先执行，不可跳过）做完合并或纠正，另存为新文件：{案件名}_{YYYYMMDDHHmmss}.md 与同名 .docx（与首次定稿同一命名规则，见 disclosure_builder.md §7.3 第 5 点），不覆盖旧稿（除非用户明确要求）。禁止在迭代意图已成立时默认回到 Step 3–4 专利点全文分析（除非用户明确要求重新挖掘专利点）。对话中已出现交底书路径、附件或上文刚交付的草稿时，优先按迭代处理。

---

工具与数据来源

按任务选用能力；具体工具名称以当前 Agent 环境为准。

若扫描范围内含 Word（.docx） 或 PowerPoint（.pptx），须在 Step 2 纳入阅读前用本仓库 docx_to_md.py / pptx_to_md.py 转为 Markdown；依赖 pip install -r requirements.txt，命令与说明见下表对应行。

常见任务与建议方式

任务	建议方式
加载分步指令	Read → ${CLAUDE_SKILL_DIR}/prompts/*.md，见下表
读代码、设计文档、PDF、图片	文件读取工具；大仓库先用搜索/语义检索定位再精读
Word（.docx）→ Markdown + 抽取图片（扫描前）	Bash → python3 ${CLAUDE_SKILL_DIR}/tools/docx_to_md.py --input {path}.docx --output {dir}/{name}.md；图片默认写入与 .md 同级的 {name}_media/；需 pip install -r requirements.txt（含 mammoth）；复杂版式可改由所内导出 PDF/MD 再扫
PowerPoint（.pptx）→ Markdown + 抽取图片（扫描前）	Bash → python3 ${CLAUDE_SKILL_DIR}/tools/pptx_to_md.py --input {path}.pptx --output {dir}/{name}.md；默认 {name}_media/；需 pip install -r requirements.txt（含 python-pptx）；旧版 .ppt 不支持，请先另存为 .pptx；图表/SmartArt 等若未以图片形状嵌入则可能仅能从备注或另行导出补全
罗列目录、按名找文件	目录列举 / 按文件名搜索
联网查新（Step 5）	执行前 Read prompts/prior_art_search.md。中国专利公布公告：优先 Bash 运行 cnipa_epub_search.py；须在生成命令前归纳 2～8 个相关度高的语义块；执行时须分多次调用，每次仅传一个词块，自行按 pub_number 合并多轮 EPUB_HITS_JSON（勿单次工具调用堆多个 argv，见该 prompt）。一步拉取+解析、不写 HTML 落盘；须 pip install -r tools/requirements-cnipa.txt 且 python -m playwright install chromium。abstract 规定必用同该 prompt。需整句一次 AND 或保存 HTML 时用 cnipa_epub_crawler.py；异常或无果再 WebSearch
交底书定稿交付（须同时 .md + .docx）	3.2 系统框图与 3.4 流程图均用 fenced mermaid，不要 ASCII 文字流程图/框图。定稿执行 tools/mermaid_render.py：mermaid 转 PNG（失败块保留围栏）后默认生成同名 .docx；若 Word 失败，按 stderr 提示手动运行 md_to_docx.py。详见 tools/README.md
保存交底书路径	写入用户指定路径；未指定时可建议 ./outputs/{案件标识}/；凡交付的 .md / .docx 须为 {案件名}_{YYYYMMDDHHmmss}（§7.3 第 5 点，含首次定稿与迭代），勿默认覆盖旧稿；outputs/ 整目录默认由 .gitignore 忽略
迭代对话留档	每轮 merger / correction 交付后，在案件目录追加 交底书修订对话记录.md（tools/iteration_dialog_log.py 或等价手工），见 prompts/iteration_context.md

---

Prompt 文件映射

步骤	文件	用途
Step 1	prompts/intake.md	边界与输入问题
Step 2	prompts/project_scan.md	项目文档扫描；须对 .docx/.pptx 先转换再读（见该文件「Office 文档」节）；独立图片目录可跳过
Step 3–4	prompts/patent_points_analyzer.md	候选专利点、融合与选定
Step 5	prompts/prior_art_search.md	联网查新与分析要求
Step 6	prompts/disclosure_preview.md	全文前的摘要预览
Step 7	prompts/disclosure_builder.md + prompts/template_reference.md	交底书结构、脱敏与图示规范；mermaid 系统框图与流程图范例在 template_reference
Step 8	prompts/disclosure_self_check.md	内部自检，不写入正文
迭代	prompts/iteration_context.md	迭代意图、落盘命名、修订对话记录 md（含对话/记录时间）
迭代	prompts/merger.md	新材料增量合并；文首含门禁；输出 {案件名}_{时间戳}.md/.docx
迭代	prompts/correction_handler.md	对话纠正；文首含门禁；输出 {案件名}_{时间戳}.md/.docx

---

主流程（执行顺序）

1. Read intake.md → 执行 Step 1
2. Read project_scan.md → 执行 Step 2
3. Read patent_points_analyzer.md → 执行 Step 3–4
4. Read prior_art_search.md → 执行 Step 5
5. Read disclosure_preview.md → 执行 Step 6；用户可跳过
6. Read disclosure_builder.md 与 Read template_reference.md → 执行 Step 7（首次交付的 .md/.docx 亦须 {案件名}_{YYYYMMDDHHmmss}，§7.3 第 5 点）
7. Read disclosure_self_check.md → 内部执行 Step 8，修订后交付

禁止：交底书正文中包含「自检清单」章节；自检仅内部使用。

---

迭代模式（摘要）

启用方式：根据用户自然语言意图判断（见上文「触发条件」），不要求固定关键词，默认不为「是否迭代」打断用户。

• 补充材料 / 扩展章节：Read → iteration_context.md → merger.md；合并结果另存为带时间戳的 .md/.docx（§7.3 第 5 点）；追加 交底书修订对话记录.md（iteration_dialog_log.py 或手工）；完成后必须输出「合并摘要」留档
• 指出错误 / 与事实或参数不符：Read → iteration_context.md → correction_handler.md；纠正结果另存为带时间戳的 .md/.docx；追加对话记录；完成后必须输出「纠正摘要」留档

主流程 Step 7→8 的 disclosure_self_check.md 仍在新稿定稿路径上内部执行。

---

Agent 自用工作流检查清单

□ 已按步骤 Read 对应 prompts；Step 2 若目录含 Office，已执行 docx_to_md / pptx_to_md 并读了产出 `.md`
□ 识别到「在已有交底书上修改」类意图时，已 Read `iteration_context.md` 并选用 merger 或 correction_handler（而非从头跑扫描）；交付为**新** `{案件名}_{时间戳}.md`/`.docx`，未无故覆盖旧稿
□ 执行 merger / correction_handler 后，已在对话中输出该文件要求的留档摘要（合并摘要 / 纠正摘要）；案件目录已追加 **`交底书修订对话记录.md`**（或等价日志）
□ 查新完成且写入 1.1 与区别论述（符合 `prior_art_search.md`：**优先** `tools/cnipa_epub_search.py`，**国知局侧已分多次调用、每轮一词，并已自行合并** `EPUB_HITS_JSON`；**`abstract` 必用且已充分理解后再概括**；异常或无果再 **WebSearch**）
□ 除用户明确跳过外，完成摘要预览
□ 脱敏、mermaid（定稿均已渲染为 PNG）、章节引用符合 template_reference；**已交付 .md 与 .docx**，且**文件名符合 §7.3 第 5 点**（**凡交付均含**时间戳后缀）；**正文无**技能/示例仓库类文末脚注
□ 自检在后台完成，正文无自检清单章节

---

中国专利.skill

从项目文档到可交付的技术交底书：专利点挖掘、查新优先国知局公布公告站、脱敏成文与自检闭环。

有设计文档和代码，但专利点还没梳？ 交底书要系统框图、流程图，还要代理人能直接改的 Word？ 定稿之后还要多轮补材料、纠错，并希望文件修改追溯？ 国知局公布站检索，期望 次次爬成功、精准检索？

本 Skill 按 AgentSkills 约定编排全流程，SKILL.md + prompts/ 分步可读可迭代。

功能特性 · 安装 · 使用 · 项目结构 · 示例 · 运行效果 · 参考文档 · 详细安装说明 · 技能入口

---

功能特性

能力	说明
项目扫描	按优先级读文档 / 代码；.docx / .pptx 先转 Markdown 再扫（见 prompts/project_scan.md）
专利点	候选点讨论与融合（patent_points_analyzer.md）
查新	优先 国家知识产权局 · 中国专利公布公告：使用 tools/cnipa_epub_search.py精准爬取；异常或无果时降级 WebSearch（如 Google 学术 / Patents）。著录与外链写入第一章（prior_art_search.md）
交底书成稿	脱敏模版 + mermaid 系统框图与流程图；mermaid_render.py → PNG，默认再出 .docx
交付命名	凡落盘交付：{案件名}_{YYYYMMDDHHmmss}.md 与同名 .docx（disclosure_builder.md §7.3）
自检	逻辑闭环、公式与参数一致（disclosure_self_check.md，不写入正文）
迭代	合并 / 纠正 另存新文件；交底书修订对话记录.md 逐条追加（iteration_context.md、iteration_dialog_log.py）

Office 抽取：.docx / .pptx 先用本仓库 docx_to_md.py / pptx_to_md.py 转为 Markdown 再扫描（见 SKILL.md）。

Python 依赖（分文件）：

• 基础（Office / 交底书转换）：根目录 requirements.txt — pip install -r requirements.txt
• 查新（国知局公布公告站，可选）：tools/requirements-cnipa.txt — pip install -r tools/requirements-cnipa.txt，再执行 python -m playwright install chromium
  不装亦可：Step 5 将按 prior_art_search.md 仅用 WebSearch 降级。详见 INSTALL.md、tools/README.md。

---

安装

Claude Code

请在 git 仓库根目录 或全局 skills 路径下放置本目录，使 SKILL.md 位于技能文件夹根级（与 INSTALL.md 一致）。

# 示例：安装到当前项目的 skills 目录
mkdir -p .claude/skills
git clone <本仓库 URL> .claude/skills/patent-disclosure-skill

Cursor

将本仓库完整内容放到 Cursor 约定的 skills 路径（见 INSTALL.md 表格），重启后在 Settings → Rules 中确认技能已被发现。

依赖

# 基础（Office 转换、交底书相关 Python 包）
pip install -r requirements.txt

# 可选：国知局查新（epub.cnipa.gov.cn）
pip install -r tools/requirements-cnipa.txt
python -m playwright install chromium

图示定稿另需 Node.js；在 tools/ 下执行 npm install 或使用 npx mmdc（详见 tools/README.md）。

---

使用

在 Agent 中用自然语言描述需求即可，例如：

• 专利挖掘、专利点、技术交底书、查新、现有技术对比
• 斜杠指令（视宿主配置）：如 /patent-disclosure-skill、/交底书

建议同时说明 项目路径 或 技术主题（与 SKILL.md 中 argument-hint 一致）。
查新（Step 5） 会优先通过 中国专利公布公告 检索中国专利公开信息，再按需补充其他来源；流程见 prompts/prior_art_search.md。
在已有交底书文件上补充材料或纠错时，无需说「迭代」——技能会按 merger.md / correction_handler.md 处理；细则见 SKILL.md。

---

项目结构

本仓库遵循 AgentSkills，根目录即一个 skill：

patent-disclosure-skill/
├── SKILL.md                    # 入口：触发条件、工具表、步骤与 prompts 引用
├── prompts/                    # 分步模板（Agent Read 后遵循）
│   ├── intake.md
│   ├── project_scan.md
│   ├── patent_points_analyzer.md
│   ├── prior_art_search.md
│   ├── disclosure_preview.md
│   ├── disclosure_builder.md
│   ├── disclosure_self_check.md
│   ├── iteration_context.md
│   ├── merger.md
│   ├── correction_handler.md
│   └── template_reference.md
├── tools/                      # mermaid_render、md_to_docx、docx_to_md、pptx_to_md；国知局 cnipa_epub_*（查新）；iteration_dialog_log 等
├── docs/                       # PRD、仓库结构说明、运行效果截图（效果例-*.jpg）
├── examples/                   # 原材料示例（如 example_batch_job_scheduler/knowledge/）
├── outputs/                    # 用户产出，整目录 .gitignore
├── requirements.txt
├── LICENSE
├── INSTALL.md
└── .gitignore

---

示例

虚构扫描原材料见 examples/README.md（如 examples/example_batch_job_scheduler/knowledge/）。
专利点、查新笔记、交底书等完整产物由流程生成到本地 outputs/{案件标识}/。

---

运行效果

初版生成（首次落盘交付）

迭代更新（合并/纠正后再交付，多版本并存 + 对话记录）

---

参考文档

• 技能入口与 Agent 流程（触发条件、prompts/ 映射、工具表）
• 详细安装说明（Claude Code / Cursor 路径）
• 图示与转换脚本（mermaid / mmdc、Word 导出、国知局 epub 查新工具）
• 示例案件与原材料说明
• 产品流程与目录约定
• 工程结构说明
• 交底书模版细则

---

MIT License © handsomestWei