name: work-report
description: 根据 git 提交记录撰写每日或每周工作报告。当用户要求撰写或发送日报/站会报告、周报，特别是提及“日报”、“发日报”、“周报”、“发周报”、“daily report”、“weekly report”或“work report”时使用。

工作报告

工作流程

• 确定本地日期并格式化为 MM.DD（不包含年份）。
• 根据用户请求决定是生成日报还是周报。
• 确认用于扫描多个仓库的工作空间根路径；如果用户未提供，则首先检查 WORK_REPORT_ROOT 或 CODEX_WORK_ROOT 环境变量，若未设置则向用户询问。
• 对于日报：收集目标根路径下所有仓库中指定作者的 git 提交主题，并按项目（仓库）分组。
• 优先使用 scripts/git_today_commits.sh --root <路径> --period daily --group-by-repo。
• 必要时，可对每个仓库手动运行：git log --since=midnight --author "<姓名>" --pretty=format:%s。
• 将提交主题重写为简洁的中文条目，然后在每个项目下转换为编号列表（避免输出英文）；将低价值或敏感短语（例如“解决冲突”）替换为更符合业务场景的表述（例如“代码集成与稳定性维护”）。
• 如果没有提交记录，则请用户手动提供条目。
• 对于周报：将 git 提交汇总为简洁的中文条目，并按项目分组（除非没有提交记录，否则不需要用户输入）。
• 优先使用 scripts/git_today_commits.sh --root <路径> --period weekly --group-by-repo。
• 将提交主题转换为每个项目 1-5 条中文摘要条目（合并相似的变更）。
• 仅将包含 .git 文件夹或文件的目录视为项目。忽略非 git 目录。包含根路径下的嵌套仓库。

脚本使用

使用 scripts/git_today_commits.sh 来列出提交主题。

• 如果当前不在本技能目录中，请通过 ~/.codex/skills/work-report/scripts/git_today_commits.sh（或 $CODEX_HOME/skills/work-report/scripts/git_today_commits.sh）调用。
• --root <路径> 是必需的，除非提供了 --repo 或已设置 WORK_REPORT_ROOT/CODEX_WORK_ROOT。
• 默认作者信息来自 git config --global user.name，其次是 git config --global user.email。
• 使用 --root <路径> 来指定不同的根文件夹。
• 使用 --repo <路径> 来指定单个仓库。
• 使用 --author "姓名" 来覆盖作者。
• 使用 --period daily|weekly 来选择时间范围。
• 使用 --since "<表达式>" 来覆盖时间范围（例如 "yesterday"）。
• 使用 --with-repo 为每个条目添加仓库名前缀。
• 使用 --group-by-repo 以按仓库分组输出，便于报告格式化。
• 默认情况下，会收集所有分支的提交（git log --all）。使用 --no-all 可限制为当前分支。
• 默认启用规范化，以使条目更符合业务场景；使用 --no-normalize 可保留原始的提交主题。
• 使用 --summary-source subject|diff|both 来切换摘要来源（diff 模式会总结文件/模块变更）。

输出格式

• 日报：使用“今日工作总结”作为标题。当脚本输出项目符号时，将其转换为编号列表。

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

• 周报：使用“本周工作总结”作为标题。周报条目是基于 git 提交生成的中文摘要。时间范围应遵循自然周（从周一开始）。

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