commit-zh

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。

硬性约束

1. 禁止修改任何代码或文件。
2. 禁止执行 git commit、git add、git reset、git checkout、git restore 或任何会改变仓库状态的命令。
3. 禁止输出除 commit message 以外的任何内容。
4. 必须使用简体中文。
5. 必须将最终 commit message 放在单个 Markdown 代码块中。
6. 获取 diff 时必须执行 git -P diff HEAD，严禁使用 git diff HEAD。
7. 如果用户在 /commit_zh 后提供了额外参数，则将其视为输出路径或输出目录。

执行步骤

1. 先确认当前目录是 Git 仓库。

2. 执行 git status --short --untracked-files=all，逐行解析所有文件状态，包括 A、M、D、R、C、U、?? 等。

3. 执行 git -P diff HEAD，用它作为 tracked 变更的主要事实来源。

4. 如果 git status --short --untracked-files=all 中包含 ??，可以只读方式查看这些未跟踪文件内容，以补全逐文件说明，但仍然必须先执行 git -P diff HEAD。

5. 基于变更占比与业务价值优先级判定核心意图，优先级为：功能 > 修复 > 重构 > 配置 > 文档 > 样式 > 构建 > git。

6. 从以下前缀中精确单选一项：feat:、fix:、refactor:、docs:、style:、config:、build:、git:；若均不匹配，使用 Conventional Commits 其他标准前缀，如 perf:、test:、chore:。

7. 首行格式必须为：前缀: 一句话核心描述

8. 首行长度限制：≤ 60 个英文字符或 ≤ 30 个汉字，且句尾禁止加句号。

9. 首行后空一行，使用 - 项目符号列出概要条目：

   • 每条对应一个次级改动
   • 粒度细化到文件或逻辑单元
   • 每条 ≤ 100 字符
   • 按字母序或路径序排列
   • 风险、兼容性、边界情况要单独成条
   • 禁止空项或重复项

10. 再空一行后，针对 git status 中的每一个文件输出逐文件改动说明，格式严格为：

    - **新文件** 路径: 说明

    - **删除** 路径: 说明

    - **修改** 路径: 说明

    - **重命名** 旧路径 → 新路径: 说明

11. 逐文件说明要求：

    • 新文件：说明职责与新增原因
    • 删除：说明删除动机与影响范围
    • 修改：尽量按函数、配置项、行为变化、输入输出变化、算法或性能影响描述
    • 重命名：说明重命名目的及映射关系
    • 建议按“新文件 → 修改 → 删除 → 重命名”分组，组间空一行

12. 解析用户对 /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

13. 如果提供了输出参数，在生成最终 commit message 后：

    • 取当前 Git 仓库根目录名作为 project_name
    • 调用当前 skill 目录中的 save_commit_message.sh
    • 传入仓库根目录与用户提供的目标路径
    • 通过标准输入传入不带 Markdown 代码块围栏的原始 commit message
    • 当目标是目录，或路径以 / 结尾，默认文件名为 ${project_name}_commit_message.txt

14. 最终回复时，只能返回一个 Markdown 代码块；代码块内就是完整 commit message，不要加解释、标题、前言、路径提示或后记。

额外要求

• 如果工作区为空，没有可描述的变更，输出一个 Markdown 代码块，内容为：chore: 当前无可提交变更
• 不要省略任何出现在 git status --short --untracked-files=all 中的文件
• 不要编造 diff 中不存在的行为变化
• 即使写入了文件，最终回复格式仍然只能是单个 Markdown 代码块