@ranger1/dx 0.1.15 → 0.1.17

package/opencode/commands/git-commit-and-pr.md

@@ -0,0 +1,276 @@
+---
+allowed-tools: [Bash, Read, Glob, TodoWrite, Edit, Grep]
+description: 'Git 工作流：Issue/Commit/PR 自动化'
+agent: quick
+---
+
+## 用法
+
+```bash
+/git-commit-and-pr                           # 自动检测并执行所需阶段
+/git-commit-and-pr --issue <ID>              # 指定关联 Issue
+/git-commit-and-pr --issue-only              # 仅创建 Issue
+/git-commit-and-pr --pr --base <BRANCH>      # 仅创建 PR
+```
+
+---
+
+## 执行流程
+
+### Step 1: 状态检测
+
+并行执行：
+
+```bash
+git status --short
+git branch --show-current
+git log -1 --format='%H %s' 2>/dev/null || echo "no-commits"
+```
+
+根据状态决定执行阶段：
+
+- 无 Issue 或 `--issue-only` → 执行 Issue 创建
+- 有未提交修改 → 执行 Commit 流程
+- 工作树干净且在功能分支 → 执行 PR 创建
+
+**禁止在 main/master 直接提交。**
+
+---
+
+### Step 2: Issue 创建（可选）
+
+#### 2.1 信息收集与分析
+
+**代码变更分析（并行执行）：**
+
+```bash
+git status --short
+git diff --stat
+```
+
+**重复检查（可选）：**
+
+```bash
+gh issue list --search "<关键词>" --limit 5
+```
+
+**上下文提炼：**
+
+- 从对话历史中提取问题描述和需求背景
+- 识别受影响的模块（backend/front/admin/shared）
+- 确认是否涉及数据库、API 或基础设施变更
+
+#### 2.2 Issue 内容生成
+
+**标题生成策略：**
+
+- 格式：`[模块] 简洁描述` 或 `[类型] 功能/问题描述`
+- 示例：
+  - `[Backend] 优化用户认证流程性能`
+  - `[Bug] 修复聊天消息丢失问题`
+  - `[规范] 统一错误码命名规范`
+- 优先使用用户提供的 `--title` 参数
+
+**标签选择（基于内容自动添加）：**
+
+- `bug` - Bug 修复
+- `enhancement` - 功能增强
+- `documentation` - 文档相关
+- `performance` - 性能优化
+- `refactor` - 代码重构
+- `backend` / `frontend` - 模块标签
+- `infrastructure` - 基础设施
+
+**正文结构模板：**
+
+```markdown
+## 背景
+
+[当前场景、讨论来源、为什么需要这个改动]
+
+## 现状/问题
+
+[观察到的问题、现有实现的不足、需要改进的地方]
+
+## 期望行为
+
+[目标状态、期望结果、验收标准]
+
+## 执行计划
+
+- [ ] 步骤 1
+- [ ] 步骤 2
+- [ ] 步骤 3
+
+## 影响范围
+
+[受影响的模块、可能的风险、需要通知的团队]
+
+## 相关资源
+
+[相关 Issue、PR、文档链接]
+```
+
+#### 2.3 执行 Issue 创建
+
+使用 heredoc 格式执行 gh CLI：
+
+```bash
+gh issue create \
+  --title "[模块] 问题摘要" \
+  --label label1 --label label2 \
+  --body-file - <<'MSG'
+## 背景
+
+[从对话历史提炼的背景信息]
+
+## 现状/问题
+
+[代码变更分析结果和问题描述]
+
+## 期望行为
+
+[目标状态和验收标准]
+
+## 执行计划
+
+- [ ] 步骤 1
+- [ ] 步骤 2
+
+## 影响范围
+
+[受影响模块列表]
+MSG
+```
+
+**质量检查清单：**
+
+- [ ] 标题简洁明确（≤ 80 字符）
+- [ ] 背景信息完整
+- [ ] 问题/需求描述清晰
+- [ ] 执行步骤可操作
+- [ ] 影响范围已标注
+- [ ] 标签选择准确
+- [ ] 无敏感信息（.env、密钥等）
+
+#### 2.4 输出 Issue 信息
+
+成功创建后，解析 gh 输出获取 Issue 编号：
+
+```
+✅ Issue 创建成功
+
+Issue: #<编号>
+标题: <标题>
+链接: <GitHub URL>
+标签: <标签列表>
+```
+
+存储 Issue ID 供后续 commit 和 PR 使用。
+
+`--issue-only` 时在此终止。
+
+---
+
+### Step 3: Commit 流程
+
+#### 3.1 暂存变更
+
+```bash
+git add -A
+git diff --cached --stat
+```
+
+#### 3.2 生成提交
+
+分析 `git diff --cached` 内容，生成 commit message：
+
+```bash
+git commit -F - <<'EOF'
+<type>: <概要>
+
+变更说明：
+- <变更项1>
+- <变更项2>
+
+Refs: #<issue-id>
+EOF
+```
+
+type 类型：feat/fix/refactor/docs/chore/test
+
+#### 3.3 确认提交
+
+```bash
+git status
+git log -1 --oneline
+```
+
+---
+
+### Step 4: PR 创建
+
+#### 4.1 推送分支
+
+```bash
+git push -u origin HEAD
+```
+
+#### 4.2 分析变更
+
+```bash
+git log origin/master..HEAD --oneline
+git diff origin/master...HEAD --stat
+```
+
+#### 4.3 创建 PR
+
+```bash
+gh pr create --title '<type>: <概要>' --body-file - <<'EOF'
+## 变更说明
+
+- <变更项>
+
+## 测试
+
+- [ ] 本地测试通过
+
+Closes: #<issue-id>
+EOF
+```
+
+#### 4.4 提示评审
+
+创建 PR 成功后，提醒用户运行自动评审流程：
+
+```
+💡 提示：运行以下命令启动自动评审
+/dx:pr-review-loop --pr <PR_NUMBER>
+```
+
+---
+
+## 输出格式
+
+**成功：**
+
+```
+✅ 完成
+
+Issue: #<编号> <标题>
+Commit: <hash> <主题>
+PR: #<编号> → <URL>
+
+💡 下一步：运行以下命令启动自动评审
+/dx:pr-review-loop --pr <编号>
+```
+
+**部分完成：**
+
+```
+⚠️ 停止于 [阶段]
+
+已完成：<列表>
+阻塞：<原因>
+继续：/dx:git-commit-and-pr --issue <编号>
+```