fit-commit

Commit Command

提交当前变更到 Git。

此命令提供 Git 提交的最佳实践指南。

用法：

• /prompts:fit-commit - 查看提交指南

功能说明：

本命令会引导你完成以下步骤：

1. 检查并更新版权头年份（CRITICAL）
2. 分析变更内容并生成提交信息
3. 执行 Git 提交操作
4. 更新任务状态（如适用）

注意事项：

• 不要提交包含敏感信息的文件（.env, credentials 等）
• 确保提交消息清晰描述了变更内容
• 遵循项目的 commit message 规范
• 提交前必须检查版权头年份（见下文）

---

⚠️ 提交前确认用户本地修改（CRITICAL）

强制要求：在执行任何编辑操作之前，必须先检查用户的本地修改，避免覆盖用户的工作。

检查流程

步骤 0：检查用户本地修改

# 查看所有已修改的文件
git status --short

# 查看每个文件的具体修改内容
git diff

处理规则：

1. 仔细阅读 git diff 的输出，理解用户已经做了哪些修改
2. 在用户修改的基础上进行增量编辑，不要覆盖用户的实现
3. 如果你计划的修改与用户的修改有冲突，必须先询问用户：

   我发现该文件已有本地修改：
   - 你的修改：[描述用户的修改]
   - 我计划的修改：[描述你计划的修改]
   请确认如何处理。
   

4. 禁止按自己的想法重写用户已经实现的代码
5. 禁止添加用户没有要求的"改进"

---

⚠️ 提交前的版权头年份检查（CRITICAL）

强制要求：在执行提交之前，必须检查并更新所有修改文件的版权头年份。参见项目规则第 5 条。

检查流程

步骤 1：自动获取当前年份

# 动态获取当前年份（绝对不要硬编码）

## 使用前：自动识别仓库

命令会默认使用当前工作目录所在的 Git 仓库作为目标，无需传入仓库参数。若当前目录不在 Git 仓库内，请先 `cd` 到目标仓库根目录后再执行。

文中所有路径示例默认以仓库根目录为基准。

current_year=$(date +%Y)
echo "当前年份: $current_year"

步骤 2：检查修改的文件

# 查看即将提交的文件
git status --short

# 或查看已暂存的文件
git diff --cached --name-only

步骤 3：检查版权头

对于每个修改的文件：

# 检查文件是否包含版权头
grep -l "Copyright" <modified_file>

# 查看版权年份
grep "Copyright.*[0-9]\{4\}" <modified_file>

步骤 4：更新版权年份

如果文件包含版权头且年份不是当前年份，使用 Edit 工具更新：

常见格式：

• Copyright (C) 2024-2025 → Copyright (C) 2024-<current_year>
• Copyright (C) 2024 → Copyright (C) 2024-<current_year>
• Copyright (C) 2025 → Copyright (C) <current_year>（如果已是当前年）

示例：

# 示例输出：命令返回 2026

# 格式 1：年份范围
Edit(
  file_path="src/example.java",
  old_string="Copyright (C) 2024-2025 FIT Framework",
  new_string="Copyright (C) 2024-2026 FIT Framework"
)

# 格式 2：单一年份
Edit(
  file_path="src/another.java",
  old_string="Copyright (C) 2024 FIT Framework",
  new_string="Copyright (C) 2024-2026 FIT Framework"
)

检查清单

在执行 git commit 之前，必须确认：

• 已使用 date +%Y 动态获取当前年份
• 不需要也不允许手动输入年份
• 已检查所有即将提交的修改文件
• 对于包含版权头的文件，已检查年份是否为当前年份
• 如果年份不是当前年份，已使用 Edit 工具更新
• 绝对不要硬编码年份（如 2026）
• 只更新修改的文件，不批量更新项目中所有文件