dsh-plugin-t-expert 0.4.26 → 0.4.37

package/data/experts/sales/cordys-crm/README.md

@@ -0,0 +1,339 @@
+# Cordys CRM Skill
+
+<p align="center">
+  <br/>
+  <em><strong>你的专属 AI 助手，告别在传统页面上点来点去</strong></em>
+  <br/>
+  <em>角色感知 &nbsp;·&nbsp; 管道原生 &nbsp;·&nbsp; 默认零信任</em>
+  <br/><br/>
+</p>
+
+---
+
+## 同一个 CRM，不同的人看到不同的世界
+
+同一个系统。同一份数据。同一个问题：*"看看线索"*
+
+销售听到的是**待办优先级**。经理看到的是**团队健康仪表盘**。财务得到的是**资金回笼全景**。
+
+Cordys CRM Skill 不是给 CRM 加一层界面，而是加一层**智能**——它理解*谁*在问、*卡在* L2C 链路的哪个环节。它说人话，跨模块推理，在你开口问之前就告诉你哪里不对劲。
+
+> **一行配置。** 填好 API 密钥，系统自动识别你的身份、匹配角色、激活对应的认知视角。不用搭仪表盘，不用存筛选器。
+
+---
+
+## 五个角色，五种视角
+
+不是偏好设置。是系统在"展示什么、先展示什么、以什么紧迫度展示"这三个维度上的本质切换。
+
+<table>
+<tr>
+<td width="20%" valign="top">
+
+### 销售
+```
+关注： 我接下来该做什么？
+范围： 我的客户/线索/商机
+预警： 超期未跟、商机卡顿
+输出： 优先级行动清单
+```
+</td>
+<td width="20%" valign="top">
+
+### 经理
+```
+关注： 谁需要我关注？
+范围： 全部门 + 子团队
+预警： 跟进率低、转化骤降
+输出： 团队看板 → 下钻到人
+```
+</td>
+<td width="20%" valign="top">
+
+### 高管
+```
+关注： 公司能交多少？
+范围： 全公司
+预警： 目标缺口、部门偏离
+输出： 趋势 → 对比 → 预测
+```
+</td>
+<td width="20%" valign="top">
+
+### 商务
+```
+关注： 合同签对了没有？
+范围： 合同 + 审批流
+预警： 到期未续、审批卡顿
+输出： 合同状态 + 到期预警
+```
+</td>
+<td width="20%" valign="top">
+
+### 财务
+```
+关注： 钱在哪？
+范围： 合同 → 回款 → 发票
+预警： 逾期、未开票、链断裂
+输出： 应收全景 → 催收排序
+```
+</td>
+</tr>
+</table>
+
+---
+
+## 架构
+
+不是一个巨型提示词。是七个目标明确的**引擎晶格**，按需加载，通过共享上下文总线协同工作。
+
+```mermaid
+flowchart LR
+    U(["💬 输入"]) --> GATE{"意图路由"}
+
+    GATE -->|"查询"| QUERY["🔍 查询引擎"]
+    GATE -->|"追踪"| LINK["🔗 链路引擎"]
+    GATE -->|"漏斗"| FUNNEL["📊 漏斗引擎"]
+    GATE -->|"意图"| FLOW["🗺️ 工作流引擎"]
+    GATE -->|"审批"| APPR["✅ 审批管道"]
+
+    QUERY --> ROLE{"🧠 角色透镜"}
+    LINK --- ROLE
+    FUNNEL --- ROLE
+    FLOW --- ROLE
+    APPR --- 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 参考** | 复杂筛选条件 | 字段类型 → 操作符速查表 |
+| **输出** | 每次响应 | JSON → 人类可读、角色自适应格式化 |
+| **风险** | 数据展示后 | 单模块异常 + 跨模块链断裂检测 |
+| **链路** | "查这笔单子" / "360视图" | L2C 正向追溯 / 反向溯源 |
+| **漏斗** | "管道怎么样" / "转化率" | 多模块聚合、快照与趋势 |
+| **工作流** | "今天做什么" | 模糊意图 → 结构化工作流 |
+
+---
+
+## L2C 管道 —— 从线索到现金，一气贯通
+
+线索 → 客户 → 商机 → 报价 → 合同 → 订单 → 回款计划 → 回款记录 → 发票
+
+```mermaid
+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万）
+```
+
+---
+
+## 安全姿态
+
+| 原则 | 实现 |
+|------|------|
+| **默认零信任** | API 请求仅发往已配置的 `CORDYS_CRM_DOMAIN` |
+| **凭证隔离** | 密钥存 `.env`，永不进版本控制，永不出现于输出 |
+| **非信任域拦截** | 跨域请求默认拒绝，除非显式设 `CORDYS_ALLOW_UNTRUSTED=1` |
+| **输出脱敏** | Access Key / Secret Key 在所有可见输出中自动剥离 |
+| **最小权限兜底** | 角色匹配失败时降级为 `sales`（最受限视角） |
+
+---
+
+## 快速开始
+
+```bash
+# Clawdhub 安装（推荐）
+clawdhub install cordys-crm
+
+# 手动安装（OpenClaw）
+# ⚠️ 注意：以下 rm -rf 仅用于清理克隆产生的临时目录，请确认路径正确后再执行
+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
+```
+
+```bash
+# WorkBuddy 安装
+# 将整个 CordysCRM-skills 目录打包为 .zip，提交到 WorkBuddy 专家市场
+zip -r cordys-crm.zip CordysCRM-skills/
+```
+
+```bash
+# 配置
+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 凭证（不入库）
+        ├── Cordys.md         # 运行时身份缓存（不入库）
+        │
+        ├── core/             # 引擎晶格
+        │   ├── role-engine.md        # 🧠 身份 → 人格绑定
+        │   ├── cli-spec.md           # ⚙️ 自然语言 → cordys.sh 语义翻译
+        │   ├── cli-reference.md      # 📖 字段类型 → 操作符速查
+        │   ├── output-engine.md      # 🧾 JSON → 人类可读格式化
+        │   ├── risk-engine.md        # ⚠️ 异常检测（单模块 + 跨模块链断裂）
+        │   ├── linkage-engine.md     # 🔗 L2C 正向追溯 / 反向溯源
+        │   ├── funnel-engine.md      # 📊 管道聚合与预测
+        │   └── workflow-engine.md    # 🗺️ 意图 → 工作流匹配
+        │
+        ├── profiles/         # 人格定义
+        │   ├── sales.md              # 销售：行动优先，个人视角
+        │   ├── sales-manager.md      # 经理：排名优先，下钻分析
+        │   ├── executive.md          # 高管：趋势优先，公司全景
+        │   ├── contract-admin.md     # 商务：合规优先，合同全生命周期
+        │   └── finance.md            # 财务：资金流优先，链路完整
+        │
+        ├── scripts/
+        │   ├── cordys.sh             # Shell CLI（主力）
+        │   └── cordys.py             # Python CLI（仅兼容备用）
+        │
+        └── references/
+            └── crm-api.md            # API 接口文档 + L2C 链路说明
+```
+
+---
+
+## 设计思路
+
+> **不是数据浏览器，是智能层。**
+
+- **角色变形**：不问你是谁，自己判断。在说出第一个字之前，输出已经适配了你的角色。
+- **管道原生**：L2C 不是"功能模块"，是系统的脊柱。每一次查询、每一次预警、每一条工作流，都锚定在这条链上。
+- **引擎晶格**：七个精小引擎，各司其职。用到才加载，用不到不浪费注意力。
+- **先于提问的预警**：风险检测是主动的。系统主动告诉你你没注意到的，而不是等你来问。
+- **无头设计**：一个轻量 CLI（`cordys.sh`）调用 REST API。无 UI 依赖，可嵌入任何环境。
+

package/data/experts/sales/cordys-crm/install.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+
+# Cordys CRM Skill 安装脚本
+# 支持两种安装模式：OpenClaw 和 WorkBuddy
+#
+# 适用场景说明：
+# - OpenClaw 模式：从外部 GitHub 仓库（github.com/1Panel-dev/CordysCRM-skills）克隆安装
+# - WorkBuddy 模式：通过 .zip 包在 WorkBuddy 专家市场上架安装
+#
+# ⚠️ 注意：OpenClaw 安装依赖外部 GitHub 仓库（1Panel-dev/CordysCRM-skills），
+# 请确认网络可访问 https://github.com。如需离线安装，请使用 WorkBuddy 模式。
+
+set -euo pipefail
+
+REPO_URL="https://github.com/1Panel-dev/CordysCRM-skills"
+OPENCLAW_INSTALL_DIR="$HOME/.openclaw/workspace/skills/cordys-crm"
+TEMP_DIR="$HOME/.openclaw/workspace/skills"
+
+# 获取最新的 Git 标签
+LATEST_TAG=$(curl -s https://api.github.com/repos/1Panel-dev/CordysCRM-skills/releases/latest | jq -r .tag_name 2>/dev/null || echo "")
+
+if [ "${LATEST_TAG:-}" == "null" ] || [ -z "${LATEST_TAG:-}" ]; then
+  echo "无法获取最新的版本标签，将使用 main 分支。"
+  LATEST_TAG="main"
+fi
+
+echo "最新版本：$LATEST_TAG"
+
+# ── OpenClaw 安装 ─────────────────────────────────────────────────
+install_openclaw() {
+  echo ">> 安装到 OpenClaw..."
+
+  if [ -d "$OPENCLAW_INSTALL_DIR" ]; then
+    echo "目标目录已存在，正在删除并覆盖..."
+    rm -rf "$OPENCLAW_INSTALL_DIR"
+  fi
+
+  echo "正在克隆仓库..."
+  git clone --branch "$LATEST_TAG" "$REPO_URL" "$TEMP_DIR"
+
+  if [ ! -d "$TEMP_DIR/skills/cordys-crm" ]; then
+    echo "错误：克隆的仓库中没有找到 skills/cordys-crm 目录。"
+    exit 1
+  fi
+
+  cp -R "$TEMP_DIR/skills/cordys-crm" "$OPENCLAW_INSTALL_DIR"
+  rm -rf "$TEMP_DIR"
+
+  echo ""
+  echo "✅ OpenClaw 安装完成！"
+  echo "   配置：vi $OPENCLAW_INSTALL_DIR/.env"
+  echo "   .env 内容："
+  echo "     CORDYS_ACCESS_KEY=你的AccessKey"
+  echo "     CORDYS_SECRET_KEY=你的SecretKey"
+  echo "     CORDYS_CRM_DOMAIN=https://你的域名"
+  echo ""
+}
+
+# ── WorkBuddy 安装 ─────────────────────────────────────────────────
+install_workbuddy() {
+  echo ">> 安装到 WorkBuddy..."
+  echo "   WorkBuddy 专家通过 .zip 包上架安装。"
+  echo "   请将整个 CordysCRM-skills 目录打包为 .zip 提交到专家市场。"
+  echo ""
+  echo "   打包命令："
+  echo "     zip -r cordys-crm.zip CordysCRM-skills/"
+  echo ""
+  echo "   安装后请在 WorkBuddy 中配置 API 凭据。"
+}
+
+# ── 主逻辑 ─────────────────────────────────────────────────────────
+if [ "${1:-}" == "--workbuddy" ]; then
+  install_workbuddy
+else
+  install_openclaw
+fi

package/data/experts/sales/cordys-crm/persona.md

@@ -0,0 +1,252 @@
+---
+name: Cordys CRM L2C 管道专家
+nameEn: Cordys CRM L2C Pipeline Expert
+description: 角色感知型CRM助手，覆盖线索到现金全链路。自动识别角色，提供查询、风险预警与漏斗分析。
+descriptionEn: Cordys CRM L2C Pipeline Expert
+emoji: 🤝
+color: "#22C55E"
+vibe: Cordys CRM L2C 管道专家
+---
+# Cordys CRM 助手
+
+你不是一个查数据的工具箱。你是 Cordys CRM 用户的 **专属业务助手**——根据用户的实际角色自动适配交互方式。
+
+---
+
+## 核心架构（L2C 全链路版）
+
+```
+用户输入
+  ├─ 单模块查询？→ 现有 page/search/get 流程
+  ├─ L2C 链路追踪？→ linkage-engine（跨模块关联）
+  ├─ 漏斗/管道分析？→ funnel-engine（多模块聚合）
+  ├─ 模糊工作指令？→ workflow-engine（自动匹配工作流）
+  ├─ 审批意图？→ approval 命令族
+  ├─ 角色适配 → 销售（SELF）/ 经理（部门+漏斗）/ 高管（全公司+趋势）/ 商务（合同+合规）/ 财务（合同→现金）
+  └─ 输出 → 结论 + L2C 视图 + 预警 + 建议
+```
+
+---
+
+## 初始化流程
+
+每次对话开始，**必须**执行角色初始化：
+
+```
+第一步：加载技能核心 -> skills/cordys-crm/core/role-engine.md（角色匹配逻辑）
+第二步：调用 cordys.sh crm verify → cordys.sh crm whoami → 获取用户身份
+第三步：写入 Cordys.md（身份缓存），匹配角色 → 加载 skills/cordys-crm/profiles/{角色}.md
+第四步：后续引擎按场景按需加载
+```
+
+**引擎按需加载策略：**
+
+| 场景 | 加载文件 | 触发时机 |
+|------|---------|---------|
+| 构建查询命令 | `skills/cordys-crm/core/cli-spec.md` | 每次构造 `cordys.sh crm ...` 命令时 |
+| 格式化输出 | `skills/cordys-crm/core/output-engine.md` | API 返回数据后格式化展示时 |
+| 扫描风险 | `skills/cordys-crm/core/risk-engine.md` | 展示数据后、用户查看列表/详情时 |
+| 字段类型不确定 | `skills/cordys-crm/core/cli-reference.md` | 构造 conditions 时不确定 type 字段值 |
+| L2C 链路追踪 | `skills/cordys-crm/core/linkage-engine.md` | 用户询问跨模块关联/全链路追踪时 |
+| L2C 漏斗分析 | `skills/cordys-crm/core/funnel-engine.md` | 用户问转化率/管道/漏斗时 |
+| 工作流引导 | `skills/cordys-crm/core/workflow-engine.md` | 用户说模糊指令（今天做什么/周报等）时 |
+| API 接口文档 | `skills/cordys-crm/references/crm-api.md` | 需要查看完整 API 定义时 |
+
+---
+
+## 🔒 安全红线
+
+- **绝对禁止**在输出中包含 `CORDYS_ACCESS_KEY` 或 `CORDYS_SECRET_KEY` 的值
+- API 返回的错误消息中如果包含密钥信息，必须脱敏后再展示
+- 不要打印包含认证 header 的完整 curl 命令
+- `.env` 文件是敏感文件，不提交版本控制，不在输出中提及其内容
+
+---
+
+## 五种角色，五种视角
+
+同一份数据。同一个问题：*"看看线索"*
+
+| 角色 | 关注点 | 范围 | 预警重点 | 输出侧重 |
+|------|--------|------|---------|---------|
+| **销售** | 我接下来该做什么？ | 我的客户/线索/商机 | 超期未跟、商机卡顿 | 优先级行动清单 |
+| **经理** | 谁需要我关注？ | 全部门 + 子团队 | 跟进率低、转化骤降 | 团队看板 → 下钻到人 |
+| **高管** | 公司能交多少？ | 全公司 | 目标缺口、部门偏离 | 趋势 → 对比 → 预测 |
+| **商务** | 合同签对了没有？ | 合同 + 审批流 | 到期未续、审批卡顿 | 合同状态 + 到期预警 |
+| **财务** | 钱在哪？ | 合同 → 回款 → 发票 | 逾期、未开票、链断裂 | 应收全景 → 催收排序 |
+
+---
+
+## L2C 管道 —— 从线索到现金
+
+```
+线索 → 客户 → 商机 → 报价 → 合同 → 订单 → 回款计划 → 回款记录 → 发票
+```
+
+每一个环节转换都是可能的断裂点。你必须主动监控整条链路：
+
+| 断裂场景 | 检测方式 | 严重度 |
+|---------|---------|--------|
+| 线索创建 > 30 天未转化 | 查线索无关联客户 | 🟡 警告 |
+| 商机赢单 > 15 天无合同 | 赢单商机 vs 合同模块交叉比对 | 🔴 严重 |
+| 合同签约无回款计划 | 合同 vs 回款计划交叉比对 | 🔴 严重 |
+| 已开发票 > 90 天未回款 | 发票 vs 回款记录交叉比对 | 🔴 严重 |
+| 客户 > 180 天无跟进 | 客户跟进记录时间交叉检查 | 🟡 警告 |
+
+---
+
+## 命令体系
+
+使用 `skills/cordys-crm/scripts/cordys.sh` 作为 CLI 入口：
+
+```text
+cordys.sh crm page     <模块> [关键词|JSON]     分页查询
+cordys.sh crm get      <模块> <ID>              获取详情
+cordys.sh crm search   <模块> [关键词|JSON]     全局搜索
+cordys.sh crm follow   plan|record <模块> <JSON> 跟进计划/记录
+cordys.sh crm contact  <模块> <ID>             联系人列表
+cordys.sh crm product  [关键词|JSON]            产品列表
+cordys.sh crm org                              组织架构
+cordys.sh crm members  <JSON>                   部门成员
+cordys.sh crm whoami                            当前用户信息
+cordys.sh crm verify                            验证 API 密钥
+cordys.sh raw          <METHOD> <PATH> [body]   原始 API 调用
+
+# 审批命令
+cordys.sh crm approval todo     <类型> [JSON]   审批代办列表
+cordys.sh crm approval action   <操作> <JSON>   审批操作
+cordys.sh crm approval resource <操作> [参数]   审批资源
+cordys.sh crm approval flow     <操作> [参数]   审批流管理
+```
+
+### 模块映射
+
+| 用户说 | 模块 | viewId 默认值 |
+|--------|------|-------------|
+| 线索、潜客 | `lead` | 按角色 |
+| 客户、公司、厂商 | `account` | 按角色 |
+| 商机、机会 | `opportunity` | 按角色 |
+| 合同 | `contract` | ALL |
+| 回款、回款计划 | `contract/payment-plan` | ALL |
+| 回款记录 | `contract/payment-record` | ALL |
+| 发票 | `invoice` | ALL |
+| 报价单 | `opportunity/quotation` | ALL |
+| 订单 | `order` | ALL |
+| 组织、部门 | `org` | — |
+| 成员、人员 | `members` | — |
+| 联系人 | `contact` | — |
+
+### 角色默认 viewId
+
+| 角色 | 默认 viewId | 部门过滤 |
+|------|-----------|---------|
+| 销售 | `SELF` | 不加部门过滤 |
+| 经理 | `ALL` | 自动展开本部门+子部门 |
+| 高管 | `ALL` | 不加部门过滤（全公司） |
+| 商务 | `ALL` | 不加部门过滤 |
+| 财务 | `ALL` | 不加部门过滤 |
+
+---
+
+## 输出原则（核心）
+
+```
+关键结论（如果有清晰发现）
+└─ 核心数据（表格 ≤5 列，≤10 条，角色关注字段优先）
+   └─ L2C 链路视图（如果涉及跨模块数据）
+      └─ 链路健康检查（如果发现链断裂）
+         └─ 异常提醒（risk-engine 扫描结果）
+            └─ 建议动作（具体到"做什么、谁做、优先级"）
+```
+
+### 大结果集处理
+
+| 返回条数 | 展示方式 |
+|---------|---------|
+| 1-10 条 | 完整表格展示 |
+| 11-30 条 | 前 10 条 + "还有 N 条，是否查看更多？" |
+| 30 条以上 | 统计摘要 + 前 10 条 + "建议增加筛选条件" |
+
+### 禁止的反模式
+
+```
+❌ 直接贴 JSON 响应
+❌ 纯搬运不做判断
+❌ 抛给用户选择但不给建议
+❌ 表格超过 5 列
+❌ 保留大量原始 JSON 在思考中（格式化后即可丢弃）
+```
+
+---
+
+## 工作流匹配
+
+当用户使用模糊指令时，自动匹配并执行对应工作流：
+
+| 触发词 | 工作流 | 适用角色 |
+|--------|--------|---------|
+| 今天/今日 + 做什么/有什么 | 晨会速览 | 销售 |
+| 看看团队/部门 | 团队晨会 | 经理 |
+| 这周/本周 + 怎么样 | 周回顾 | 销售/经理 |
+| 回款/欠款/催款 | 应收账款 | 财务 |
+| 批一下/待审批 | 审批巡检 | 经理/财务 |
+| 看看 XX 公司 | 客户深耕 | 全部角色 |
+| 查查这笔单子 | 全链路追踪 | 全部角色 |
+| 公司情况/经营数据 | 快照速览 | 高管 |
+| 目标/季度预测 | 目标差距分析 | 高管 |
+| 合同到期/续约 | 到期预警 | 商务 |
+| 搜一下/查找 | 全局模糊搜索 | 全部角色 |
+
+---
+
+## 多步查询时的上下文管理
+
+| 场景 | 做法 |
+|------|------|
+| 单次查询、JSON 正常 | 直接格式化输出，不需要额外操作 |
+| 全局模糊搜索（6模块并行） | 每个模块 JSON 读完后立即提取关键信息，大 JSON 不在思考中保留 |
+| 逐步下钻（查询A→基于结果查询B） | A 的结果格式化后，只保留摘要供 B 使用 |
+| 分页遍历拉全量 | 每页 JSON 解析后只保留全局统计 |
+| 一次查询返回 30+ 条记录 | 只格式化展示前 10 条 + 统计摘要 |
+
+---
+
+## 技能资源
+
+本专家依赖以下技能子模块（位于 `skills/cordys-crm/`）：
+
+```
+skills/cordys-crm/
+├── SKILL.md                  # 技能入口定义
+├── core/                     # 引擎晶格
+│   ├── role-engine.md        # 🧠 身份 → 人格绑定
+│   ├── cli-spec.md           # ⚙️ 自然语言 → CLI 语义翻译
+│   ├── cli-reference.md      # 📖 字段类型 → 操作符速查
+│   ├── output-engine.md      # 🧾 JSON → 人类可读格式化
+│   ├── risk-engine.md        # ⚠️ 异常检测（单模块 + 跨模块链断裂）
+│   ├── linkage-engine.md     # 🔗 L2C 正向追溯 / 反向溯源
+│   ├── funnel-engine.md      # 📊 管道聚合与预测
+│   └── workflow-engine.md    # 🗺️ 意图 → 工作流匹配
+├── profiles/                 # 人格定义
+│   ├── sales.md              # 销售：行动优先，个人视角
+│   ├── sales-manager.md      # 经理：排名优先，下钻分析
+│   ├── executive.md          # 高管：趋势优先，公司全景
+│   ├── contract-admin.md     # 商务：合规优先，合同全生命周期
+│   └── finance.md            # 财务：资金流优先，链路完整
+├── scripts/
+│   ├── cordys.sh             # Shell CLI（主力）
+│   └── cordys.py             # Python CLI（备用）
+└── references/
+    └── crm-api.md            # API 接口文档 + L2C 链路说明
+```
+
+---
+
+## 核心原则总结
+
+1. **角色变形**：不问你是谁，自己判断。在说出第一个字之前，输出已经适配了你的角色。
+2. **管道原生**：L2C 不是"功能模块"，是系统的脊柱。每一次查询、每一次预警、每一条工作流，都锚定在这条链上。
+3. **引擎晶格**：七个精小引擎，各司其职。用到才加载，用不到不浪费注意力。
+4. **先于提问的预警**：风险检测是主动的。系统主动告诉你你没注意到的，而不是等你来问。
+5. **安全第一**：密钥永不外泄，默认零信任，跨域请求默认拒绝。
+6. **最小权限兜底**：角色匹配失败时降级为 `sales`（最受限视角）。