Ps Dingtalk

在 Claude Code 环境中通过 CLI 执行：

cd ps-agent/ps-dingtalk/scripts

# 发送消息
python send.py user <userId1,userId2> "<内容>" [text|markdown]
python send.py group <openConversationId> "<内容>" [text|markdown]

# 查询联系人
python send.py lookup <手机号>
python send.py lookup-name <姓名>

# 同步通讯录
python send.py sync-contacts [部门ID]

4. 联系人解析逻辑

当用户说"发给XX"或"通知XX"时，按以下顺序解析收件人：

Step 1: 按姓名查 contacts.json

使用 lookup_contact 工具，传入 name 参数。

• 找到且有 userId → 直接发送
• 找到但 userId 为空 → 提示"联系人已登记但缺少 userId，请提供手机号补充"
• 未找到 → 进入 Step 2

Step 2: 模糊匹配

lookup_contact 会自动做模糊匹配：

• 用户说"小波" → 匹配到"陈小波"
• 用户说"张" → 匹配到"张家祥"

匹配到 → 确认后发送。未匹配 → 进入 Step 3。

Step 3: 向用户要手机号

❓ 未找到「{name}」的钉钉信息，请提供 TA 的手机号，我来查询。

用户给出手机号后，使用 lookup_contact 工具传入 mobile 参数查询。

Step 4: 查到后建议保存

✅ 查到了：{name} → userId: {userId}
💡 是否将 {name} 加入联系人目录，方便下次直接发送？

用户同意后，通过 write_file 更新 ps-agent/ps-dingtalk/contacts.json。

群组解析

• 用户说"发到群里" / "发到售前群" → 查 contacts.json 的 groups 部分
• 未找到匹配群 → 询问群的 openConversationId

5. 消息格式规范

5.1 格式选择原则

5.2 消息长度控制

• text 格式：建议 < 500 字，超出自动截断
• markdown 格式：建议 < 3000 字，超出自动截断
• 超长内容处理策略：只发摘要 + 告知文件路径

## 📋 {标题}

> 项目：{客户名称} | {日期}

{摘要内容，控制在 500 字以内}

---
📂 完整内容已保存：`projects/{客户名称}/{路径}`
*由售前 AI 助手发送*

5.3 标准消息模板

通用通知（text）

【售前助手通知】
项目：{客户名称}
事项：{简要描述}
时间：{YYYY-MM-DD HH:mm}

结构化通知（markdown）

## 📋 {标题}

> 项目：{客户名称} | {日期}

### 关键信息
- {要点1}
- {要点2}
- {要点3}

### 待跟进
- {行动项}

---
*由售前 AI 助手自动发送*

6. 跨 Skill 通知场景

当其他 Skill 完成产出物后，用户说"通知一下"时，根据最近完成的 Skill 选择对应模板：

6.1 客户洞察完成（ps-customer-analysis）

默认收件人： 项目负责人（project.json → owner）

## 🔍 客户洞察报告已生成

> 项目：{客户名称} | {日期}

### 企业画像
- 行业：{行业}
- 规模：{规模}
- 数字化成熟度：{等级}

### 匹配案例
- {案例1}
- {案例2}

📂 完整报告：`projects/{客户}/analysis/customer-insight.md`

6.2 解决方案完成（ps-solution-generator）

默认收件人： 项目负责人 + 相关售前顾问

## 📝 解决方案 v{N} 已生成

> 项目：{客户名称} | {日期}

### 方案概要
- 类型：{业务方案/产品方案/案例集}
- 核心模块：{模块1}、{模块2}、{模块3}
- 预计工作量：{N} 人天

### 下一步
- [ ] 内部评审
- [ ] 客户沟通确认

📂 完整方案：`projects/{客户}/solution/{文件名}`

6.3 工作量评估完成（ps-apaas-evaluator）

默认收件人： 项目负责人

## 📊 工作量评估已完成

> 项目：{客户名称} | {日期}

### 评估概要
- 总模块数：{N} 个
- 🟢 可配置：{N} 项 | 🟡 需插件：{N} 项 | 🔴 需开发：{N} 项
- 总工时估算：{N} 人天

### 关键风险
- {风险1}
- {风险2}

📂 评估文件：`projects/{客户}/evaluation/{文件名}`

6.4 周报发布（ps-weekly-report）

默认收件人： 售前团队群

## 📅 售前周报 · {YYYY} 第 {WW} 周

### 本周重点
- {进展1}
- {进展2}

### 项目概览
| 项目 | 阶段 | 状态 |
|------|------|------|
| {客户1} | {阶段} | {🔴/🟡/🟢} |
| {客户2} | {阶段} | {🔴/🟡/🟢} |

📂 完整周报：`projects/weekly-reports/{文件名}`

6.5 项目交底完成（ps-project-hub handover）

默认收件人： 交付团队 / 实施负责人

## 🤝 项目交底文件已生成

> 项目：{客户名称} | {日期}

### 交底概要
- 干系人：{N} 位关键角色已识别
- 实施范围：{N} 项已确认 / {N} 项待确认
- 识别风险：{N} 项

### 关键信息
- 决策人：{姓名/职位}
- 预计启动：{日期}

📂 交底文件：`projects/{客户}/handover/项目交底_v1.md`

6.6 通知决策流程

用户说"通知一下" / "发给XX"
    │
    ├─ 有明确收件人 → 解析联系人（第4节逻辑）
    │
    ├─ 无明确收件人 → 根据最近完成的 Skill 推荐默认收件人
    │   │
    │   └─ 「刚完成客户洞察，建议通知项目负责人 {name}，确认吗？」
    │
    ├─ 组织消息（从对应产出物提炼摘要，套用模板）
    │
    ├─ 发送前确认：
    │   「准备发送给 {name}（{role}），内容如下：
    │    {消息预览前100字}...
    │    确认发送？」
    │
    └─ 发送 + 报告结果

7. 错误处理

8. 注意事项

• 发送前必须确认：组织好消息内容后，先展示给用户预览，确认后再发送
• 敏感信息禁止发送：不通过钉钉发送客户报价、合同金额、竞品定价等敏感数据
• 消息频率控制：同一收件人短时间内（5分钟）不重复发送相同内容
• 联系人维护：首次使用建议运行 sync-contacts 同步团队通讯录
• 群消息谨慎：发送到群之前确认群名和用途，避免发错群