菜单
按指定记录、commit 或范围分析 Git 改动，生成面向上级的精简 Word 变更报告（具体改动地方 + 改动文件说明），并落一条变更记录。全程只读，无代码、无敏感信息。输出到 `报告文档/代码/<项目>/`（md形式 + word形式 + 变更记录.md），委托 docx skill 渲染。触发词：提交报告、改动报告、本周工作总结、给上级的报告、change report、这次改了什么。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/2021291696/worklog-alllog --skill change-report命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | change-report |
| description | 按指定记录、commit 或范围分析 Git 改动，生成面向上级的精简 Word 变更报告（具体改动地方 + 改动文件说明），并落一条变更记录。全程只读，无代码、无敏感信息。输出到 `报告文档/代码/<项目>/`（md形式 + word形式 + 变更记录.md），委托 docx skill 渲染。触发词：提交报告、改动报告、本周工作总结、给上级的报告、change report、这次改了什么。 |
按本次 git 改动生成面向上级的正式变更报告：具体改了什么、改在哪些文件、为什么改。结构与 worklog 平行：md/word 分目录 + 变更记录流水 + 按改动范围起点命名。全程只读（git status/log/diff），无代码、无敏感信息。
按项目分目录：<项目> = 报告文档/代码/_projects.json 里仓库路径的映射名；未映射的仓库用 git 根目录名。仓库里 scripts/project_name.py 是同一条规则的可执行副本：python scripts/project_name.py <git-root> [_projects.json]。
报告文档/代码/<项目>/
├── 变更记录.md # 变更流水账，只追加从不覆盖
├── md形式/<范围起点>.md # md 报告源，可重复生成
└── word形式/<范围起点>.docx # Word 报告（docx skill 渲染）
<范围起点> = 本次改动范围最旧 commit 的日期（git show -s --format=%cs <base>）；仅未提交改动时用今天。目标文件已存在 → 先确认覆盖。
change-report 可在 commit 前、push 前、push 后或补记后调用；不要求固定顺序，也绝不为了凑齐流程而编造状态。
报告状态如实标记：
draft：存在未提交改动local-commit：已有本地 commit，尚未确认已推送pushed：本地远端跟踪信息或状态索引证明已推送unknown：无法可靠确认远端状态重复调用同一范围时，默认展示或更新 md 草稿，再重新渲染。md 源保留在 md形式/。成功生成后可将 reported 与输出路径写入本地状态索引，但不得将索引或报告内容自动提交、推送。
git rev-parse --is-inside-work-tree，非 git 仓库 → 报错退出。展示候选范围（未提交改动 / 未推送 commit / 已推送未合并 commit），请用户选择或显式指定：
--record <ID> / --range <base>..<head> / --commit <SHA>比较基准按 origin/main → main → master 取第一个存在的主干：
git status --short
git log origin/main..HEAD --oneline 2>/dev/null || git log main..HEAD --oneline 2>/dev/null || git log master..HEAD --oneline 2>/dev/null || git log HEAD --oneline -5
读 docs/change-log.md（若存在）——提取本次改动相关条目作背景/细节参照。不存在则跳过。
git diff --stat # 改动概览
git diff -- <主要文件> # 细读关键改动（判断模块作用）
git log <主干>..HEAD -p --stat # 结合 commit message 推断"为什么"
生成报告草稿（见"报告格式"）。"为什么"三源合成：
展示草稿，重点请用户确认/补充"大点原因"。确认前不落稿。
确认后，把本次改动追加到 报告文档/代码/<项目>/变更记录.md：
## 2026-08-12
- [改动主题] <具体改动地方：文件/位置 + 动作 + 作用>
只追加，绝不覆盖或改动历史条目。同主题已记录 → 跳过并提示"该改动已记录"，或提示合并到已有条目。
报告文档/代码/<项目>/md形式/<范围起点>.md报告文档/代码/<项目>/word形式/<范围起点>.docx输出：.docx 路径 + 报告摘要（一句话目标 + 大点列表）。
# 变更报告 · YYYY-MM-DD
## 一句话目标
本次完成了<什么>，达成了<什么>。
## 背景
<1-2 句正式书面语：本次迭代在做什么、为什么值得做。>
## 本次改动
**<大点 1：主题>**
原因：<该主题现状的正式问题>
- <小点 a>：<文件/位置 + 具体改动 + 作用>
- <小点 b>：<文件/位置 + 具体改动 + 作用>
**<大点 2：主题>**
原因：<...>
- <小点 a>：<...>
## 改动文件
<按模块分组列出本次改动涉及的文件路径（git diff --name-only <主干>..HEAD）>
## 验证结果
- <验证方式 + 结果，1-2 条>
结构规则：
git diff --name-only <主干>..HEAD 取清单，按模块分组（如 Java Agent / Rust 后端 / Flutter 前端 / 配置与工程化），直接列文件路径；只列路径，无行号、无代码、无命令风格铁律：
报告文档/代码/<项目>/（md形式/word形式/变更记录.md），用户显式指定路径时以用户为准；目标文件已存在须确认覆盖。