@ranger1/dx 0.1.15 → 0.1.17

package/@opencode/agents/pr-review-aggregate.md

@@ -0,0 +1,118 @@
+---
+description: aggregate PR reviews + create fix file
+mode: subagent
+model: openai/gpt-5.1-codex-mini
+temperature: 0.1
+tools:
+  write: true
+  edit: false
+  bash: true
+---
+
+# PR Review Aggregator
+
+## 输入（两种模式）
+
+### 模式 A：评审聚合 + 生成 fixFile + 发布评审评论
+
+- `PR #<number>`
+- `round: <number>`
+- `runId: <string>`
+- `contextFile: <path>`
+- `reviewFile: <path>`（三行，分别对应 CDX/CLD/GMN）
+
+### 模式 B：发布修复评论（基于 fixReportFile）
+
+- `PR #<number>`
+- `round: <number>`
+- `runId: <string>`
+- `fixReportFile: <path>`
+
+示例：
+
+```text
+PR #123
+round: 1
+runId: abcdef123456
+contextFile: ~/.opencode/cache/pr-context-pr123-r1-abcdef123456.md
+reviewFile: ~/.opencode/cache/review-CDX-pr123-r1-abcdef123456.md
+reviewFile: ~/.opencode/cache/review-CLD-pr123-r1-abcdef123456.md
+reviewFile: ~/.opencode/cache/review-GMN-pr123-r1-abcdef123456.md
+```
+
+## 你要做的事（按模式执行）
+
+模式 A：
+
+1. Read `contextFile` 与全部 `reviewFile`
+2. 计算 needsFix（P0/P1/P2 任意 > 0）
+3. 发布评审评论到 GitHub（gh pr comment），必须带 marker，评论正文必须内联包含：
+   - Summary（P0/P1/P2/P3 统计）
+   - P0/P1/P2 问题列表（至少 id/title/file:line/suggestion）
+   - 三个 reviewer 的 reviewFile 原文（建议放到 <details>）
+4. 若 needsFix：生成 `fixFile`（Markdown）并返回；否则发布“完成”评论并返回 stop
+
+模式 B：
+
+1. Read `fixReportFile`
+2. 发布修复评论到 GitHub（gh pr comment），必须带 marker，评论正文必须内联 fixReportFile 内容
+3. 输出 `{"ok":true}`
+
+## 输出（强制）
+
+模式 A：只输出一个 JSON 对象（很小）：
+
+```json
+{
+  "stop": false,
+  "fixFile": "~/.opencode/cache/fix-pr123-r1-abcdef123456.md"
+}
+```
+
+字段：
+
+- `stop`: boolean
+- `fixFile`: string（仅 stop=false 时必须提供）
+
+模式 B：只输出：
+
+```json
+{ "ok": true }
+```
+
+## 规则
+
+- 不要输出 ReviewResult JSON
+- 不要校验/要求 reviewer 的 JSON
+- 不要生成/输出任何时间字段
+- `fixFile` 只包含 P0/P1/P2
+- `id` 必须使用 reviewer 给出的 findingId（例如 `CDX-001`），不要再改前缀
+
+## 评论要求
+
+- 每条评论必须包含：`<!-- pr-review-loop-marker -->`
+- body 必须是最终字符串（用 `--body-file` 读取文件），不要依赖 heredoc 变量展开
+- 禁止在评论里出现本地缓存文件路径（例如 `~/.opencode/cache/...`）
+
+## fixFile 输出路径与格式
+
+- 路径：`~/.opencode/cache/fix-pr<PR_NUMBER>-r<ROUND>-<RUN_ID>.md`
+- 格式：
+
+```md
+# Fix File
+
+PR: <PR_NUMBER>
+Round: <ROUND>
+
+## IssuesToFix
+
+- id: CDX-001
+  priority: P1
+  category: quality
+  file: <path>
+  line: <number|null>
+  title: <short>
+  description: <text>
+  suggestion: <text>
+```

package/@opencode/commands/doctor.md

@@ -0,0 +1,235 @@
+---
+allowed-tools: [Bash, AskUserQuestion, Edit, Read, Write]
+description: '环境诊断'
+agent: sisyphus
+---
+
+---
+
+## Step 0: 强制安装 dx CLI
+
+**无论当前是否安装，必须执行：**
+
+```bash
+pnpm i -g @ranger1/dx
+```
+
+---
+
+## Step 1: 并行检测
+
+**同时执行以下 3 个 Bash 调用（真正并行）：**
+
+```bash
+# 批次 1: CLI 版本检测
+echo "=== CLI_VERSIONS ===";
+echo "opencode:" && (which opencode && opencode --version 2>/dev/null || echo "NOT_FOUND");
+echo "dx:" && (which dx && dx --version 2>/dev/null || echo "NOT_FOUND");
+echo "agent-browser:" && (which agent-browser && agent-browser --version 2>/dev/null || echo "NOT_FOUND");
+```
+
+```bash
+# 批次 2: 项目文件检测
+echo "=== PROJECT_FILES ===";
+echo "AGENTS.md:" && (test -f AGENTS.md && echo "FOUND" || echo "NOT_FOUND");
+echo "opencode.json:" && (test -f opencode.json && echo "CONFIGURED" || echo "NOT_FOUND");
+echo "instructions:" && (if [ -f opencode.json ]; then grep -q '"AGENTS.md"' opencode.json && grep -q '"ruler/' opencode.json && echo "VALID" || echo "INVALID"; else echo "SKIP"; fi);
+```
+
+```bash
+# 批次 3: OpenCode 插件检测
+# 注意:插件名可能带版本号(如 @1.3.0),使用模糊匹配
+echo "=== OPENCODE_PLUGINS ===";
+echo "oh-my-opencode:" && (grep -q 'oh-my-opencode' ~/.config/opencode/opencode.json 2>/dev/null && echo "INSTALLED" || echo "NOT_INSTALLED");
+echo "opencode-openai-codex-auth:" && (grep -q 'opencode-openai-codex-auth' ~/.config/opencode/opencode.json 2>/dev/null && echo "INSTALLED" || echo "NOT_INSTALLED");
+```
+
+```bash
+# 批次 4: oh-my-opencode.json 配置检测
+echo "=== OMO_CONFIG ===";
+echo "sisyphus_agent:" && (grep -q '"sisyphus_agent"' ~/.config/opencode/oh-my-opencode.json 2>/dev/null && echo "CONFIGURED" || echo "NOT_CONFIGURED");
+echo "categories.quick:" && (grep -q '"quick"' ~/.config/opencode/oh-my-opencode.json 2>/dev/null && echo "CONFIGURED" || echo "NOT_CONFIGURED");
+echo "categories.middle:" && (grep -q '"middle"' ~/.config/opencode/oh-my-opencode.json 2>/dev/null && echo "CONFIGURED" || echo "NOT_CONFIGURED");
+```
+
+---
+
+## Step 2: 输出报告
+
+汇总结果，输出表格：
+
+```
+工具                           | 状态     | 版本
+opencode                       | <状态>   | <版本>
+dx                             | <状态>   | <版本>
+AGENTS.md                      | <状态>   | -
+opencode.json                  | <状态>   | -
+配置指令                       | <状态>   | -
+oh-my-opencode                 | <状态>   | -
+opencode-openai-codex-auth     | <状态>   | -
+agent-browser                  | <状态>   | <版本>
+sisyphus_agent 配置            | <状态>   | -
+categories.quick 配置          | <状态>   | -
+categories.middle 配置         | <状态>   | -
+```
+
+---
+
+## Step 3: 统一处理缺失项
+
+**如检测到任何缺失项，统一询问一次：**
+
+`AskUserQuestion`: 检测到以下缺失项，是否自动安装/配置所有？
+
+确认后按顺序处理：
+
+### 3.1 opencode CLI 未安装
+
+执行安装：
+
+```bash
+# brew 优先
+brew install opencode || npm install -g opencode
+```
+
+### 3.2 AGENTS.md 未找到
+
+提示用户：
+
+- AGENTS.md 文件不存在，OpenCode 需要此文件作为项目指令入口
+- 建议创建或检查文件路径
+
+### 3.3 opencode.json 未配置
+
+使用 Write 工具创建配置文件：
+
+文件路径：`<项目根目录>/opencode.json`
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "instructions": ["AGENTS.md", "ruler/**/*.md"]
+}
+```
+
+### 3.4 配置指令无效
+
+使用 Edit 工具修复 opencode.json，确保包含：
+
+- `"AGENTS.md"`: 主配置文件
+- `"ruler/**/*.md"`: 自动加载 ruler 目录下所有 .md 文件（因 OpenCode 不支持 @ 引用）
+
+### 3.5 OpenCode 插件安装
+
+**OpenCode 插件通过编辑 `~/.config/opencode/opencode.json` 的 `plugin` 数组安装。**
+
+1. 先读取现有配置：
+
+```bash
+cat ~/.config/opencode/opencode.json
+```
+
+2. 使用 Edit 工具在 `plugin` 数组中添加缺失的插件：
+   - `oh-my-opencode`
+   - `opencode-openai-codex-auth`
+
+示例 plugin 配置：
+
+```json
+"plugin": [
+  "oh-my-opencode",
+  "opencode-openai-codex-auth"
+]
+```
+
+3. 验证安装：
+
+```bash
+grep -E 'oh-my-opencode|opencode-openai-codex-auth' ~/.config/opencode/opencode.json
+```
+
+### 3.6 agent-browser 未安装
+
+执行安装：
+
+```bash
+npm install -g agent-browser && agent-browser install
+```
+
+### 3.7 oh-my-opencode.json 配置缺失
+
+**检查并修复 `~/.config/opencode/oh-my-opencode.json` 配置。**
+
+1. 先读取现有配置：
+
+```bash
+cat ~/.config/opencode/oh-my-opencode.json
+```
+
+2. 使用 Edit 工具添加缺失的配置节点：
+
+#### 3.7.1 sisyphus_agent 配置缺失
+
+如果根节点缺少 `sisyphus_agent`，使用 Edit 工具添加：
+
+```json
+{
+  "sisyphus_agent": {
+    "disabled": false,
+    "default_builder_enabled": true,
+    "planner_enabled": true,
+    "replace_plan": false
+  }
+}
+```
+
+注意：这是根节点配置，应添加到 JSON 的第一层级。
+
+#### 3.7.2 categories.quick 或 categories.middle 缺失
+
+如果 `categories` 节点缺少 `quick` 或 `middle`，使用 Edit 工具添加：
+
+```json
+{
+  "categories": {
+    "quick": {
+      "model": "github-copilot/claude-haiku-4.5"
+    },
+    "middle": {
+      "model": "github-copilot/claude-sonnet-4.5"
+    }
+  }
+}
+```
+
+3. 验证配置：
+
+```bash
+# 检查 sisyphus_agent
+grep -q '"sisyphus_agent"' ~/.config/opencode/oh-my-opencode.json && echo "✅ sisyphus_agent 已配置" || echo "❌ sisyphus_agent 缺失"
+
+# 检查 categories.quick
+grep -q '"quick"' ~/.config/opencode/oh-my-opencode.json && echo "✅ quick 已配置" || echo "❌ quick 缺失"
+
+# 检查 categories.middle
+grep -q '"middle"' ~/.config/opencode/oh-my-opencode.json && echo "✅ middle 已配置" || echo "❌ middle 缺失"
+```
+
+---
+
+## 输出格式
+
+**全部就绪：**
+
+```
+✅ 所有依赖已就绪
+```
+
+**有缺失：**
+
+```
+⚠️ <工具> 未安装/未配置
+```
+
+**修复完成后：**
+输出最终状态表格，确认所有项目均为 ✅

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 <编号>
+```