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