前言¶
销售跟进里大量操作仍落在 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
