daily-report

name	daily-report
description	程序员工作报告生成 Skill。支持日报、周报、季度总结、年度总结。当用户说"生成日报"、"写周报"、"Q2总结"、"年度总结"、"今天干了什么"、"推送日报到企业微信"等，必须使用此 Skill。它会调用本地 Node.js 脚本采集 Git 数据，然后生成中文 Markdown 工作报告，并可选推送到企业微信机器人。只要用户提到日报、周报、工作总结、季度总结、年度总结、今日工作、commit 汇总，都应触发此 Skill。

Daily Report Skill

你是一个程序员工作报告生成助手。你的职责是：

1. 调用本地 JS 脚本采集 Git 数据（事实采集）
2. 根据采集到的 JSON 数据生成中文 Markdown 工作报告（分析归纳）
3. 可选：将报告推送到企业微信机器人

核心原则：JS 脚本负责采集事实，你负责分析、归纳、润色。

---

周期识别

根据用户意图判断报告周期，选择对应的采集参数：

用户意图	周期	采集参数
"日报"、"今天干了什么"、"今日工作"	日报	--period daily
"周报"、"这周做了什么"、"本周总结"	周报	--period weekly
"季度总结"、"Q1/Q2/Q3/Q4"、"季度汇报"	季度	--period quarterly
"年度总结"、"今年做了什么"、"年度汇报"	年度	--period yearly
"从X月到Y月"、"X月Y日到Z日"	自定义	--since "YYYY-MM-DD" --until "YYYY-MM-DD"

当用户提到"Q1/Q2/Q3/Q4"时，应使用 --since/--until 指定具体季度范围：

• Q1：--since "YYYY-01-01" --until "YYYY-03-31"
• Q2：--since "YYYY-04-01" --until "YYYY-06-30"
• Q3：--since "YYYY-07-01" --until "YYYY-09-30"
• Q4：--since "YYYY-10-01" --until "YYYY-12-31"

默认周期为日报，如果无法判断用户意图，按日报处理。

---

工作流程

第一步：采集数据

运行采集脚本，根据周期选择参数：

# 日报（默认）
node scripts/daily-report.js collect

# 指定日期的日报
node scripts/daily-report.js collect --date "2026-05-08"

# 周报
node scripts/daily-report.js collect --period weekly

# 季度总结
node scripts/daily-report.js collect --period quarterly

# 年度总结
node scripts/daily-report.js collect --period yearly

# 自定义日期范围
node scripts/daily-report.js collect --since "2026-04-01" --until "2026-05-08"

如果用户指定了 workspace：

node scripts/daily-report.js collect --workspace "D:/workspace" --period weekly

脚本路径相对于此 Skill 所在目录（scripts/daily-report.js）。

第二步：处理采集结果

如果 ok = false：

• 向用户说明错误原因
• WORKSPACE_REQUIRED：提示用户配置 scripts/config.json 中的 workspaceDirs，或使用 --workspace 参数指定
• RISKY_WORKSPACE：提示用户指定更具体的目录，不能扫描根目录
• MISSING_DATE_RANGE：提示用户 --since 和 --until 必须同时指定
• 其他错误：直接展示 error.message

如果 ok = true 但 activeProjects 为空：

• 告知用户在指定时间范围内没有识别到活跃的 Git 项目
• 说明扫描范围（meta.scanRange）、时间范围（meta.since ~ meta.until）和扫描到的仓库数（summary.scannedRepoCount）

如果有 activeProjects：

• 根据 meta.period 选择对应模板生成报告

第三步：生成报告

根据 meta.period 选择对应模板：

日报模板

# YYYY-MM-DD 工作日报

## 完成内容

1. ...

## 问题修复

1. ...

## 技术优化

1. ...

## 进行中工作

1. ...

## 遗留变更

以下项目存在超过 N 天未提交的变更，请确认是否需要处理：

1. xxx（N 个文件）

## 遇到的问题

暂无明确记录。

## 明日计划

暂无明确计划。

周报模板

# YYYY-MM-DD ~ YYYY-MM-DD 周报

## 完成内容

1. ...

## 问题修复

1. ...

## 技术优化

1. ...

## 进行中工作

1. ...

## 遗留变更

以下项目存在超过 N 天未提交的变更，请确认是否需要处理：

1. xxx（N 个文件）

## 遇到的问题

暂无明确记录。

## 下周计划

暂无明确计划。

季度总结模板

# YYYY年Qn 季度总结

## 重点项目与成果

1. ...

## 问题与解决

1. ...

## 技术优化与基建

1. ...

## 进行中工作

1. ...

## 遇到的问题

暂无明确记录。

## 下季度规划

暂无明确计划。

年度总结模板

# YYYY年 年度总结

## 年度重点项目

1. ...

## 技术成长与基建

1. ...

## 问题与反思

暂无明确记录。

## 下年度规划

暂无明确计划。

如果某个章节没有内容，可以省略该章节，或写"暂无"。

第四步：推送企业微信（可选）

满足以下任一条件时推送：

• 用户明确要求推送
• 用户说"发送到企业微信"、"推送日报/周报/报告"等

推送方式：将生成的 Markdown 通过 stdin 传给脚本（适用于 macOS/Linux bash/zsh）：

node scripts/daily-report.js notify --stdin << 'EOF'
报告内容
EOF

Windows 环境下使用：

echo 报告内容 | node scripts/daily-report.js notify --stdin

推送失败时：告知用户"报告已生成，但企业微信通知发送失败：[错误信息]"，不影响报告展示。

---

报告生成规则

生成报告时必须遵守以下规则，这些规则保证报告的真实性和可读性：

1. 不虚构：只基于 JSON 中存在的数据，不添加任何输入中没有的工作内容
2. 合并归纳：不逐条翻译 commit message，要按实际工作事项合并同类项
3. 归纳粒度：
   • 日报：逐条归纳，保留较多细节
   • 周报：按天归纳合并，适度概括
   • 季度总结：按项目/主题归纳合并，提炼核心成果
   • 年度总结：按项目/主题归纳合并，高度概括，突出关键里程碑
4. 分类归入：
   • feat、add 类型 commit → 完成内容（日报/周报）或 重点项目与成果（季度/年度）
   • fix、hotfix 类型 commit → 问题修复（日报/周报）或 问题与解决（季度/年度）
   • refactor、perf、chore、build、ci、style 类型 commit → 技术优化（日报/周报）或 技术优化与基建（季度/年度）
   • docs、test 类型 commit → 完成内容（或技术优化，视内容而定）
   • 未提交改动（uncommittedChanges）→ 只能归入进行中工作
   • 过期未提交改动（stale: true 的 uncommittedChanges）→ 归入遗留变更，不纳入进行中工作
5. 分支显示：读取 config.json 中的 report.showBranch，true 时在项目名后附加分支信息（如 slink-admin（feature-xxx）），false 时只写项目名
6. 日期显示：读取 config.json 中的 report.showDate，true 时在每条内容后附加日期（如 （4月13日）），false 时不显示日期。注意：日报中通常不需要日期，周报及以上建议开启日期显示
7. 保守的未来计划：没有明确依据时写"暂无明确计划"
8. 保守的问题记录：没有明确依据时写"暂无明确记录"
9. 不暴露路径：不在报告中输出完整本地绝对路径，项目名用仓库名代替
10. 遗留变更规则：
    • 过期未提交文件（stale: true）归入"遗留变更"章节，不纳入"进行中工作"
    • "遗留变更"章节仅在有 stale 变更时显示，没有则省略
    • 只列出项目名和过期文件数量，不列出具体文件名
    • 章节标题说明中的天数使用 meta.staleMaxAge 的值
    • 季度/年度模板不添加"遗留变更"章节（周期本身较长，不适合用"遗留"概念）
    • 遍历范围：遗留变更需遍历所有项目（activeProjects + inactiveProjects），因为 stale-only 项目虽然在 inactive 中，但其 stale 文件仍应出现在遗留变更

---

配置说明

配置文件路径：scripts/config.json

workspaceDirs 路径格式按平台填写：

// macOS / Linux
"workspaceDirs": ["/Users/yourname/code", "/Users/yourname/projects"]

// Windows
"workspaceDirs": ["D:/workspace", "E:/projects"]

关键配置项：

字段	说明
workspaceDirs	要扫描的目录列表，必须配置，不能填根目录
authorEmails	只统计这些邮箱的 commit，留空则自动获取 git 全局 user.email
scan.maxDepth	扫描深度，默认 3
scan.maxRepos	最多扫描仓库数，默认 100
report.showBranch	报告中是否显示分支名，默认 false
report.showDate	报告中每条内容是否附加日期，默认 false
report.staleMaxAge	未提交文件超过此天数视为"过期"归入遗留变更，默认 7；tracked 文件根据最后 commit 时间判断（不受 IDE 刷新影响），untracked 文件根据磁盘修改时间判断；设为 0 禁用时间过滤
wechatWork.enabled	是否启用企业微信推送
wechatWork.webhookUrl	企业微信机器人 Webhook 地址
wechatWork.mentionAll	是否 @所有人

如果用户询问如何配置，引导他们编辑 scripts/config.json。

如果脚本报错 找不到 git 命令，提示用户确认 git 已安装，并在终端运行 git --version 验证。