| name | tao-patent-disclosure |
| description | 从真实项目文档与代码挖掘专利点并生成中文技术交底书全流程。当用户提到"专利挖掘""专利点""技术交底书""交底书""专利交底书""查新""现有技术对比""专利申请材料"时使用。 分步引导：扫描项目文档/代码挖掘候选专利点 → 讨论融合与选定 → 联网查新(优先国知局 cnipa，异常退化 WebSearch) → 摘要预览 → 按脱敏模版生成交底书(.md + .docx，系统框图/流程图用 mermaid) → 内部自检(逻辑闭环+公式参数一致性，不写入正文)。 支持迭代模式：按用户自然语言意图在已有交底书上增量合并或纠错，另存带时间戳新稿不覆盖旧稿。 技术方案只来自真实项目、绝不编造；只描述已实现功能；关键节点停下让用户确认。
|
| allowed-tools | Read, Write, Edit, Grep, Glob, WebSearch, Bash, AskUserQuestion, Agent |
| metadata | {"short-description":"专利点挖掘+查新+技术交底书生成(.md/.docx)","argument-hint":"[可选：项目路径或技术主题关键词]"} |
专利挖掘与技术交底书生成
本 skill 把一套「专利点挖掘 → 查新差异化 → 交底书生成 → 自检完善」全流程抽象为可复用工具。分步指令在 prompts/，每步执行前 Read 对应文件；查新/转换/出图脚本在 tools/。脚本是稳定资产，只负责检索、格式转换与渲染分页；行业判断、专利点提炼、交底书措辞由你（模型）阅读真实项目后决定。
铁律（违反即材料失真，务必遵守）
- 技术方案只来自真实项目源码/设计文档，禁止编造任何技术实现。 候选专利点、实施例、参数、公式、类名/表名/接口必须可回溯到真实代码或真实设计，不得为凑创新点虚构方案。
- 只描述已实现的功能。 规划中、评审中、未落地的设想不写进交底书正文（写了"技术评审中"的未来方案会成为审查与无效风险点）。
- 查新必做且必须落到正文：Step 5 优先用
tools/cnipa_epub_search.py 检索中国专利公布公告，归纳 2～8 个语义词块、分多次调用每次一词、自行按 pub_number 合并结果；abstract 规定必用并充分理解后再概括；异常或无果再退 WebSearch。查新结论与区别论述须写入交底书 1.1 与现有技术对比，不得空跑。
- 单一申请人主体：交底书只体现申请人（专利权人）及其发明人。委托方/甲乙丙方/最终用户/合作方/客户单位及其对接人一律不出现，服务对象改中立行业表述（如"面向城市治理场景"而非具体单位名）。即便实际是受托开发，对外材料也只体现申请主体。
- 公式/参数/逻辑全程一致：同一变量、阈值、公式在 3.x 各节与实施例间取值与定义必须一致；Step 8 自检须做逻辑闭环与公式参数一致性核验。
- 图示规范：3.2 系统框图、3.4 流程图用 fenced
```mermaid，不要 ASCII 文字框图/流程图；定稿用 tools/mermaid_render.py 渲染为 PNG 再转 .docx。
- 交付物文末清洁：交底书正文止于业务章节，禁止在任意位置（尤其文末）出现技能/示例仓库名、
tao-patent-disclosure、examples/ 路径、「教学示例」「虚构」「不构成法律承诺」等元脚注。
- 自检不入正文：Step 8 自检清单仅内部使用，绝不作为章节写进交底书。
- 落盘命名：凡向用户交付的定稿（首次与迭代）均为
{案件名}_{YYYYMMDDHHmmss}.md 与同名 .docx，不覆盖旧稿（除非用户书面要求）；未指定路径时建议 ./outputs/{案件标识}/，勿写 /tmp。
环境与约定
- 语言：默认与用户语种一致；专利与法律术语采用行业常用表述。
- Office 输入：扫描范围内含
.docx/.pptx 时，Step 2 阅读前先用 tools/docx_to_md.py / tools/pptx_to_md.py 转 Markdown 再读；依赖 pip install -r requirements.txt。
- 查新依赖：
tools/cnipa_epub_search.py 须 pip install -r tools/requirements-cnipa.txt 且 python -m playwright install chromium。
- 出图依赖：
tools/mermaid_render.py 失败时按 stderr 提示手动跑 tools/md_to_docx.py；mmdc 安装见 tools/README.md。
触发条件
- 明确提及：专利挖掘、专利点、技术交底书、交底书、专利交底书、查新、现有技术对比、专利申请材料等。
- 斜杠/简短指令：
/tao-patent-disclosure、/交底书。
- 迭代模式（按意图识别，不要求固定关键词，不为"是否迭代"打断用户）：用户意图明显是在已有交底书或上一轮输出上继续工作（改章节、补实施例、补材料、修正参数/事实、调表述）时，先
Read prompts/iteration_context.md，再 Read prompts/merger.md（新材料/扩展合并）或 prompts/correction_handler.md（纠错/与事实或风格不符），严格按该文件开头「执行门禁」做完，另存为 {案件名}_{YYYYMMDDHHmmss}.md 与同名 .docx，不覆盖旧稿。对话中已出现交底书路径/附件/上文刚交付草稿时，优先按迭代处理；禁止迭代意图成立时默认回到 Step 3–4 全量重挖（除非用户明确要求重新挖掘）。
Prompt 文件映射
| 步骤 | 文件 | 用途 |
|---|
| Step 1 | prompts/intake.md | 边界与输入问题 |
| Step 2 | prompts/project_scan.md | 项目文档扫描；.docx/.pptx 先转换再读；独立图片目录可跳过 |
| Step 3–4 | prompts/patent_points_analyzer.md | 候选专利点、融合与选定 |
| Step 5 | prompts/prior_art_search.md | 联网查新与分析要求（cnipa 优先，退化 WebSearch） |
| 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 |
工具映射
| 任务 | 命令 |
|---|
| Word → Markdown + 抽图（扫描前） | python3 tools/docx_to_md.py --input {path}.docx --output {dir}/{name}.md（需 pip install -r requirements.txt） |
| PowerPoint → Markdown + 抽图（扫描前） | python3 tools/pptx_to_md.py --input {path}.pptx --output {dir}/{name}.md（旧版 .ppt 先另存 .pptx） |
| 国知局查新（Step 5） | 先 Read prompts/prior_art_search.md；python3 tools/cnipa_epub_search.py，分多次调用每次一词块，自行按 pub_number 合并 EPUB_HITS_JSON；整句一次 AND 或需存 HTML 用 tools/cnipa_epub_crawler.py；异常/无果再 WebSearch |
| 交底书定稿（须同时 .md + .docx） | python3 tools/mermaid_render.py：mermaid→PNG 后生成同名 .docx；Word 失败按 stderr 跑 tools/md_to_docx.py |
| 迭代对话留档 | 每轮 merger/correction 交付后在案件目录追加 交底书修订对话记录.md（tools/iteration_dialog_log.py 或手工） |
脚本路径相对本 skill 目录；用绝对路径时用 SK=<本skill绝对路径> 前缀，如 python3 "$SK/tools/cnipa_epub_search.py" ...。
主流程（执行顺序，每步先 Read 对应 prompt）
Read prompts/intake.md → Step 1 边界与输入Read prompts/project_scan.md → Step 2 扫描（含 Office 转换后再读）Read prompts/patent_points_analyzer.md → Step 3–4 候选点、融合、选定Read prompts/prior_art_search.md → Step 5 查新（cnipa 优先），结论写入 1.1 与区别论述Read prompts/disclosure_preview.md → Step 6 摘要预览（用户可跳过）Read prompts/disclosure_builder.md 与 prompts/template_reference.md → Step 7 生成交底书；交付 {案件名}_{YYYYMMDDHHmmss}.md + 同名 .docxRead prompts/disclosure_self_check.md → Step 8 内部自检（逻辑闭环+公式参数一致性），修订后交付
禁止：交底书正文出现「自检清单」章节；自检仅内部使用。
迭代模式（摘要）
- 补材料/扩展章节：
Read iteration_context.md → merger.md；结果另存带时间戳 .md/.docx；追加 交底书修订对话记录.md；输出「合并摘要」留档。
- 纠错/与事实或参数不符：
Read iteration_context.md → correction_handler.md；结果另存带时间戳 .md/.docx；追加对话记录；输出「纠正摘要」留档。
- 新稿定稿路径上仍内部执行 Step 8 自检。
何时停下问用户（用 AskUserQuestion）
- 多个项目路径/技术主题候选需指定
- 候选专利点融合与选定方案需用户拍板
- 业务理解（行业/目标场景/核心创新）复述后需用户确认
- 查新发现高度相似在先专利、需决定差异化论述方向
- 除用户明确跳过外，摘要预览（Step 6）需用户确认再写全文
- 申请主体、发明人、关键参数/阈值不确定（过程中写
★待确认，定稿前必须 grep 清零并逐项问实值替换）
- 迭代意图判定与定稿前整体确认
Agent 自用检查清单
□ 已按步骤 Read 对应 prompts；Step 2 目录含 Office 已转换并读了产出 .md
□ 迭代意图已识别 → Read iteration_context 并选 merger/correction（未从头重挖）；交付为新 {案件名}_{时间戳}.md/.docx，未覆盖旧稿
□ merger/correction 后已输出留档摘要，案件目录已追加 交底书修订对话记录.md
□ 查新已落到 1.1 与区别论述（cnipa 分多轮单词块并合并、abstract 已用并充分理解；异常才退 WebSearch）
□ 除用户明确跳过外已做摘要预览
□ 脱敏、mermaid 已渲染 PNG、章节引用符合 template_reference；已交付 .md + .docx 且文件名含时间戳后缀
□ 单一申请主体已清；公式/参数全程一致；正文无技能/示例仓库元脚注
□ 自检在后台完成，正文无自检清单章节；grep "★待确认" 零命中
