| name | dingtalk-log |
| description | 支持发送和查询钉钉日报/周报,可对工作质量总结与评分。 |
| dependency | {"python":["nodejs>=16.0.0","npm>=8.0.0"],"system":["npm install axios"]} |
| credentials | [{"name":"COZE_DINGTALK_API_7623630174566891562","description":"钉钉企业内部应用凭证,格式为 APP_KEY:APP_SECRET","required":true}] |
钉钉日志管理
任务目标
- 本 Skill 用于:管理钉钉日志(日报、周报)的创建与查询
- 能力包含:发送日志、查询日志列表、获取模板信息、生成工作质量总结
- 触发条件:用户表达"发送日报"、"创建周报"、"查询日志"、"查看我的日报"、"工作总结"等意图
前置准备
- 依赖说明:脚本使用axios进行HTTP请求
npm install axios
- 凭证配置:需要钉钉企业内部应用的AppKey和AppSecret
- 已预置凭证:dingtalk_api
- 凭证环境变量:COZE_DINGTALK_API_<skill_id>
操作步骤
场景一:发送日报/周报
流程说明:
- 智能体确认用户意图(日报或周报)及内容
- 调用脚本获取模板信息
- 调用脚本创建并发送日志
详细步骤:
-
获取模板信息
-
创建并发送日志
- 调用:
node scripts/create-report.js --userid <用户工号> --template-id <模板ID> --contents '<JSON内容>' [--to-userids <接收人ID列表>] [--to-chat true]
- 参数说明:
--userid:创建者工号
--template-id:模板ID(从步骤1获取)
--contents:日志内容,JSON数组格式,每项包含sort(字段序号)、key(字段名)、content(内容,支持Markdown)
--to-userids:接收人工号列表,逗号分隔(可选)
--to-chat:是否发送消息通知(可选,默认false)
- 示例:
node scripts/create-report.js \
--userid 2010100111 \
--template-id 17956cc992245de234cb79433a8a231 \
--contents '[{"sort":0,"key":"今日完成工作","content":"完成钉钉日志Skill开发"},{"sort":1,"key":"未完成工作","content":"优化错误处理"},{"sort":2,"key":"需协调工作","content":"无"}]' \
--to-userids user123,user456 \
--to-chat true
场景二:查询日报/周报
流程说明:
- 智能体确认查询时间范围和模板类型
- 调用脚本查询日志列表
- 智能体格式化展示结果
- 智能体生成工作质量总结(新增)
详细步骤:
-
查询日志列表
-
结果处理
- 脚本返回日志列表,包含:创建时间、修改时间、内容、创建者信息等
- 智能体以易读格式展示给用户
-
工作质量总结(智能体处理)
总结框架:
基于查询到的日报/周报内容,智能体将生成包含以下内容的工作质量总结:
A. 综合评分(满分100分)
智能体根据以下维度进行量化评分:
| 评分维度 | 权重 | 评分标准 |
|---|
| 任务完成度 | 30分 | 已完成任务占比、完成质量 |
| 工作效率 | 25分 | 任务推进速度、时间利用率 |
| 计划执行 | 20分 | 按计划推进情况、目标达成率 |
| 主动性 | 15分 | 主动承担工作、自我驱动表现 |
| 协调能力 | 10分 | 跨部门协作、问题解决能力 |
评分等级:
- 优秀(90-100分):超出预期,表现卓越
- 良好(80-89分):符合预期,表现优秀
- 合格(70-79分):基本达标,有待提升
- 待改进(60-69分):部分未达标,需重点关注
- 不合格(<60分):严重未达标,需立即改善
B. 工作亮点(做得好的方面)
- 任务完成度:分析已完成工作的数量和质量
- 工作效率:识别快速推进或高效完成的任务
- 主动性表现:发现主动承担的额外工作或协调事项
- 进度管理:评估任务推进的连贯性和计划性
C. 改善建议(待优化的方面)
- 待办事项追踪:分析未完成工作的积压情况
- 时间管理:识别任务延期或长期未完成的项目
- 协调需求:发现频繁需要协调的问题点
- 工作聚焦:评估任务优先级和专注度
输出格式示例:
任务完成度:26/30分 - 完成率85%,质量较高
工作效率:21/25分 - 推进速度良好
计划执行:17/20分 - 基本按计划推进
主动性:13/15分 - 主动承担额外工作
协调能力:8/10分 - 协作顺畅
---
:本周共完成15项任务,完成率达85%
:主动协调解决了3个跨部门协作问题
:文档编写工作较上周提前2天完成
:建议对"性能优化"任务进行拆分,设置阶段性目标
:部分任务实际耗时超出预估,建议预留缓冲时间
:本周涉及5个不同项目,建议优先聚焦核心项目
本周工作整体表现良好,任务推进有序。建议下周加强待办事项的时间管理,
优先处理积压任务,并提升工作时间的专注度。
资源索引
注意事项
- 时间格式:所有时间参数均为Unix时间戳,单位为毫秒
- 内容限制:日志内容支持Markdown语法,单字段不超过1000字符
- 时间范围:查询时间跨度最多180天
- 权限要求:应用需要有日志相关接口的调用权限
- 错误处理:脚本会返回明确的错误信息,智能体应根据错误引导用户解决
使用示例
示例1:发送日报
用户:帮我发送今天的日报,完成了项目文档编写,明天继续测试
智能体:
1. 获取日报模板信息
2. 构造日志内容:
- 今日完成工作:完成项目文档编写
- 未完成工作:明天继续测试
- 需协调工作:无
3. 调用脚本发送日志
4. 返回发送结果
示例2:查询本周日报并生成总结
用户:查看我本周发送的日报,并给出工作总结和评分
智能体:
1. 计算本周开始和结束时间戳
2. 调用脚本查询日志列表
3. 格式化展示:
- 日期:2025-01-15
今日完成工作:...
未完成工作:...
- 日期:2025-01-14
...
4. 生成工作质量总结:
## 工作质量总结
### 📊 综合评分:82分(良好)
**评分明细:**
- 任务完成度:24/30分 - 完成率80%
- 工作效率:20/25分 - 推进速度良好
- 计划执行:18/20分 - 按计划推进
- 主动性:12/15分 - 有主动承担
- 协调能力:8/10分 - 协作顺畅
---
### 一、工作亮点
1. **完成度高**:本周按时完成了所有既定任务
2. **主动性强**:主动优化了测试流程,提升效率
### 二、改善建议
1. **时间管理**:部分任务存在延期,建议合理评估工作量
2. **沟通协调**:需协调事项较多,建议提前沟通
### 三、整体评价
本周工作推进顺利,建议下周加强时间规划能力。
场景三:根据姓名搜索工号
流程说明:
- 智能体确认要搜索的用户姓名
- 调用脚本搜索用户
- 智能体展示搜索结果(可能有多个匹配)
详细步骤:
-
搜索用户工号
-
结果处理
- 脚本返回匹配的用户工号列表
- 智能体展示结果,如有多个匹配需让用户确认
- 获取工号后可用于发送/查询日志
示例输出:
{
"list": ["", "", ""],
"hasMore": false,
"totalCount": 3
}
资源索引
异常处理
- 凭证缺失:提示用户配置AppKey和AppSecret
- 权限不足:提示联系管理员开通相应接口权限
- 时间范围错误:提示调整查询时间范围(不超过180天)
- 模板不存在:提示检查模板名称(仅支持"日报"和"周报")
- 网络错误:提示检查网络连接或稍后重试