docs(opencode): 优化提交命令的规范说明

CodeCasterX · claude · CodeCasterX · commit a25a9bcb3c4f · 2026-01-23T14:34:22.000+08:00
增强 commit 命令的执行规范:
- 添加版权头年份检查和更新的详细流程
- 规范多行提交消息格式（标题+正文+签名）
- 详细说明使用 HEREDOC 格式执行 git commit
- 强调提交消息应说明"为什么"而不仅是"改了什么"

Co-Authored-By: Claude Sonnet 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/.opencode/commands/commit.md b/.opencode/commands/commit.md
@@ -34,27 +34,78 @@ subtask: false
    !`git diff`
    !`git log --oneline -5`
 
-2. 分析变更:
-   - 确定变更类型(新功能/增强/Bug修复/重构/测试/文档等)
-   - 生成符合规范的提交消息(参考最近的 commit 格式)
-   - 提交消息格式: `<type>(<scope>): <subject>`，subject 使用中文且约 20 字以内
-   - scope 为模块名(如 fit、waterflow、fel)，可省略
+2. 分析变更并生成**详细的**提交消息:
+
+   **提交消息结构（CRITICAL）**:
+   ```
+   <type>(<scope>): <subject>
+
+   <body>
+
+   Co-Authored-By: <你的模型名称> <noreply@anthropic.com>
+   ```
+
+   **各部分要求**:
+   - **标题行**: `<type>(<scope>): <subject>`
+     * type: feat/fix/refactor/docs/build/test/chore 等
+     * scope: 模块名(如 fit、waterflow、fel)，可省略
+     * subject: 中文，约 20 字以内，概括变更
+
+   - **正文(body)**: 详细说明变更内容
+     * 用 2-4 个要点说明具体做了什么
+     * 每个要点用 `-` 开头
+     * 解释"为什么"这样改，而不仅仅是"改了什么"
+
+   - **签名**: 始终添加 Co-Authored-By，模型名称由你自己声明（如 Claude Sonnet 4.5、GPT-5.2、Gemini-3 等）
+
+   **示例**（仅供参考格式，不要直接复制内容）:
+   ```
+   docs(opencode): 规范命令编写标准并添加风格指南
+
+   优化所有自定义命令的执行方式:
+   - 统一使用 `!` 标记可执行命令
+   - 添加错误处理和状态检查
+   - 改进时间戳获取方式（先获取再引用）
+   - 新增 COMMAND_STYLE_GUIDE.md 编写规范文档
+
+   Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+   ```
+
    - 不要提交敏感文件(.env, credentials.json等)
 
 **步骤 3: 提交代码**
 
 1. 添加文件到暂存区:
    !`git add .`
-   
+
    或指定特定文件:
    !`git add <file1> <file2>`
 
 2. 创建提交:
-   !`git commit -m "<提交消息>"`
+
+   使用 HEREDOC 格式执行 git commit，支持多行提交消息。
+
+   **命令格式**（仅供参考，实际执行时替换占位符）:
+   ```bash
+   git commit -m "$(cat <<'EOF'
+   <type>(<scope>): <subject>
+
+   <body 详细说明>
+
+   Co-Authored-By: <你的模型名称> <noreply@anthropic.com>
+   EOF
+   )"
+   ```
+
+   **执行要求**:
+   - 根据步骤 2 分析的变更内容，生成实际的提交消息
+   - 将上述格式中的占位符替换为实际内容
+   - Co-Authored-By 中的模型名称由你自己声明（你是什么模型就写什么）
+   - 使用 Bash 工具执行完整的 git commit 命令
 
 3. 验证提交成功:
    !`git status`
-   !`git log -1 --oneline`
+   !`git log -1`
 
 **步骤 4: 更新任务状态(如果是任务相关的提交)**
 
