work-report – OpenClaw Skill

---

name: work-report description: Write a daily or weekly work report using git commits. Use when the user asks to write or send a daily report/standup or weekly report, especially "日报", "发日报", "周报", "发周报", "daily report", "weekly report", or "work report".

Work Report

Workflow

• Determine local date and format as MM.DD (no year).
• Decide daily vs weekly based on the user's request.
• Confirm the workspace root path for scanning multiple repos; if the user hasn't provided one, first check WORK_REPORT_ROOT or CODEX_WORK_ROOT, then ask.
• For daily reports, collect git commit subjects by author across all repos under the target root, grouped by project (repo).
  • Prefer using scripts/git_today_commits.sh --root <path> --period daily --group-by-repo.
  • If needed, run manually per repo: git log --since=midnight --author "<name>" --pretty=format:%s.
  • Rewrite commit subjects into concise Chinese items and then turn them into a numbered list under each project (avoid English output); replace low-value or sensitive phrases (e.g., "解决冲突") with business-friendly wording (e.g., "代码集成与稳定性维护").
  • If there are no commits, ask the user for manual items.
• For weekly reports, summarize git commits into concise Chinese items grouped by project (do not require user input unless there are no commits).
  • Prefer using scripts/git_today_commits.sh --root <path> --period weekly --group-by-repo.
  • Convert commit subjects into 1-5 Chinese summary items per project (merge similar changes).
• Only treat directories with a .git folder or file as projects. Ignore non-git directories. Include nested repos under the root.

Script

Use scripts/git_today_commits.sh to list commit subjects.

• If you're not in this skill directory, call it via ~/.codex/skills/work-report/scripts/git_today_commits.sh (or $CODEX_HOME/skills/work-report/scripts/git_today_commits.sh).
• --root <path> is required unless --repo is provided or WORK_REPORT_ROOT/CODEX_WORK_ROOT is set.
• Default author comes from git config --global user.name, then git config --global user.email.
• Use --root <path> to target a different root folder.
• Use --repo <path> to target a single repo.
• Use --author "Name" to override author.
• Use --period daily|weekly to pick the time range.
• Use --since "<expr>" to override the time range (e.g., "yesterday").
• Use --with-repo to prefix each item with the repo name.
• Use --group-by-repo to output sections grouped by repo for easier report formatting.
• Commits are collected across all branches by default (git log --all). Use --no-all to limit to the current branch.
• Normalization is enabled by default to make items more business-friendly; use --no-normalize to keep raw commit subjects.
• Use --summary-source subject|diff|both to switch the summary source (diff mode summarizes file/module changes).

Output format

Use "今日工作总结" as the header text for daily reports. When the script outputs bullets, convert them into a numbered list.

MM.DD 今日工作总结
<项目A>
1.<item>
2.<item>
<项目B>
1.<item>

Use "本周工作总结" as the header text for weekly reports. Weekly items are a Chinese summary derived from git commits. The time range should follow the natural week starting Monday.

MM.DD-MM.DD 本周工作总结
<项目A>
1.<item>
2.<item>
<项目B>
1.<item>

Work Report Skill

基于 git 活动生成日报/周报，支持多仓库与项目分组。

安装

Codex CLI

方式一：直接克隆到 Codex 技能目录：

git clone https://github.com/leeguooooo/work-report.git ~/.codex/skills/work-report

方式二：下载 release 的 .skill 并解压到 ~/.codex/skills：

unzip work-report.skill -d ~/.codex/skills

安装完成后重启 Codex。

Claude Code

Claude Code 当前不支持 .skill 格式的原生安装。建议：

1. 克隆此仓库到本地任意目录。
2. 在 Claude Code 的自定义提示/规则中粘贴 SKILL.md 的内容。
3. 需要时手动运行 scripts/git_today_commits.sh，再把输出粘贴给 Claude Code 生成日报/周报。

Cursor

Cursor 不支持 .skill 直接安装。建议：

1. 克隆此仓库到本地任意目录。
2. 在 Cursor 的项目规则/聊天规则中粘贴 SKILL.md 的内容。
3. 需要时手动运行 scripts/git_today_commits.sh，再把输出粘贴给 Cursor 生成日报/周报。

配置

重要提示：支持显式 --root（或使用 --repo 指定单仓库），也支持隐式设置 WORK_REPORT_ROOT/CODEX_WORK_ROOT；未提供任何根目录会报错。 重要提示：Codex 需将 /Approval mode 设为 Agent(full access) 才能正常运行本技能。

示例：

scripts/git_today_commits.sh --root /path/to/your/workspace

也可设置默认根目录（可减少交互）：

export WORK_REPORT_ROOT=/path/to/your/workspace

使用

在 Codex 中可直接说：

• 日报：日报 或 发日报
• 周报：周报 或 发周报

输出时应使用中文条目；若提交信息为英文，请改写/翻译为中文后再生成日报/周报。 默认会对提交信息做“业务化”归一化（例如“解决冲突”会转成“代码集成与稳定性维护”）；如需保留原始提交信息，可用 --no-normalize。

脚本用法：

scripts/git_today_commits.sh --root /path/to/repos --period daily --group-by-repo

说明：

• 只会统计包含 .git 目录或文件的项目，非 git 目录会被忽略
• 默认使用 git log --all，跨分支收集提交（可用 --no-all 限制为当前分支）
• --period weekly 使用自然周（周一开始）作为时间范围
• 可用 --summary-source diff 基于改动文件生成摘要（适合提交信息不够明确的场景）

输出格式

日报：

MM.DD 今日工作总结
<项目A>
1.<item>
2.<item>

周报：

MM.DD-MM.DD 本周工作总结
<项目A>
1.<item>
2.<item>

License

MIT