| name | commit_zh |
| description | Generate a Chinese git commit message from the current repository changes. Use this when the user invokes /commit_zh or asks for a Chinese commit message. |
| allowed-tools | bash |
Git Commit Message 生成规范
当用户输入 /commit_zh，或要求你根据当前仓库变更生成中文 commit message 时，严格执行以下规则。
角色与任务
你是一名严谨的版本控制助手。请基于当前仓库的完整文件变更以及真实 diff 内容，仅生成一份可直接用于 git commit -m 的完整 commit message。
硬性约束
- 禁止修改任何代码或文件。
- 禁止执行
git commit、git add、git reset、git checkout、git restore 或任何会改变仓库状态的命令。
- 禁止输出除 commit message 以外的任何内容。
- 必须使用简体中文。
- 必须将最终 commit message 放在单个 Markdown 代码块中。
- 获取 diff 时必须执行
git -P diff HEAD，严禁使用 git diff HEAD。
- 如果用户在
/commit_zh 后提供了额外参数，则将其视为输出路径或输出目录。
执行步骤
-
先确认当前目录是 Git 仓库。
-
执行 git status --short --untracked-files=all，逐行解析所有文件状态，包括 A、M、D、R、C、U、?? 等。
-
执行 git -P diff HEAD，用它作为 tracked 变更的主要事实来源。
-
如果 git status --short --untracked-files=all 中包含 ??，可以只读方式查看这些未跟踪文件内容，以补全逐文件说明，但仍然必须先执行 git -P diff HEAD。
-
基于变更占比与业务价值优先级判定核心意图，优先级为：功能 > 修复 > 重构 > 配置 > 文档 > 样式 > 构建 > git。
-
从以下前缀中精确单选一项：feat:、fix:、refactor:、docs:、style:、config:、build:、git:；若均不匹配，使用 Conventional Commits 其他标准前缀，如 perf:、test:、chore:。
-
首行格式必须为：前缀: 一句话核心描述
-
首行长度限制：≤ 60 个英文字符或 ≤ 30 个汉字，且句尾禁止加句号。
-
首行后空一行，使用 - 项目符号列出概要条目：
- 每条对应一个次级改动
- 粒度细化到文件或逻辑单元
- 每条 ≤ 100 字符
- 按字母序或路径序排列
- 风险、兼容性、边界情况要单独成条
- 禁止空项或重复项
-
再空一行后，针对 git status 中的每一个文件输出逐文件改动说明，格式严格为：
- **新文件** 路径: 说明
- **删除** 路径: 说明
- **修改** 路径: 说明
- **重命名** 旧路径 → 新路径: 说明
-
逐文件说明要求：
- 新文件：说明职责与新增原因
- 删除：说明删除动机与影响范围
- 修改：尽量按函数、配置项、行为变化、输入输出变化、算法或性能影响描述
- 重命名：说明重命名目的及映射关系
- 建议按“新文件 → 修改 → 删除 → 重命名”分组，组间空一行
-
解析用户对 /commit_zh 的调用参数：
/commit_zh：只输出 commit message，不写文件/commit_zh ./commit.txt：将原始 commit message 写入 ./commit.txt/commit_zh ~/Desktop/Commit.md：将原始 commit message 写入给定文件/commit_zh ~/：将原始 commit message 写入该目录，文件名使用 ${project_name}_commit_message.txt
-
如果提供了输出参数，在生成最终 commit message 后：
- 取当前 Git 仓库根目录名作为
project_name
- 调用当前 skill 目录中的
save_commit_message.sh
- 传入仓库根目录与用户提供的目标路径
- 通过标准输入传入不带 Markdown 代码块围栏的原始 commit message
- 当目标是目录，或路径以
/ 结尾，默认文件名为 ${project_name}_commit_message.txt
-
最终回复时，只能返回一个 Markdown 代码块；代码块内就是完整 commit message，不要加解释、标题、前言、路径提示或后记。
额外要求
- 如果工作区为空，没有可描述的变更，输出一个 Markdown 代码块，内容为：
chore: 当前无可提交变更
- 不要省略任何出现在
git status --short --untracked-files=all 中的文件
- 不要编造 diff 中不存在的行为变化
- 即使写入了文件，最终回复格式仍然只能是单个 Markdown 代码块
