dingtalk-daily

v0.9.4

支持发送和查询钉钉日报/周报，可对工作质量总结与评分。

⭐ 0· 97·0 current·0 all-time

by@bigint1

Security Scan

VirusTotal

Benign

View report →

OpenClaw

Benign

high confidence

✓

Purpose & Capability

Name/description match the code and instructions: scripts call DingTalk APIs to get templates, create reports, query reports, and search users. The required credential (DingTalk AppKey:AppSecret) is appropriate for these actions.

✓

Instruction Scope

Runtime instructions and scripts only reference DingTalk API endpoints and local CLI args. They do not attempt to read unrelated files, system credentials, or call external endpoints outside documented DingTalk API hosts.

ℹ

Install Mechanism

This is instruction-only (no install spec). The SKILL.md asks users to run `npm install axios` and the scripts require axios. The dependency block in SKILL.md is mis-labeled (lists node/npm under 'python') — this is sloppy but not overtly malicious.

ℹ

Credentials

The scripts require a single credential: COZE_DINGTALK_API_7623630174566891562 (APP_KEY:APP_SECRET), which is proportional. However, registry metadata claimed no required env vars while SKILL.md and scripts clearly require that environment variable — an inconsistency to be aware of.

✓

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system settings, and runs as invoked. No elevated or persistent privileges are requested.

Assessment

This skill is coherent with its stated purpose of managing DingTalk reports, but check these before installing: - You must provide a DingTalk application credential in the environment variable COZE_DINGTALK_API_7623630174566891562 with format APP_KEY:APP_SECRET; the registry metadata incorrectly omitted this requirement. - The SKILL.md’s dependency block is mislabeled (node/npm listed under 'python'); the scripts require Node.js and the axios package — run `npm install axios` in the execution environment. - The auth script prints access_token JSON when run standalone; if you run these scripts in an environment where agent logs are retained, that token could appear in logs. Ensure logs are protected and use a minimally privileged DingTalk app. - Verify the skill owner/registry entry (no homepage provided). If you deploy this in production, test in a sandbox DingTalk account and rotate/revoke app credentials if you later remove the skill. Overall: functionally consistent and not suspicious, but attend to the metadata/instruction mismatch and protect the required DingTalk credential.

✗

scripts/auth.js:22

Environment variable access combined with network send.

Confirmed safe by external scanners

Static analysis detected API credential-access patterns, but both VirusTotal and OpenClaw confirmed this skill is safe. These patterns are common in legitimate API integration skills.

Like a lobster shell, security has layers — review code before you run it.

latestvk97be8y7v5kzv2wfm8hff5ys4n843gfx

97downloads

0stars

5versions

Updated 2w ago

v0.9.4

MIT-0

钉钉日志管理

任务目标

本 Skill 用于：管理钉钉日志（日报、周报）的创建与查询
能力包含：发送日志、查询日志列表、获取模板信息、生成工作质量总结
触发条件：用户表达"发送日报"、"创建周报"、"查询日志"、"查看我的日报"、"工作总结"等意图

前置准备

依赖说明：脚本使用axios进行HTTP请求
```
npm install axios
```
凭证配置：需要钉钉企业内部应用的AppKey和AppSecret
- 已预置凭证：dingtalk_api
- 凭证环境变量：COZE_DINGTALK_API_<skill_id>

操作步骤

场景一：发送日报/周报

流程说明：

智能体确认用户意图（日报或周报）及内容
调用脚本获取模板信息
调用脚本创建并发送日志

详细步骤：

获取模板信息
- 调用：node scripts/get-template.js --userid <用户工号> --template-name <日报|周报>
- 返回：模板ID、字段列表及排序信息
- 示例：
```
node scripts/get-template.js --userid 2010100111 --template-name 日报
```
创建并发送日志
- 调用：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
```

场景二：查询日报/周报

流程说明：

智能体确认查询时间范围和模板类型
调用脚本查询日志列表
智能体格式化展示结果
智能体生成工作质量总结（新增）

详细步骤：

查询日志列表
- 调用：node scripts/query-report.js --userid <用户工号> --template-name <日报|周报> --start-time <开始时间戳> --end-time <结束时间戳> [--cursor 0] [--size 10]
- 参数说明：
  - --userid：查询用户的工号
  - --template-name：模板名称（日报或周报）
  - --start-time：查询开始时间，Unix时间戳（毫秒）
  - --end-time：查询结束时间，Unix时间戳（毫秒）
  - --cursor：分页游标（可选，默认0）
  - --size：每页数量（可选，默认10）
- 示例：
```
node scripts/query-report.js \
  --userid 2010100111 \
  --template-name 日报 \
  --start-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分 - 协作顺畅

---

### 一、工作亮点
1. **任务完成度高**：本周共完成15项任务，完成率达85%
2. **主动推进项目**：主动协调解决了3个跨部门协作问题
3. **效率提升**：文档编写工作较上周提前2天完成

### 二、改善建议
1. **待办事项管理**：建议对"性能优化"任务进行拆分，设置阶段性目标
2. **时间预估**：部分任务实际耗时超出预估，建议预留缓冲时间
3. **工作聚焦**：本周涉及5个不同项目，建议优先聚焦核心项目

### 三、整体评价
本周工作整体表现良好，任务推进有序。建议下周加强待办事项的时间管理，
优先处理积压任务，并提升工作时间的专注度。

注意事项：

评分应基于客观数据和事实，避免主观臆断
建议应具体可执行，避免空泛表述
语气应客观、建设性，以帮助改进为目的
可根据用户需求调整总结的详细程度

资源索引

认证脚本：见 scripts/auth.js（获取access_token，内部调用）
获取模板：见 scripts/get-template.js（获取日志模板信息）
创建日志：见 scripts/create-report.js（创建并发送日志）
查询日志：见 scripts/query-report.js（查询日志列表）
API规范：见 references/api-spec.md（钉钉日志API详细说明）

注意事项

时间格式：所有时间参数均为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. **沟通协调**：需协调事项较多，建议提前沟通
   
   ### 三、整体评价
   本周工作推进顺利，建议下周加强时间规划能力。

场景三：根据姓名搜索工号

流程说明：

智能体确认要搜索的用户姓名
调用脚本搜索用户
智能体展示搜索结果（可能有多个匹配）

详细步骤：

搜索用户工号
- 调用：node scripts/search-user.js --query-word <用户姓名> [--offset 0] [--size 10] [--full-match 1]
- 参数说明：
  - --query-word：搜索关键词（用户姓名）
  - --offset：分页偏移量（可选，默认 0）
  - --size：每页数量（可选，默认 10）
  - --full-match：是否完全匹配（可选，1=完全匹配，0=模糊匹配，默认 1）
- 返回：工号列表、总数、是否有更多
- 示例：
```
node scripts/search-user.js --query-word "陈亮"
```
结果处理
- 脚本返回匹配的用户工号列表
- 智能体展示结果，如有多个匹配需让用户确认
- 获取工号后可用于发送/查询日志

示例输出：

{
  "list": ["", "", ""],
  "hasMore": false,
  "totalCount": 3
}

资源索引

认证脚本：见 scripts/auth.js（获取access_token，内部调用）
获取模板：见 scripts/get-template.js（获取日志模板信息）
创建日志：见 scripts/create-report.js（创建并发送日志）
查询日志：见 scripts/query-report.js（查询日志列表）
搜索用户：见 scripts/search-user.js（根据姓名搜索工号）
API规范：见 references/api-spec.md（钉钉日志API详细说明）

异常处理

凭证缺失：提示用户配置AppKey和AppSecret
权限不足：提示联系管理员开通相应接口权限
时间范围错误：提示调整查询时间范围（不超过180天）
模板不存在：提示检查模板名称（仅支持"日报"和"周报"）
网络错误：提示检查网络连接或稍后重试

Comments

Loading comments...