Gitmoji Commit Skill

此 Skill 用于帮助用户自动化 Git 提交流程。你需要分析代码变更，结合当前的会话上下文（用户之前的指令和你的修改），生成符合 Gitmoji 规范的提交信息。

核心原则

1. •始终使用中文撰写 Subject。
2. •严禁推送 (git push)，仅执行本地提交 (git commit)。
3. •格式规范: <emoji> <type>(<scope>): <subject>
   • •Emoji: 使用 Gitmoji 代码（如 :sparkles:）或 Unicode 字符（如 ✨），推荐使用代码格式以便兼容性。
   • •Subject: 简练的中文描述，动词开头，不超过 50 个字符。
   • •Example: :sparkles: feat(auth): 添加登录功能
   • •Example: :bug: fix(nav): 修复导航栏样式偏移

执行步骤

1. 检查暂存区

首先，检查是否有已暂存的文件：

git diff --cached --name-only

• •若无暂存文件: 提示用户“检测到暂存区为空，请先使用 git add 暂存文件”，并停止执行。
• •若有暂存文件: 继续下一步。

2. 分析变更与上下文

运行 git diff --cached 获取详细变更内容。同时，必须回顾当前的会话历史：

• •用户刚才要求做什么？
• •代码的具体变动是什么？
• •如果有多个变更，主要意图是什么？（例如：如果既修改了构建脚本又修复了 bug，优先选择影响最大的那个，或者分两次提交——但在本 Skill 中，默认生成一个包含主要变更意图的提交）。

3. 生成提交信息

根据分析结果，从下表中选择最准确的 Emoji 和 Type。

Gitmoji 参考手册

(Agent 请注意：选择时请优先匹配最具体的情境。例如：如果是更新 package.json 的版本号，用 :arrow_up: 或 :arrow_down: 或 :heavy_plus_sign: 比通用的 :package: 或 :wrench: 更好。如果是单纯的样式修改，必须用 :lipstick:)

4. 用户交互与执行

必须先向用户展示你生成的提交命令，并请求确认。

示例对话:

Agent: 暂存区包含 package.json 的依赖更新。 建议提交信息： git commit -m ":arrow_up: chore(deps): 升级 vue 版本至 3.4"

是否执行？

只有在用户明确回复“是”、“确认”或“ok”后，才执行 run_command：

git commit -m ":your-emoji: type(scope): subject"

注意事项

• •如果用户对生成的提交信息不满意，请根据用户的反馈进行调整，再次请求确认。
• •提交成功后，告知用户提交已完成，并提醒用户自行推送 (push)。