前言¶
研發立項、申請前評估或產品上市前，團隊往往要在專利庫裏做 Bool 檢索、覈對公開號、再整理查新或 FTO 材料。這些步驟分散在數據庫界面、表格和 Word 之間，檢索式、法域和證據鏈也容易在交接時丟失。若希望對話式 Agent 按固定流程調用 PatSeek、輸出帶檢索依據的報告，而不是泛泛“搜幾篇專利”，可以安裝社區 Skill patseek（座標 @user_c3d1402c/patseek），把 API 檢索與 SKILL.md 裏的工作流綁在一起。
這是什麼¶
patseek 是 SkillHub 上的 professional 類社區 Skill，當前版本 1.0.0，由發佈者 user_c3d1402c 維護。它通過 PatSeek API 完成專利號/申請人/關鍵詞 Bool 檢索、國際專利檢索、語義檢索和專利詳情覈對，並圍繞可專利性查新、FTO/侵權風險、技術調研生成可複覈報告。SkillHub 頁面標註 requires_api_key=true，使用前需自行配置 PatSeek API Key。
在 SkillHub 上，該 Skill 評分 100000，下載 1326 次（數據以 SkillHub 列表爲準）。
核心功能¶
以下能力均來自官方簡介與安裝包內 SKILL.md，可按任務類型路由：
| 用戶意圖 | Skill 內路由 | 參考文檔 |
|---|---|---|
| 查新、新穎性、創造性 | 可專利性檢索 | references/novelty_search_workflow.md |
| FTO、侵權風險、上市避雷 | FTO 檢索 | references/fto_workflow.md |
| 競品、技術路線、行業調研 | 技術調研 | references/technology_research_workflow.md |
| 已知公開號或簡單關鍵詞 | 直接檢索 | SKILL.md 命令章節 |
檢索與覈對層面，Skill 明確支持：
- Bool 檢索：支持
AP（申請人）、IPC、PID（公開號）、AN（申請號）、日期字段、NOT、CC（world 庫公開號前綴）等；中國庫與國際庫（--market world）分開使用。 - 專利詳情：按公開號拉取詳情；文檔說明詳情緩存約 12 小時，法律狀態僅作篩查，不替代官方法律狀態登記簿。
- 語義檢索：以中國庫爲主，用於召回不同術語的候選；文檔要求不把相似度直接當作新穎性或侵權結論。
- 報告與閘門：包內提供
scripts/decision_gates.py、scripts/report_guard.py及多份references/工作流，用於證據表、結論紀律和 Markdown 報告校驗。
不適用：普通外觀設計圖像檢索。Skill 也說明不提供無效證據檢索或專利權穩定性分析，收到相關請求時應說明邊界。
安裝與啓用¶
下面介紹在常見 Agent 環境中的安裝方式。安裝說明以 SkillHub 安裝文檔 爲準。
1、安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可執行完整安裝腳本（文檔提供 curl 方式，見上述安裝頁）。
2、安裝 patseek 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向 Agent 實際識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被加載。
skillhub install patseek --namespace user_c3d1402c --dir <你的 skills 目錄>
SkillHub 頁面亦提示：可讓 AI 根據 https://skillhub.cn/install/skillhub.md 安裝 @user_c3d1402c/patseek。
常用路徑示例（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
不同客戶端目錄不同，以你當前環境爲準。安裝後通常需重啓或刷新 Agent 方能加載新 Skill。
3、配置 PatSeek API Key¶
Skill 要求通過環境變量傳入 Key，避免寫入 shell 歷史：
export PATSEEK_API_KEY=ps_你的Key
涉及未公開技術時，SKILL.md 會提示：完整方案會發送到 PatSeek；可用 --no-call-log 或 PATSEEK_DISABLE_CALL_LOG=1 控制本地調用統計，但 API 側緩存仍可能保留響應，敏感任務結束後需自行清理 ~/.cache/patseek/。
典型用法¶
安裝完成後，Agent 應讀取 Skill 目錄下的 SKILL.md。人工或通過 Agent 調用時，核心入口是包內腳本 scripts/patseek_client.py（將 <skill-dir> 替換爲實際安裝路徑）。
查看幫助：
python3 <skill-dir>/scripts/patseek_client.py --help
Bool 檢索（中國庫示例）：
python3 <skill-dir>/scripts/patseek_client.py bool '(固態電池 OR 全固態電池) (熱管理 OR 溫度控制) (相變材料 OR 冷卻流道 OR 熱失控預警)' --page-size 20
國際庫與 CC 過濾（文檔註明 CC 只過濾公開號前綴，不代表 FTO 法域有效性）：
python3 <skill-dir>/scripts/patseek_client.py bool '(solid-state battery) (thermal management) (phase-change material OR cooling channel) CC=(US OR EP)' --market world --page-size 20
專利詳情：
python3 <skill-dir>/scripts/patseek_client.py patent CN118658342A
python3 <skill-dir>/scripts/patseek_client.py patent US10234567B2 --market world
語義檢索（僅中國庫，示例含保密參數）：
python3 <skill-dir>/scripts/patseek_client.py semantic '完整且去標識化的技術描述' --timeout 180 --no-call-log
多任務語義批量時，Skill 提供 scripts/semantic_batch.py，通過 JSON/JSONL 任務文件與檢查點斷點續跑（詳見 SKILL.md 語義檢索章節）。
在對話場景中，用戶提到專利檢索、查新、FTO、競品分析、SEP、PCT/US/EP/JP/KR 等關鍵詞時，Agent 會按 description 與任務路由表選擇流程；費用以 API 返回的 credits_charged 爲準。
適用場景與注意¶
適合誰
- 企業 IP、研發或技術經理：需要結構化查新、FTO 預篩或技術路線調研，且希望報告裏保留檢索式、法域與限制說明。
- 高校團隊與成果轉化：涉及可專利性評估或佈局掃描（製藥/化學/生物、通信標準等場景需額外讀
references/special_domain_gates.md）。
使用注意
- 任務類型不可混用：不得用可專利性查新流程替代 FTO；兩類結論模板在
SKILL.md中分開約定。 - 法律結論邊界：PatSeek 是文獻召回工具，Skill 禁止輸出“已具備新穎性”“無侵權風險”等保證性表述，須使用文檔中的限定句式。
- 數據覆蓋：非專利文獻、同族成員、審查檔案、各國官方法律狀態需外部覈驗；Skill 要求在未覆蓋項上明確標註。
- 檢索質量：Bool 檢索有命中規模與“條件可觀察性”閘門，過寬結果（如顯示 10,000 上限）不得直接進入候選池做法律分析。
- 外觀設計：普通外觀設計圖像檢索不在本 Skill 範圍內。
結尾¶
patseek 把 PatSeek API 與查新、FTO、技術調研三套工作流寫進標準 SKILL.md，適合希望在 Agent 對話中完成專利檢索並留下可複覈證據鏈的團隊。安裝與座標見 SkillHub：
- 頁面：https://www.skillhub.cn/skills/user_c3d1402c/patseek
- API 條目：https://api.skillhub.cn/user_c3d1402c/patseek
