--- 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 --period daily --group-by-repo`. - If needed, run manually per repo: `git log --since=midnight --author "" --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 --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 ` 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 ` to target a different root folder. - Use `--repo ` to target a single repo. - Use `--author "Name"` to override author. - Use `--period daily|weekly` to pick the time range. - Use `--since ""` 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. 2. <项目B> 1. ``` 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. 2. <项目B> 1. ```