中国专利交底书助手
从项目文档到可交付的技术交底书,或把复杂专利读成通俗笔记与知识图谱。
证据:技能声明允许的工具包括 Bash、WebSearch、读写等,并明确要求按步骤读取 prompt 文件;对查新和 PDF 下载规定了固定脚本(cnipa_epub_search.py、fetch_patent_pdf.py),并禁止会话内现写下载脚本;对敏感数据处理有脱敏要求;迭代时另存新文件,不覆盖旧稿。扣分:未明确告知用户数据流向(如查新结果如何上传、是否仅本地处理),也未提供撤销或回滚机制;依赖 Playwright 等第三方工具,未说明供应链安全审查。信任维度存在主要风险可见但未完全解决,故给 12 分。
证据:技能提供了详细的步骤说明和工具表,但未包含任何可执行的测试或 CI 配置;虽有测试文件(tests/test_cnipa_epub_chain.py 等),但仅覆盖部分工具,且未在仓库中提供 CI workflow 脚本;happy path 行为有描述,但异常处理(如网络失败、文件缺失)的反馈机制不够明确。扣分:无法通过静态阅读确定关键路径可复现,缺少对失败场景的详细说明。故给 8 分。
证据:技能明确区分两种模式(交底书编写与专利解读),并给出了触发条件和目标场景;中文支持和从中国大陆网络访问国知局(cnipa.gov.cn)的能力是核心功能;对边界条件有说明(如当提供专利号时优先进入解读模式)。扣分:未详细说明能力边界(如不支持哪些专利类型),且国知局服务的可用性未经验证,若核心功能依赖不可达的海外服务则需扣分,但此处国内服务为主,故给 10 分。
证据:仓库包含 README、INSTALL.md、LICENSE(MIT)、示例目录(examples/)、详细文档(docs/)、prompts 映射表;版本号在 SKILL.md 中为 v2.0.0;未提供 changelog 但文档齐全。扣分:未提供维护责任和更新路径的明确说明,也未提供 FAQ;版本号仅出现在 SKILL.md,未在仓库其他位置统一。故给 10 分。
证据:技能声称能够生成技术交底书和专利解读笔记,并提供了示例(examples/),但未提供可验证的产出样例或证据表明其输出可直接使用;价值主张清晰(省时、可交付),但边际价值(相对手动)缺乏证据。扣分:静态阅读无法验证产出质量,上限为 7 分,故给 7 分。
证据:仓库包含多个测试文件(tests/test_cnipa_epub_chain.py 等),覆盖部分工具模块,可视为可审计的初级材料,但未提供 CI 配置或第三方执行证据;关键声明(如自动 bootstrap、查新成功率)缺乏独立验证。扣分:测试覆盖范围有限,且无独立复现结论,故给 4 分。
- 技能依赖国知局网站(epub.cnipa.gov.cn),若该服务不可达或网络受限,查新步骤会降级为 WebSearch,需确认替代方案的可靠性。
- 推荐安装 Obsidian 并进行完整配置,但未提供降级路径的详细保障(如 outputs/ 目录的使用说明不充分)。
- 工具链依赖 Playwright 和 Node.js,安装复杂且体积大;若用户环境受限,可能无法使用核心功能。
- 技能声称自动 bootstrap Obsidian 库,但未提供该过程的验证或回滚方法。
这个 Skill 能做什么,适合哪些场景?
该技能面向中国专利,提供两种模式:模式A从项目文档挖掘专利点,完成联网查新(优先国知局公布公告站)、脱敏成文(支持mermaid图形和Word导出)与自检闭环;模式B将已有专利(公开号或PDF)解读为通俗叙事、权利要求树与Obsidian知识图谱。技能包含分步提示词、Python工具(如Office转Markdown、EPUB检索、图表渲染),并支持交底书的迭代修订(合并/纠错)与留档。安装需按AgentSkills约定放置目录,并安装Python与可选Node.js依赖。
读取项目文档(支持.docx/.pptx转换)、扫描代码与设计文档,分析候选专利点;调用cnipa_epub_search.py(优先)或WebSearch进行现有技术检索;按模板生成脱敏的技术交底书(含mermaid系统框图/流程图),并渲染PNG、导出.docx;执行内部自检清单;支持对已有交底书进行合并或纠错并另存新文件,记录修订对话;对已有专利,提取文本(可自动下载PDF)、构建权利要求树、生成通俗叙事与Obsidian笔记(自动Bootstrap CSS/Canvas)。
- 研发人员:有项目设计文档和代码,想梳理专利点并撰写交底书时,用自然语言触发技能。
- 专利工程师:需要联网查新(优先国知局)并生成带有系统框图、流程图的Word交底书。
- 交底书迭代:在已有交底书文件上补充材料或纠错,技能自动识别意图并另存新版本。
- 技术爱好者:拿到一个专利公开号或PDF,想快速理解其核心内容并生成知识图谱笔记。
- 知识管理用户:希望将多个专利解读链接到Obsidian库,生成关联Canvas图谱。
这个 Skill 有哪些优点和局限?
- 覆盖交底书全流程:挖掘、查新、成文、自检、迭代。
- 查新优先国知局官方站,减少依赖搜索引擎。
- 支持Office文档转换,集成mermaid图形与docx导出。
- 迭代模式自动识别,另存新文件并记录修订历史。
- 模式B生成Obsidian知识图谱,适合个人知识管理。
- 主要针对中国专利,国际专利或非中文材料支持有限。
- 国知局查新依赖Playwright与网络,可能失败而回退到WebSearch。
- 未提供自动化测试套件,可靠性依赖实际运行。
- Obsidian集成强烈推荐配置vault路径,否则降级为输出文件。
- 部分功能(如Node.js渲染)需要额外安装,初次配置成本较高。
如何安装这个 Skill?
将克隆的仓库目录放到Claude Code或Cursor的skills路径(如.claude/skills/patent-disclosure-skill)。在项目根目录运行pip install -r requirements.txt;如需国知局查新,再运行pip install -r tools/requirements-cnipa.txt和python -m playwright install chromium;如需mermaid渲染,安装Node.js并在tools目录执行npm install或使用npx mmdc。详细参考INSTALL.md。
如何使用这个 Skill?
在Agent对话中自然语言描述需求,例如:“请基于项目路径/path/to/project写一份技术交底书”或“解读专利号CN12345678A”。技能会根据意图自动选择模式A或B。也可使用斜杠命令(如/patent-disclosure-skill)。建议在提示中提供项目路径或技术主题。