前言¶
銷售跟進裏大量操作仍落在 NeoCRM（銷售易）裏：查客戶、改商機、寫跟進、領公海、排日程。若把這些步驟拆成「打開頁面 → 找菜單 → 填表」，Agent 只能做文案輔助，很難真正代勞。把 CRM 能力封裝成符合 Agent 閱讀規範的 Skill，並約束查詢、寫入、確認的流程，是讓模型穩定操作租戶數據的前提。下面介紹 SkillHub 上的 NeoCRM for AI Agent（座標 @user_2d23dd34/neocrm-for-ai-agent，當前版本 0.1.9）如何組織能力與前置依賴。
這是什麼¶
NeoCRM for AI Agent 是面向 AI Agent 的 NeoCRM 技能包：通過自然語言完成銷售跟進日常工作，官方頁面表述爲「銷售易 CRM 官方 AI Agent 技能包」「開箱即用」。在 SkillHub 上歸類爲 business-ops，來源爲 community，發佈者爲 user_2d23dd34；頁面標註作者爲 Jeffery。Skill 包根目錄 SKILL.md 中的定位是：讓 Agent 通過自然語言操作銷售易 CRM，並在執行任何操作前必須先閱讀並遵守 nc-base/SKILL.md 的全部規範。
技能執行依賴本機的 neocrm 命令行（neocrm-cli-client npm 包），而非在 SkillHub 側配置 API Key（標籤 requires_api_key=false）。
核心功能¶
Skill 包採用分層結構，平臺會掃描子目錄並分別加載各 skill：
| 層級 | 目錄 | 作用 |
|---|---|---|
| 基礎層 | nc-base/ |
Agent 通用行爲規範，其他 skill 的依賴 |
| 通用操作層 | nc-common/ |
跨實體的標準操作 |
| 擴展層 | nc-ext/nc-ext-*/ |
各實體場景化能力 |
| 工作臺 | nc-skillbench/ |
引導用戶基於 neocrm 命令生成個性化 skill |
通用操作（nc-common） 適用於任意 CRM 實體，包括：查詢記錄、創建記錄、編輯記錄、轉移負責人、鎖定記錄、解鎖記錄。底層命令包括 neocrm data:query、data:get、data:create、data:update、data:lock、data:unlock，以及元數據相關的 metadata:describe、metadata:busitype、metadata:objects。
已收錄的擴展 skill（根 SKILL.md 表格） 覆蓋例如：
nc-ext-account：廢棄客戶、合併客戶nc-ext-activityrecord：創建活動記錄（跟進記錄）nc-ext-feed：發佈工作圈 / 對象下動態nc-ext-opportunity：超時未跟進商機查詢nc-ext-schedule：創建關聯日程nc-ext-territory：公海領取線索、公海領取客戶、退回公海nc-ext-visit-prepare：拜訪前準備（客戶 / 商機 / 線索三入口）
行爲規範要點（nc-base） 包括：操作前用 neocrm auth:whoami 確認登錄；寫操作前展示內容並獲用戶確認；先 metadata:describe 再讀寫，禁止硬編碼字段名與枚舉值；寫操作失敗則停止並重試需徵詢用戶。登錄支持正式環境與沙箱 crm-sandbox.xiaoshouyi.com，通過 neocrm auth:login -c <clientId>（沙箱加 --host）完成 OAuth 客戶端 ID 認證。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
按 SkillHub 安裝說明 檢查或安裝 skillhub：
command -v skillhub && skillhub --version
未安裝時可執行文檔中的 curl 安裝腳本（完整安裝或 --cli-only）。
2. 將技能包裝入當前 Agent 的 skills 目錄¶
官方頁面與 SkillHub 文檔均要求安裝時使用 --dir 指向當前 Agent 實際識別的 skills 目錄，否則默認落到 ./skills/ 可能無法被加載。常用路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
安裝命令（與 SkillHub 搜索結果的 install 提示一致）：
skillhub install neocrm-for-ai-agent --namespace user_2d23dd34 --dir ~/.cursor/skills
也可讓 Agent 按 https://skillhub.cn/install/skillhub.md 安裝座標 @user_2d23dd34/neocrm-for-ai-agent。
3. 準備 neocrm CLI¶
nc-base/SKILL.md 要求操作前檢查 neocrm-cli-client 版本，並與 npm 上最新版對齊，例如：
neocrm --version
npm view neocrm-cli-client version
npm install -g neocrm-cli-client@latest # 本地版本落後時
4. 登錄 NeoCRM¶
首次或會話失效時，由 Agent 按 nc-base 引導選擇環境並提供 OAuth 2.0 clientId，再執行登錄並確認：
neocrm auth:login -c <clientId>
# 沙箱
neocrm auth:login -c <clientId> --host crm-sandbox.xiaoshouyi.com
neocrm auth:whoami
經過上面的步驟後，在對話中加載本 skill pack，並確保涉及寫操作、公海、日程等場景時，Agent 已加載對應的 nc-ext-* 或 nc-common 子 skill（根規範要求：先加載 skill，再操作，禁止跳過規範直接拼命令）。
典型用法¶
用法以自然語言觸發爲主，Agent 按已加載的子 skill 走「describe → 字段映射 → 展示 → 確認 → 執行」流程。下列表述與技能包設計一致，可在登錄並完成 skill 加載後復現（具體字段以租戶 metadata:describe 爲準，不可硬編碼）：
- 查詢：「列出我名下本週新建的商機」——走
nc-common，先metadata:describe再neocrm data:query。 - 寫跟進：「在某某客戶下記一條今天電話溝通的跟進」——加載
nc-ext-activityrecord。 - 公海：「把這條線索從公海領到我名下」——加載
nc-ext-territory中領取相關 reference。 - 日程：「給明天下午的客戶拜訪建一條日程並關聯該客戶」——加載
nc-ext-schedule。 - 自定義流程：「把我們經常做的 XX 審批流做成一個獨立 skill」——進入
nc-skillbench的五步創建流程，產出獨立 skill 目錄並安裝到目標 Agent。
寫操作示例在規範中的 JSON 形態（創建/更新時的 -v）須包在 data 字段下，例如：
{ "data": { "accountName": "示例公司", "money": 100000 } }
適用場景與注意¶
適合：已在使用銷售易 NeoCRM、希望用 Cursor / Claude Code / Codex 等 Agent 做查詢與合規寫入的銷售、運營或內部工具團隊；需要把重複 CRM 流程沉澱爲子 skill 的場景（nc-skillbench）。
注意：
- 多租戶字段差異大，技能強制「先 describe、禁止猜字段」；忽略
nc-base/SKILL.md容易導致寫錯或權限失敗。 - 登錄必須使用用戶提供的 clientId，規範明確禁止用模型記憶中的 clientId 直接登錄。
- SkillHub 頁面數據（截至查閱）：評分 100000，下載 2334，安裝 61；與本地租戶權限、沙箱/正式環境不一致時，表現以
neocrm返回爲準。 - 擴展 skill 標註「持續擴展中」，未列出的實體操作可優先走
nc-common通用層或工作臺自建 skill。
結尾¶
NeoCRM for AI Agent 把銷售易操作拆成可加載的分層 Skill，並用 nc-base 約束登錄、元數據與寫確認，適合把「自然語言 → CRM 實操作」做成可維護的 Agent 能力。安裝與座標見 SkillHub：
- 頁面：https://www.skillhub.cn/skills/user_2d23dd34/neocrm-for-ai-agent
- API 條目：https://api.skillhub.cn/user_2d23dd34/neocrm-for-ai-agent
