安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install patent-portfolio-planning
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 patent-portfolio-planning。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Patent Portfolio Planning 是一款由 PatentMax 驱动的 Openclaw Skills 工具，用于决定下一步研发方向以及如何组织相关专利申请。在提供所需技术主题（以及可选的商业约束）后，它通过专利拥挤度、潜在绕障空间和技术成熟度来比较备选路线，随后推荐组合优先级、申请时机和预算分配。
该技能异步运行，并可导出 Word 报告以供交付。其建议属于技术与商业参考，并非法律意见，也不保证自由实施（FTO）、可专利性或设计绕障成功。请咨询具备资质的专利专业人员以获取法律分析。
Patent Portfolio Planning · PatentMax 应用场景
在备选技术路线之间进行选择或设定研发优先级。
规划优先申请哪些发明、哪些可以暂缓，以及如何使申请计划与预算或申请目标相匹配。
当竞争对手的专利可能限制产品或技术时，探索潜在的设计绕障方向。
协调申请时间表与计划中的发布、公开、展会或投标截止日期。
将现有的专利、产品、技术优势、证据和保密限制与前瞻性的专利组合规划链接起来。
当用户询问下一步该怎么做时使用；如果问题仅侧重于竞争对手在做什么或特定创意是否有现有技术，请使用独立的情报或搜索能力。
Patent Portfolio Planning · PatentMax 工作原理
识别必需输入：简明技术主题。如果不明确，请提示用户澄清。其他输入均为可选，除非用户主动提供，否则无需追问。
收集任何相关的可选决策上下文，例如备选路线、预算、申请量、现有资产、证据、市场、公开时机和保密边界。
说明该任务为付费项目，并在执行前获得用户确认。仅在确认后才添加明确的 --yes 标志。
使用 roadmap CLI 将请求提交至 PatentMax 服务。任务异步运行；--wait 会轮询等待完成并在 stderr 上汇报进度与阶段。
如果等待超时，切勿重新提交任务。使用 status --operation-id 检查其现有操作；仅在收到明确请求时才予以取消。
审阅路线偏好、组合排序、风险区域、申请节奏和质量状态等结果。突出数据局限性，并警告申请应先于公开披露。
交付核心结论，并在需要时下载生成的 Word 文档报告。在提供建议时带上适当的法律和数据覆盖范围保留声明。
Patent Portfolio Planning · PatentMax 配置指南
该技能使用位于 https://api.ip930.com 的 PatentMax API 和控制台。SKILL.md 指定了一个打包在 scripts/patentmax_roadmap.py 的 CLI；它不提供单独的包安装命令。请在技能安装目录下运行命令。
首次使用无需 API key：如果缺少 PATENTMAX_API_KEY，脚本会自动申请免费试用并将其保存在本地 ~/.patentmax/ 下。记录的试用额度仅限于此技能，共计 ¥40，有效期 30 天。如果已配置 key，脚本将使用该 key 而非申请试用。请将自动试用通知转告用户。如果试用额度耗尽或过期，请原样传达 CLI 返回的错误信息。
该任务为付费项目。在运行 create 之前，请告知价格并获得用户确认；命令中必须包含 --yes。

Inspect optional business-context fields

python scripts/patentmax_roadmap.py fields

Create a roadmap using the required technology topic

python scripts/patentmax_roadmap.py create
--subject "Sodium-ion battery cathode materials"
--wait --yes

Optional: provide a decision objective, context file, and target markets

python scripts/patentmax_roadmap.py create
--subject "Sodium-ion battery cathode materials"
--objective "Compare layered oxides with polyanion compounds"
--context-file ./context.json
--markets "CN,US"
--wait --yes

Resume checking an existing asynchronous operation

python scripts/patentmax_roadmap.py status --operation-id

Download the Word report

python scripts/patentmax_roadmap.py download
--report-id --out technology-roadmap.docx

Cancel an operation

python scripts/patentmax_roadmap.py cancel --operation-id
Patent Portfolio Planning · PatentMax 数据架构与分类体系
输入与上下文
必需输入为 --subject，包含技术名称或主题——而非完整的请求句子。可选的 CLI 输入包括 --objective、--context-file、--markets、--materials 以及 --materials-file。业务上下文可以通过 JSON 使用以下可选字段提供：
字段 作用
future_plan 未来一到三年的规划工作
existing_assets 现有专利、产品线和技术能力
own_advantages 相对于竞争对手的优势
known_risks 怀疑存在的专利冲突或风险领域
evidence_data 实验数据、参数及验证结果
disclosure_timing 计划的发表、展会或投标日期
filing_preference 申请偏好，例如发明或实用新型申请、国内或 PCT
budget_and_volume 计划的申请数量和预算
confidentiality_limits 绝不能出现在公开文档中的材料
excluded_directions 明确排除在范围之外的方向
任务状态与输出
CLI 会返回一个用于追踪异步任务的 operation_id 以及用于下载报告的 report_id。
可下载的交付物是一个 Word .docx 报告。调用方可以提供上下文 JSON 文件；技能未指定单独生成的上下文文件格式。
如果未提供 --idempotency-key，CLI 将根据请求自动生成一个，以确保相同的重试不会创建重复任务或产生额外费用。
未配置 API key 时，自动试用凭证将保存在本地 ~/.patentmax/ 中。
结果可能包含 quality_status；当其非 qualified 时，请说明缺少哪些数据以及这会如何限制置信度。
请在其限定的数据库、管辖区、日期和检索范围内解读专利结论。未公开的申请、数据库缺漏和术语差异都可能影响覆盖范围。
Patent Portfolio Planning · PatentMax 高级特性
支持通过 --wait 进行异步执行、进度汇报以及 10 到 60 秒退避式轮询；文档记录的默认最大等待时间为 90 分钟。
status
cancel
恢复检查或取消现有操作；超时并不代表失败，因此请检查状态而非重新提交。
自动幂等 Key 有助于防止在相同重试时创建重复任务和扣费。
可选的业务上下文字段允许团队将建议定制匹配至计划、资产、预算、市场、申请偏好、公开截止日期和保密限制。
支持导出 Word 报告，提供超越交互式问答的交付物工作流。
建议应给出明确的路线偏好，并将申请优先级与预算和时机挂钩，同时指出质量局限性和专利风险。
务必提示申请前公开披露的风险。切勿承诺某种路线零风险、已规避所有阻碍性专利或专利必定获得授权；法律结论需由专利专业人员提供。

name: patent-portfolio-planning description: 技术路线分析与专利布局建议。当用户问下一步该往哪个方向研发、专利该怎么布、哪条技术路线更值得走、怎么绕开竞争对手的专利、申请预算该怎么分配，或要一份可交付的技术路线与布局方案时使用。无需 API Key，首次使用自动领取免费试用。Use when the user asks which technology route to take, how to plan a patent portfolio, or how to design around competitors' patents. Works without an API key: a free trial is claimed automatically on first use. version: "1.0.0"
author: PatentMax
user-invocable: true
argument-hint: "[技术方向 / 决策问题]"
allowed-tools: Bash, Read, Write

专利布局规划 · PatentMax

回答「下一步该往哪走」：几条候选技术路线各自的专利拥挤度和绕行空间、你的方案该往哪个方向延伸、专利该怎么排布、什么时候申请、预算怎么分配。异步生成，可导出 Word 文档直接交付。

数据来自 PatentMax 专利库。

接口与控制台：https://api.ip930.com

不需要 API Key 就能用。 没设 PATENTMAX_API_KEY 时，脚本第一次运行会自动领取一份免费试用（累计 ¥40 额度、30 天有效，只开通本技能的功能），存在本机 ~/.patentmax/，之后自动沿用。领取成功时 stderr 会打一行「[PatentMax] 已自动领取免费试用……」，把这句话转告用户。

试用用完、过期，或想用其他功能时，命令会返回带 "free_trial": true 的错误，message 里写着下一步怎么办（注册 PatentMax 再送 ¥50 体验额度），原样转告用户，不要自己换写法重试。用户设了 PATENTMAX_API_KEY 就一律用正式密钥，不会领试用。

跟「企业情报分析」的区别
企业情报分析 技术路线分析（本 Skill）
回答 现状是什么 — 谁在做、格局怎么分 该怎么做 — 往哪走、怎么布
输出 竞争格局、对手动作、我方位置 路线比选、布局建议、申请节奏
必填输入 目标企业 + 技术方向 只有技术主题

用户只想知道对手在干什么，用企业情报分析；要有人告诉他下一步怎么办，才用这个。

核心原则

必填只有一项：技术主题（--subject）。 只写技术名称，例如「钠离子电池正极材料」，不要写成「XX 的技术路线与专利布局」这种句子。用户没说清主题就先问；其余参数都可不填，用户没提不要追问。

这是付费任务，执行前必须报价并取得用户确认。 命令必须显式加 --yes。

布局建议是技术与商业参考，不是法律意见。 是否侵权、权利要求怎么写、能不能授权，要专利代理人出具意见。

不出保证性结论。 不写「这条路线没有专利风险」「绕开了所有障碍」——见「结论纪律」。

什么时候用
用户说 用不用
「我们下一步该往哪个方向研发」 ✅ 用
「这两条技术路线选哪个」 ✅ 用
「专利该怎么布，先申请哪几件」 ✅ 用
「怎么绕开 XX 公司的专利」 ✅ 用
「今年 20 件申请预算怎么分」 ✅ 用
「XX 公司在做什么技术」 ❌ 那是企业情报分析
「这个想法有没有人做过」 ❌ 那是查新
「查一下 XX 相关的专利」 ❌ 那是检索
执行前检查

只有技术主题是必须问清的。下面这些是可选项，用户主动提了就带上（写进 --objective 或业务约束），没提不要追问：

检查项 说明（可选）
技术主题（必填） 只写技术名称
决策问题 到底在纠结什么——选路线、定优先级、还是分预算
候选路线 有哪几个方案在比。只有一个方案就不是"选路线"，是布局设计
时间 什么时候要发布、参展、投标——这决定申请节奏
预算与数量 今年能申请几件。能申请 3 件和能申请 30 件，布局完全不同
现有资产 已有哪些专利、产线、技术积累，新布局要和它们接得上
保密边界 哪些参数、配方、数据不能写进公开文件
可选输入

素材（--materials / --materials-file）：技术方案、赛道背景，可不填。

业务约束（roadmap_context）：十个字段全部可选，会随任务一起保存：

字段 填什么
future_plan 未来一到三年打算做什么
existing_assets 已有的专利、产线、技术积累
own_advantages 相对竞争对手强在哪
known_risks 担心撞上谁、哪些方向有雷
evidence_data 实验数据、参数、验证结果
disclosure_timing 什么时候要发布、参展、投标
filing_preference 发明为主还是实用新型、国内还是 PCT
budget_and_volume 今年打算申请几件、预算多少
confidentiality_limits 哪些内容不能写进公开文件
excluded_directions 明确不做的领域

用 python scripts/patentmax_roadmap.py fields 可以随时打出这张表。

命令

# 最简：只给技术主题
python scripts/patentmax_roadmap.py create \

--subject "钠离子电池正极材料"
--wait --yes

# 带上可选的业务约束（写进 JSON 文件，十个字段命令行塞不下）
python scripts/patentmax_roadmap.py create \

--subject "钠离子电池正极材料"
--objective "在层状氧化物与聚阴离子两条路线中选一条"
--context-file ./context.json
--markets "CN,US"
--wait --yes

# 中途断了继续查
python scripts/patentmax_roadmap.py status --operation-id

# 下载 Word 报告
python scripts/patentmax_roadmap.py download --report-id --out 技术路线方案.docx

# 不跑了
python scripts/patentmax_roadmap.py cancel --operation-id

--idempotency-key 不填会按请求内容自动生成——同样的输入重试不会重复建任务、重复扣费。

等待期间

--wait 轮询到出结果，间隔 10 秒起退到 60 秒，默认最多等 90 分钟。进度和阶段实时打到 stderr，把这些转述给用户，让他知道任务在推进。

超时不代表失败。 任务还在服务端跑，绝对不要重新提交，用 status --operation-id 继续查。

读结果

不要整段转述，挑出这几件事：

路线怎么选。 几条候选各自的专利拥挤度、绕行空间、技术成熟度。明确给出倾向，别把选择题又丢回给用户——他就是因为选不出来才来问的。

布局怎么排。 哪几件先申请、哪些可以晚、哪些只需要实用新型、哪些值得走 PCT。要和他给的预算与数量对得上。

风险在哪。 绕不开的核心专利是哪几件（带公开号）、哪些方向已经拥挤到不值得进。

节奏怎么定。 和 disclosure_timing 对齐——公开日之前必须完成申请，否则自己的公开就成了自己的现有技术。这一条经常被忽略，要主动提醒。

质量提示要说。 quality_status 不是 qualified 时，说明哪块数据不足、建议要打几分折扣。

结论纪律

禁止输出保证性结论，例如「这条路线没有专利风险」「已绕开全部障碍专利」「可以放心实施」。

使用这类表述：

截至 [日期]，在 [数据库、地域、检索范围] 内，未检索到在 [方向] 上覆盖本方案全部必要技术特征的在先专利。本结果不排除未公开申请（约 18 个月公开窗口）、名称未归一化的关联主体、数据库缺口或术语差异造成的漏检。是否可自由实施，须结合目标国家、有效授权权利要求与官方登记簿作专项法律分析。

三条必须交代：

18 个月公开窗口 — 这期间的申请谁也查不到，竞争对手最新的布局大概率不在数据里 布局建议不是法律意见 — 权利要求怎么写、能不能授权，要代理人出具意见
公开时点是硬约束 — 自己先公开会破坏自己的新颖性，申请必须赶在公开之前
相关能力

同一把正式密钥、同一个余额（免费试用只开通本技能，其他功能要注册后用正式密钥）：

普通检索 — 关键词与字段式检索、单篇速览、相似专利、引证分析、15 维统计、企业画像
企业情报分析 — 竞争格局与对手动作，本 Skill 的上游输入
技术方案查新 — 具体某个方案有没有人做过、能不能申请

典型顺序：企业情报分析看清格局 → 技术路线分析定方向 → 查新确认具体方案 → 申请。

参考
references/context-guide.md — 十个业务约束字段怎么填，含完整 JSON 示例
references/workflow.md — 完整工作流：问什么、怎么跑、结果怎么组织成交付物
references/faq.md — 排查：参数报错、任务卡住、建议太泛、质量分档含义
专利披露 CN · PatentMax
专利搜索 · PatentMax