Cordys CRM Skill

June 29, 2026 · View on GitHub

你的专属 AI 助手，告别在传统页面上点来点去
角色感知 · 管道原生 · 默认零信任

同一个 CRM，不同的人看到不同的世界

同一个系统。同一份数据。同一个问题："看看线索"

销售听到的是待办优先级。经理看到的是团队健康仪表盘。财务得到的是资金回笼全景。

Cordys CRM Skill 不是给 CRM 加一层界面，而是加一层智能——它理解谁在问、卡在 L2C 链路的哪个环节。它说人话，跨模块推理，在你开口问之前就告诉你哪里不对劲。

一行配置。 填好 API 密钥，系统自动识别你的身份、匹配角色、激活对应的认知视角。不用搭仪表盘，不用存筛选器。

五个角色，五种视角

不是偏好设置。是系统在"展示什么、先展示什么、以什么紧迫度展示"这三个维度上的本质切换。

销售

关注： 我接下来该做什么？
范围： 我的客户/线索/商机
预警： 超期未跟、商机卡顿
输出： 优先级行动清单

经理

关注： 谁需要我关注？
范围： 全部门 + 子团队
预警： 跟进率低、转化骤降
输出： 团队看板 → 下钻到人

高管

关注： 公司能交多少？
范围： 全公司
预警： 目标缺口、部门偏离
输出： 趋势 → 对比 → 预测

商务

关注： 合同签对了没有？
范围： 合同 + 审批流
预警： 到期未续、审批卡顿
输出： 合同状态 + 到期预警

财务

关注： 钱在哪？
范围： 合同 → 回款 → 发票
预警： 逾期、未开票、链断裂
输出： 应收全景 → 催收排序

架构

不是一个巨型提示词。是九个目标明确的引擎晶格，按需加载，通过共享上下文总线协同工作。

flowchart LR
    U(["💬 输入"]) --> GATE{"意图路由"}

    GATE -->|"查询"| QUERY["🔍 查询引擎"]
    GATE -->|"追踪"| LINK["🔗 链路引擎"]
    GATE -->|"漏斗"| FUNNEL["📊 漏斗引擎"]
    GATE -->|"意图"| INTENT["🧭 意图引擎"]
    GATE -->|"审批"| APPR["✅ 审批管道"]
    GATE -->|"写入"| WRITE["✏️ 写入引擎"]

    QUERY --> ROLE{"🧠 角色透镜"}
    LINK --- ROLE
    FUNNEL --- ROLE
    INTENT --- ROLE
    APPR --- ROLE
    WRITE --- ROLE

    ROLE --> SL["👤 销售"]
    ROLE --> SM["👥 经理"]
    ROLE --> EX["🏢 高管"]
    ROLE --> CA["📋 商务"]
    ROLE --> FN["💰 财务"]

    SL --- RISK["⚠️ 风险引擎"]
    SM --- RISK
    EX --- RISK
    CA --- RISK
    FN --- RISK

    RISK --> FMT["🧾 输出引擎"]
    FMT --> OUT(["✨ 响应"])

核心原则：role-engine.md 是唯一启动必加载的引擎（约 150 行）。其余全部按意图懒加载——保持上下文窗口精瘦。

九引擎晶格

引擎	激活信号	职责
角色	会话启动	身份识别、角色匹配、人格绑定
CLI 规范	任何查询	自然语言 → `cordys.sh crm` 语义翻译
CLI 参考	复杂筛选/写入	字段类型→操作符速查、写入API端点
输出	每次响应	JSON → 人类可读、角色自适应格式化
风险	数据展示后	单模块异常 + 跨模块链断裂检测
链路	"查这笔单子" / "360视图"	L2C 正向追溯 / 反向溯源
漏斗	"管道怎么样" / "转化率"	多模块聚合、快照与趋势
意图	"今天做什么"	模糊意图 → 角色工作流路由
写入	"创建" / "修改" / "转化"	表单获取→校验→写入→验证

L2C 管道 —— 从线索到现金，一气贯通

线索 → 客户 → 商机 → 报价 → 合同 → 订单 → 回款计划 → 回款记录 → 发票

flowchart LR
    L["🔹 线索"] -->|"转化"| A["🔹 客户"]
    A --> O["🔹 商机"]
    O --> Q["📄 报价"]
    O --> C["🔹 合同"]
    C --> OD["📦 订单"]
    C --> PP["💰 回款计划"]
    PP --> PR["💰 回款记录"]
    OD --> I["🧾 发票"]

    L -.- AL1["🟡 超30天"]
    O -.- AL2["🔴 无合同"]
    C -.- AL3["🔴 无计划"]
    I -.- AL4["🟡 未回款"]

    style AL1 fill:#fbbf24,stroke:none
    style AL2 fill:#ef4444,stroke:none
    style AL3 fill:#ef4444,stroke:none
    style AL4 fill:#fbbf24,stroke:none

每一个环节转换都是可能的断裂点。系统监控整条链路，在问题变成事故之前主动暴露——不只是单模块内，而是跨 L2C 全局。

链断裂检测示例

断裂场景	检测方式	严重度
线索创建 > 30 天未转化	查线索无关联客户	🟡 警告
商机赢单 > 15 天无合同	赢单商机 vs 合同模块交叉比对	🔴 严重
合同签约无回款计划	合同 vs 回款计划交叉比对	🔴 严重
已开发票 > 90 天未回款	发票 vs 回款记录交叉比对	🔴 严重
客户 > 180 天无跟进	客户跟进记录时间交叉检查	🟡 警告

实际体验

销售 —— 晨会速览

> 今天有什么要跟的？

📋 今日跟进计划（3 项）
| 客户 | 内容 | 优先级 |
| YYY集团 | 确认需求 | 🚨 超期5天 |
| 华星科技 | 发送报价 | ⚠️ 今日到期 |
| ABC技术 | 初次联系 | 🟢 新线索 |

📊 我的管线：线索12 / 商机4（¥52万） / 签约1（¥12万）
💡 商机"XX项目"在需求确认阶段停留10天，建议推进

经理 —— 周会看板

> 团队这周怎么样？

📊 团队 L2C 漏斗（本周）
| 成员 | 新增线索 | 新增商机 | 签约 | 签约额 |
| 张三 | 8 | 2 | 1 | ¥12万 |
| 李四 | 5 | 1 | 0 ⚠️ | ¥0 |
| 王五 | 12 | 4 | 2 | ¥35万 🏆 |

🚨 李四本周签约为零，跟进率 40% < 团队均值 68%
📋 2 条待审批超过 3 天未处理
💡 建议 1v1 了解李四管线卡点

财务 —— 应收全景

> 欠款情况

💰 应收账款全景
汇总：总应收 ¥285万 | 已逾期 ¥45万 🚨 | 7天内到期 ¥62万 ⚠️

🚨 逾期回款（3 笔）
| 合同 | 客户 | 逾期 | 金额 |
| CRM-001 | 华星 | 15天 | ¥15万 |
| CRM-008 | 远航 | 32天 | ¥20万 |
| CRM-012 | 星辰 | 8天 | ¥10万 |

⚠️ 链断裂：2份签约合同未创建回款计划（¥55万）

写入 —— 创建客户（含表单校验）

> 创建一个客户：华星科技，行业科技，广东

📋 已获取客户表单定义（12 个字段，3 项必填）

⚠️  即将创建客户「华星科技」

| 字段 | 值 |
|------|-----|
| 名称 | 华星科技 |
| 行业 | 科技 |
| 省份 | 广东 |
| 负责人 | 当前用户（默认） |

确认创建？（是/修改/取消）

> 是

✅ 已创建客户「华星科技」
🔗 cordys.sh crm get account 987654321

安全姿态

原则	实现
默认零信任	API 请求仅发往已配置的 `CORDYS_CRM_DOMAIN`
凭证隔离	密钥存 `.env`，永不进版本控制，永不出现于输出
非信任域拦截	跨域请求默认拒绝，除非显式设 `CORDYS_ALLOW_UNTRUSTED=1`
输出脱敏	Access Key / Secret Key 在所有可见输出中自动剥离
最小权限兜底	角色匹配失败时降级为 `sales`（最受限视角）
写入保护	先取表单定义再校验再写入；绝对禁止任何删除操作

快速开始

# Clawdhub 安装（推荐）
clawdhub install cordys-crm

# 手动安装（OpenClaw）
git clone --branch main https://github.com/1Panel-dev/CordysCRM-skills \
  ~/.openclaw/workspace/skills/CordysCRM-skills
mv ~/.openclaw/workspace/skills/CordysCRM-skills/skills/cordys-crm \
  ~/.openclaw/workspace/skills/cordys-crm
rm -rf ~/.openclaw/workspace/skills/CordysCRM-skills

# WorkBuddy 安装
# 将整个 CordysCRM-skills 目录打包为 .zip，提交到 WorkBuddy 专家市场
zip -r cordys-crm.zip CordysCRM-skills/

# 配置
vi ~/.openclaw/workspace/skills/cordys-crm/.env

# .env 内容
CORDYS_ACCESS_KEY=***
CORDYS_SECRET_KEY=***
CORDYS_CRM_DOMAIN=https://你的域名

# 可选：自定义角色映射
# ROLE_MAP=VP|总监=sales-manager,会计|出纳=finance

就这三行。零上手成本。

仓库结构

├── .workbuddy-plugin/
│   └── plugin.json           # ★ WorkBuddy 专家配置
├── agents/
│   └── cordys-crm.md         # ★ Agent 定义文件
├── avatars/
│   ├── expert.png            # 专家头像
├── install.sh                # 安装脚本
├── README.md                 # 说明文档
│
└── skills/
    └── cordys-crm/           # 技能子模块
        ├── SKILL.md          # 入口编排
        ├── registry.json     # 技能清单
        ├── .env              # API 凭证（不入库）
        ├── user-role.md         # 运行时身份缓存（不入库）
        │
        ├── core/             # 引擎晶格
        │   ├── role-engine.md        # 🧠 身份 → 人格绑定
        │   ├── cli-spec.md           # ⚙️ 自然语言 → cordys.sh 语义翻译
        │   ├── cli-reference.md      # 📖 字段类型 → 操作符速查 + 写入API
        │   ├── output-engine.md      # 🧾 JSON → 人类可读格式化
        │   ├── risk-engine.md        # ⚠️ 异常检测（单模块 + 跨模块链断裂）
        │   ├── linkage-engine.md     # 🔗 L2C 正向追溯 / 反向溯源
        │   ├── funnel-engine.md      # 📊 管道聚合与预测
        │   ├── intent-engine.md      # 🧭 意图识别 → 角色工作流路由
        │   └── write-engine.md       # ✏️ 表单获取→校验→创建/更新/转化
        │
        ├── profiles/         # 人格定义（含角色专属工作流）
        │   ├── sales.md              # 销售：行动优先，个人视角
        │   ├── sales-manager.md      # 经理：排名优先，下钻分析
        │   ├── executive.md          # 高管：趋势优先，公司全景
        │   ├── contract-admin.md     # 商务：合规优先，合同全生命周期
        │   └── finance.md            # 财务：资金流优先，链路完整
        │
        ├── rules/            # 自定义规则扩展
        │   ├── README.md             # 规则目录使用说明
        │   ├── form-rules/           # 表单校验规则（按模块）
        │   ├── field-mapping/        # 字段映射规则（如线索→客户）
        │   └── business-rules/       # 业务规则（如商机阶段流转）
        │
        ├── scripts/
        │   ├── cordys.sh             # Shell CLI（主力，含写入命令）
        │   └── cordys.py             # Python CLI（仅兼容备用）
        │
        └── references/
            ├── crm-api.md            # API 接口文档 + L2C 链路说明
            └── docs.json             # Cordys CRM OpenAPI 规范

设计思路

不是数据浏览器，是智能层。

角色变形：不问你是谁，自己判断。在说出第一个字之前，输出已经适配了你的角色。
管道原生：L2C 不是"功能模块"，是系统的脊柱。每一次查询、每一次预警、每一条工作流，都锚定在这条链上。
引擎晶格：九个精小引擎，各司其职。用到才加载，用不到不浪费注意力。
先于提问的预警：风险检测是主动的。系统主动告诉你你没注意到的，而不是等你来问。
无头设计：一个轻量 CLI（cordys.sh）调用 REST API。无 UI 依赖，可嵌入任何环境。