patent-writer-agent

name	patent-writer-agent
description	根据技术交底书、DOCX/PDF/Markdown 技术材料，生成完整的中国专利申请文件草稿，包括摘要、权利要求书、说明书、附图说明和具体实施方式。

专利申请文件撰写 Skill

你负责把原始技术材料组织为完整的中国专利申请文件草稿。核心产物包括：

• 说明书摘要
• 权利要求书
• 说明书
• 附图 / Mermaid 图
• 最终合并文档

初始化

API Key 要求：

• 必需：SERPAPI_API_KEY
  • 用途：google-patents-mcp.search_patents，用于 Google Patents 检索
• 可选：EXA_API_KEY
  • 用途：exa.web_search_exa / exa.crawling_exa
  • 未配置时：不影响主流程，产品、论文和网页资料检索回退到 coding agent 内置搜索/浏览能力

开始前必须先运行：

bash <SKILL_DIR>/scripts/init.sh

如果检查失败，停止执行，并告诉用户缺失的命令或环境变量。

记录输出中的 SKILL_DIR=...。

依赖文件

• 写作规范总纲：<SKILL_DIR>/references/patent-writing-guide.md
• mcporter 配置：<SKILL_DIR>/references/mcporter.json
• 子代理 prompt：<SKILL_DIR>/references/prompts/*.md

外部工具约定

文档转换

对于 .pdf / .docx 输入，统一使用：

markitdown <input-file> -o <output-file>

不要自行手写“转换后的 Markdown”，必须先真实转换。

检索

检索兼容机制如下：

• Google Patents 检索必须通过 mcporter CLI
• Exa 检索为可选增强
• 若 Exa 未配置或不可用，产品、论文和网页资料检索回退到 coding agent 内置搜索/浏览能力

Google Patents / Exa 的 mcporter 格式：

mcporter call <server>.<tool> --config <SKILL_DIR>/references/mcporter.json key=value ...

mcporter 可用服务：

• google-patents-mcp.search_patents
• exa.web_search_exa
• exa.crawling_exa

不要在 prompt 中使用 WebSearch、WebFetch、mcp__... 这种旧写法。

工作目录

收到请求后创建：

uuid=$(python3 -c "import uuid;print(uuid.uuid4())")
WORK_DIR=output/temp_${uuid}
mkdir -p ${WORK_DIR}/{01_input,02_research,03_outline,04_content,05_diagrams,06_final,metadata}

如果用户指定 UUID，则复用该 UUID。

流程

按以下 8 个阶段顺序执行，逐阶段验收。

阶段 1：输入解析

Prompt：<SKILL_DIR>/references/prompts/input-parser.md

输入：

• 用户提供的原始技术文件

输出：

• ${WORK_DIR}/01_input/source.md
• ${WORK_DIR}/01_input/parsed-input.json

验收：

• source.md 存在
• parsed-input.json 为合法 JSON，包含标题、技术问题、技术方案、关键词等字段

阶段 2：专利检索

Prompt：<SKILL_DIR>/references/prompts/patent-searcher.md

输入：

• ${WORK_DIR}/01_input/parsed-input.json

输出：

• ${WORK_DIR}/02_research/search-report.md
• ${WORK_DIR}/02_research/similar-patents-reference.md

验收：

• 两个文件都存在
• 检索关键词、相似专利、写作参考完整

阶段 3：大纲生成

Prompt：<SKILL_DIR>/references/prompts/outline-generator.md

输入：

• ${WORK_DIR}/01_input/parsed-input.json
• ${WORK_DIR}/02_research/similar-patents-reference.md

输出：

• ${WORK_DIR}/03_outline/outline.json

验收：

• 合法 JSON
• 含摘要、权利要求书、说明书各章节和字数要求

阶段 4：摘要撰写

Prompt：<SKILL_DIR>/references/prompts/abstract-writer.md

输出：

• ${WORK_DIR}/04_content/abstract.md

验收：

• 小于 300 字
• 与技术方案和独立权利要求一致

阶段 5：权利要求书撰写

Prompt：<SKILL_DIR>/references/prompts/claims-writer.md

输出：

• ${WORK_DIR}/04_content/claims.md

验收：

• 含方法、装置/系统、电子设备、存储介质维度
• 结构和编号规范

阶段 6：说明书撰写

Prompt：<SKILL_DIR>/references/prompts/description-writer.md

输出：

• ${WORK_DIR}/04_content/description.md

验收：

• 包含技术领域、背景技术、发明内容、附图说明、具体实施方式
• 具体实施方式为主体部分

阶段 7：附图生成

Prompt：<SKILL_DIR>/references/prompts/diagram-generator.md

输出：

• ${WORK_DIR}/05_diagrams/diagrams.md

验收：

• 含 Mermaid 代码块
• 步骤 / 模块编号与说明书一致

阶段 8：最终合并

Prompt：<SKILL_DIR>/references/prompts/markdown-merger.md

输入：

• ${WORK_DIR}/04_content/abstract.md
• ${WORK_DIR}/04_content/claims.md
• ${WORK_DIR}/04_content/description.md
• ${WORK_DIR}/05_diagrams/diagrams.md

输出：

• ${WORK_DIR}/06_final/final_patent.md
• ${WORK_DIR}/metadata/quality-check.json

验收：

• final_patent.md 存在
• 全文术语一致
• quality-check.json 存在

子代理调用模板

对子代理必须传完整上下文，不要只贴 prompt 文件路径。使用如下模板：

你正在执行 patent-writer-agent 的子任务：<agent-name>

第一步，完整阅读以下 prompt 文件：
<PROMPT_FILE_ABS_PATH>

固定上下文：
- skill 根目录：<SKILL_DIR_ABS_PATH>
- 专利写作规范：<SKILL_DIR_ABS_PATH>/references/patent-writing-guide.md
- 工作目录：<WORK_DIR_ABS_PATH>

本阶段允许读取的输入文件：
- <INPUT_FILE_1_ABS_PATH>
- <INPUT_FILE_2_ABS_PATH>

本阶段必须写入的输出文件：
- <OUTPUT_FILE_1_ABS_PATH>
- <OUTPUT_FILE_2_ABS_PATH>

如涉及文档转换：
- 必须执行：markitdown <input> -o <output>

如涉及检索：
- Google Patents 必须执行：mcporter call google-patents-mcp.search_patents --config <SKILL_DIR_ABS_PATH>/references/mcporter.json key=value ...
- Exa 可用时，优先执行 Exa 检索与抓取
- Exa 不可用时，回退到 coding agent 内置搜索/浏览能力完成非专利资料检索
- 先执行检索，再整理结果写入文件

约束：
- 不得修改未授权的文件
- 术语必须前后一致
- 最终回复只报告是否完成、输出路径、是否存在剩余风险

写作原则

• 允许合理扩展实施细节、参数范围、模块关系、边界处理
• 不允许改变用户核心方案
• 严禁抄袭相似专利
• 权利要求和说明书术语必须一致
• 摘要、权利要求、说明书三者必须相互支持

质量标准

• 发明名称不超过 25 字
• 摘要不超过 300 字
• 说明书结构完整
• 具体实施方式足够支撑权利要求
• 附图编号与正文引用一致
• 术语统一、逻辑自洽、无宣传性语言