功能(commands): 添加 opencode arno-pr 提交命令

2026-05-09 23:00:59 +08:00
parent 3fe92a45f9
commit a8f4c879cb
1 changed files with 161 additions and 0 deletions
--- a/.opencode/commands/arno-pr.md
+++ b/.opencode/commands/arno-pr.md
@@ -0,0 +1,161 @@
+---
+name: 提交代码
+description: 提交全部内容并推送到远程仓库（不检查路径）
+---
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+执行前**必须**处理用户输入（非空时）
+
+## 输出
+
+1. 分析本次需要提交的内容，按照**Git 提交规范**整理提交消息
+
+2. 提交全部内容并推送到远程仓库
+
+3. 使用以下格式输出
+
+```text
+项目根目录： xxx
+工作目录： xxx
+本地分支： xxx
+远程分支： xxx
+远程地址： xxx
+用户输入： $ARGUMENTS
+提交哈希： xxx
+提交时间： yyyy-MM-dd HH:MM:SS
+提交日志：
+
+{git日志}
+```
+
+## Git 提交规范
+
+遵循 Conventional Commits 标准，结合项目特定需求制定以下提交规范：
+
+### 提交消息格式
+
+```
+<类型>(<作用域>): <描述>
+
+[可选正文]
+
+[可选脚注]
+```
+
+### 提交类型
+
+**主要类型：**
+- **功能 (`feat`)**: 添加新功能或增强现有功能
+- **修复 (`fix`)**: 修复 bug 或错误行为
+- **维护 (`chore`)**: 维护性任务（依赖更新、配置修改等）
+- **文档 (`docs`)**: 文档更新、README、注释等
+- **重构 (`refactor`)**: 代码重构（不改变外部行为）
+- **测试 (`test`)**: 添加、修改或修复测试代码
+- **格式 (`style`)**: 代码格式化、空白调整等
+- **性能 (`perf`)**: 性能优化改进
+- **构建 (`build`)**: 构建系统、工具链变更
+
+**扩展类型：**
+- **安全 (`sec`)**: 安全相关修复或改进
+- **依赖 (`deps`)**: 依赖包更新或添加
+- **清理 (`clean`)**: 删除无用代码或文件
+- **优化 (`perf`)**: 性能或代码优化改进
+- **配置 (`config`)**: 配置文件修改
+- **规格 (`spec`)**: speckit 规格文档更新
+
+**特殊类型：**
+- **合并 (`merge`)**: 分支合并
+- **进行 (`wip`)**: 工作进行中（开发中的临时提交）
+- **回滚 (`revert`)**: 回滚之前的提交
+- **发布 (`release`)**: 发布版本标签
+
+### 格式要求
+
+**标题行规则：**
+- 使用祈使语气（"添加" 而不是 "添加了"）
+- 长度不超过 50 个字符
+- 类型后使用冒号和空格分隔：`功能: 添加用户认证`
+- 可指定作用域：`功能(auth): 添加 JWT 验证`
+
+**正文内容（可选）：**
+- 标题与正文之间留空行
+- 说明"做什么"和"为什么"，而非"怎么做"
+- 每行不超过 72 个字符
+- 使用项目符号列出多个改动
+
+**脚注信息（可选）：**
+- 标记破坏性变更：`破坏性变更: 详细说明`
+- 关联 issue：`关联: #123` 或 `解决: #456`
+- 标记不兼容变更：`不兼容: API 接口参数调整`
+
+### 提交示例
+
+#### 基础提交
+```bash
+功能: 添加用户登录功能
+修复: 修复内存泄漏问题
+文档: 更新 API 文档
+维护: 更新依赖版本
+```
+
+#### 带作用域的提交
+```bash
+功能(api): 添加用户认证接口
+功能(ui): 添加登录页面组件
+修复(服务端): 修复数据库连接超时
+测试(集成): 添加端到端测试用例
+```
+
+#### 详细描述的提交
+```bash
+功能: 实现实时消息推送
+
+- 添加 WebSocket 连接管理
+- 实现消息广播机制
+- 添加离线消息存储
+- 支持消息确认机制
+
+影响范围：
+- 前端消息组件更新
+- 服务端路由扩展
+- 数据库表结构变更
+
+关联: #89
+```
+
+### Claude Code 提交行为规范
+
+**重要：Git 提交消息格式要求**
+
+- **禁止**在提交消息中添加以下内容：
+  - `🤖 Generated with [Claude Code](https://claude.com/claude-code)`
+  - `Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>`
+  - 任何类似的 AI 工具签名或标识
+
+- **原因**：保持 Git 提交历史的简洁性和专业性，避免冗余的元数据
+
+- **正确示例**：
+  ```
+  文档: 添加用户认证功能
+
+  - 添加 JWT 验证中间件
+  - 实现登录登出接口
+  - 添加权限校验逻辑
+  ```
+
+- **错误示例**（不要这样做）：
+  ```
+  文档: 添加用户认证功能
+
+  - 添加 JWT 验证中间件
+
+  🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+  Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+  ```
+