@ranger1/dx 0.1.99 → 0.1.100

package/skills/autospec/SKILL.md

@@ -1,203 +0,0 @@
----
-name: autospec
-description: 设计文档到实施计划的全自动流水线。仅在用户显式调用时触发（如 /autospec），不通过关键词自动触发。将已讨论好的设计方案依次执行：写设计文档 → critic 审核修复 → 写实施计划 → critic 审核修复 → 自动开始 subagent-driven 执行 → git-pr-ship 交付 PR。
----
-
-# spec-to-plan：设计文档 → 审核 → 实施计划 → 审核 → 执行 → 交付 PR
-
-六步全自动流水线。用户在 brainstorming 阶段讨论好目标和方案后显式调用，后续全部自动完成，无需人工干预。
-
-## 输入
-
-`/spec-to-plan <topic-slug>`
-
-- `topic-slug`：文件命名用，如 `chat-instruction-admin`
-- 当前对话中必须已包含充分的设计上下文（目标、方案、数据模型、API、技术决策等）
-
-## 输出
-
-- 审核后的设计文档：`docs/superpowers/specs/YYYY-MM-DD-<topic-slug>-design.md`
-- 审核后的实施计划：`docs/superpowers/plans/YYYY-MM-DD-<topic-slug>.md`
-- 自动进入 subagent-driven 执行模式
-
-## 执行流程
-
-严格按顺序执行五步，中间不暂停、不询问用户。
-
----
-
-### Step 1：撰写设计文档
-
-从当前对话上下文中提取所有已确认的设计决策，写入设计文档。不臆造未讨论过的需求。
-
-**路径**：`docs/superpowers/specs/YYYY-MM-DD-<topic-slug>-design.md`
-
-**结构**（按需裁剪，无内容的章节不写）：
-
-```markdown
-# <功能名称>
-
-## 背景
-## 数据模型
-## API 设计
-## 缓存策略
-## 前端改造
-## 必要的集成步骤
-## Seed 数据
-## 模块结构
-## 不做的事
-```
-
-**自检**：写完后扫描——无 TBD/TODO、章节不矛盾、范围聚焦、无歧义。发现问题直接修。
-
----
-
-### Step 2：审核设计文档
-
-派出 `oh-my-claudecode:critic` subagent 审核。
-
-**Prompt**：
-
-```
-请以挑刺的角度审核这份设计文档，结合项目实际代码验证每一个设计决策。
-
-文档路径：<spec-path>
-
-审核要点：
-1. 数据模型：字段命名、ID 策略、@map/@@map 是否匹配项目惯例
-2. 模块结构：目录组织是否与现有模块一致
-3. API 设计：路由前缀、鉴权、分页 DTO 继承是否符合惯例
-4. 缓存：CacheService 方法签名是否正确
-5. 前端：store 组织、API 调用模式、组件层级是否匹配实际代码
-6. 集成步骤：是否遗漏 ErrorCode、Swagger、RBAC、api-contracts、菜单注册等
-7. Seed：入口注册、幂等策略是否正确
-
-每个发现给出具体文件路径和代码证据。
-分为：错误（必须修复）、遗漏（建议补充）、建议（可选优化）。
-```
-
-**处理结果**：读取 critic 返回，逐一修复设计文档。错误和遗漏全部修复，建议类酌情采纳。不改变已与用户确认的设计决策，只修事实性错误和惯例偏差。
-
----
-
-### Step 3：撰写实施计划
-
-基于审核后的设计文档写实施计划。
-
-**路径**：`docs/superpowers/plans/YYYY-MM-DD-<topic-slug>.md`
-
-**头部**（固定格式）：
-
-```markdown
-# <功能名称> Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development to implement this plan task-by-task.
-
-**Goal:** 一句话
-**Architecture:** 2-3 句
-**Tech Stack:** 关键技术
-**Spec:** <spec-path>
-
----
-```
-
-**Task 结构**：
-
-```markdown
-### Task N: <组件名>
-
-**Files:**
-- Create: `exact/path`
-- Modify: `exact/path`
-
-- [ ] **Step 1: 描述**
-（完整代码块）
-
-- [ ] **Step 2: 验证**
-Run: `命令`
-Expected: 预期
-
-- [ ] **Step 3: Commit**
-```
-
-**要求**：
-- 每步完整代码，禁止 TBD/TODO/"类似 Task N"
-- import 路径准确（基于 Step 2 审核已验证的惯例）
-- Task 按依赖顺序排列
-- 粒度 2-5 分钟每 Task
-
-**自检**：spec 每个章节有对应 Task、无占位符、类型和方法名前后一致。
-
----
-
-### Step 4：审核实施计划
-
-派出 `oh-my-claudecode:critic` subagent 审核。
-
-**Prompt**：
-
-```
-请以挑刺的角度审核这份实施计划，结合项目实际代码验证每一个代码片段。
-
-计划路径：<plan-path>
-设计文档：<spec-path>
-
-审核要点：
-1. Import 路径：每个 import 在项目中是否真实存在
-2. 路由冲突：参数路由 (:id) 和固定路由的顺序
-3. API 方法名：Zodios 等生成的方法命名是否匹配惯例
-4. 测试基建：E2E setup 是否匹配项目 fixtures
-5. Seed 入口：注册方式是否匹配项目结构
-6. Store 注册：前端 store 根注册方式是否正确
-7. 页面路由：文件路径能否自动注册路由
-8. DTO/Exception：构造函数签名、方法名是否匹配实际 API
-9. 遗漏：spec 中的需求是否全部覆盖
-
-每个发现给出具体文件路径和代码证据。
-分为：错误（必须修复）、遗漏（建议补充）、建议（可选优化）。
-```
-
-**处理结果**：读取 critic 返回，逐一修复实施计划。错误和遗漏全部修复。
-
----
-
-### Step 5：自动开始执行
-
-四步文档工作完成后，直接调用 `superpowers:subagent-driven-development` skill，传入实施计划路径，开始 Task-by-Task 的 subagent 执行。
-
-不询问用户选择执行方式，直接以 subagent-driven 模式启动。
-
-输出简短状态通知：
-
-```
-设计文档：<spec-path>（已审核修复）
-实施计划：<plan-path>（已审核修复，共 N 个 Task）
-正在以 subagent-driven 模式开始执行...
-```
-
----
-
-### Step 6：调用 git-pr-ship 交付 PR
-
-subagent-driven 执行全部 Task 完成并通过验证后，直接调用 `git-pr-ship` skill，进入 PR 交付流程。
-
-前置条件（执行阶段应已满足，若未满足先补齐）：
-- 全部 Task 已完成并勾选
-- 代码变更已提交到当前功能分支
-- lint、构建、相关测试已通过
-
-不询问用户，直接以 `git-pr-ship` 流程收口：整理提交、推送分支、创建 PR。
-
-输出简短状态通知：
-
-```
-实施已全部完成并验证通过。
-正在调用 git-pr-ship 交付 PR...
-```
-
-## 注意事项
-
-- 设计文档内容完全来自对话上下文，不臆造未讨论过的需求
-- critic 修复只改事实错误和惯例偏差，不改变用户已确认的设计决策
-- 如果 critic 发现的问题数量极多（>10 个错误级），在修复后可考虑再跑一轮 critic 确认
-- 整个流程对用户透明——每步开始时输出一行状态（如"正在撰写设计文档..."），但不等待确认

package/skills/doctor/scripts/doctor.sh

@@ -1,430 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-MAX_ROUNDS=3
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --max-rounds)
-      MAX_ROUNDS="${2:-3}"
-      shift 2
-      ;;
-    *)
-      shift
-      ;;
-  esac
-done
-
-if ! [[ "$MAX_ROUNDS" =~ ^[0-9]+$ ]] || [[ "$MAX_ROUNDS" -lt 1 ]]; then
-  echo "[doctor] --max-rounds 必须是正整数" >&2
-  exit 2
-fi
-
-CACHE_ROOT="${PWD}/.cache/doctor"
-mkdir -p "$CACHE_ROOT"
-CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
-
-LAST_CHECK_DIR=""
-DX_FORCE_OK=0
-DX_FORCE_MSG=""
-
-run_silent() {
-  "$@" >/dev/null 2>&1
-}
-
-detect_pkg_manager() {
-  if command -v brew >/dev/null 2>&1; then echo "brew"; return; fi
-  if command -v apt-get >/dev/null 2>&1; then echo "apt"; return; fi
-  if command -v dnf >/dev/null 2>&1; then echo "dnf"; return; fi
-  if command -v yum >/dev/null 2>&1; then echo "yum"; return; fi
-  if command -v pacman >/dev/null 2>&1; then echo "pacman"; return; fi
-  echo "none"
-}
-
-install_python3() {
-  local pm
-  pm="$(detect_pkg_manager)"
-  case "$pm" in
-    brew)
-      brew install python
-      ;;
-    apt)
-      sudo apt-get update && sudo apt-get install -y python3 python3-venv python3-pip
-      ;;
-    dnf)
-      sudo dnf install -y python3 python3-pip
-      ;;
-    yum)
-      sudo yum install -y python3 python3-pip
-      ;;
-    pacman)
-      sudo pacman -Sy --noconfirm python
-      ;;
-    *)
-      echo "未检测到可用包管理器，无法安装 python3" >&2
-      return 1
-      ;;
-  esac
-}
-
-ensure_python_alias() {
-  local py3 target_dir target py_major
-  py3="$(command -v python3 || true)"
-  if [[ -z "$py3" ]]; then
-    echo "python3 不存在，无法创建 python 别名" >&2
-    return 1
-  fi
-
-  if command -v python >/dev/null 2>&1; then
-    py_major="$(python -c 'import sys; print(sys.version_info[0])' 2>/dev/null || true)"
-    if [[ "$py_major" == "3" ]]; then
-      return 0
-    fi
-  fi
-
-  # 避免污染系统/工具链目录，统一落到用户态目录。
-  target_dir="$HOME/.local/bin"
-  mkdir -p "$target_dir"
-  target="$target_dir/python"
-  ln -sf "$py3" "$target"
-
-  if [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then
-    export PATH="$HOME/.local/bin:$PATH"
-  fi
-
-  py_major="$(python -c 'import sys; print(sys.version_info[0])' 2>/dev/null || true)"
-  [[ "$py_major" == "3" ]]
-}
-
-install_rg() {
-  local pm
-  pm="$(detect_pkg_manager)"
-  case "$pm" in
-    brew)
-      brew install ripgrep
-      ;;
-    apt)
-      sudo apt-get update && sudo apt-get install -y ripgrep
-      ;;
-    dnf)
-      sudo dnf install -y ripgrep
-      ;;
-    yum)
-      sudo yum install -y ripgrep
-      ;;
-    pacman)
-      sudo pacman -Sy --noconfirm ripgrep
-      ;;
-    *)
-      echo "未检测到可用包管理器，无法安装 rg" >&2
-      return 1
-      ;;
-  esac
-}
-
-install_pnpm() {
-  if command -v pnpm >/dev/null 2>&1; then
-    return 0
-  fi
-
-  if command -v npm >/dev/null 2>&1; then
-    npm install -g pnpm@latest
-  elif command -v brew >/dev/null 2>&1; then
-    brew install pnpm
-  else
-    echo "缺少 npm/brew，无法安装 pnpm" >&2
-    return 1
-  fi
-}
-
-persist_user_local_bin_path() {
-  local line='export PATH="$HOME/.local/bin:$PATH"'
-  local rc
-  for rc in "$HOME/.zshrc" "$HOME/.bashrc" "$HOME/.profile"; do
-    if [[ -f "$rc" ]]; then
-      if ! grep -F "$line" "$rc" >/dev/null 2>&1; then
-        printf '\n%s\n' "$line" >>"$rc"
-      fi
-    fi
-  done
-}
-
-expose_dx_globally() {
-  local source_dx="$1"
-  local target_dir target_path
-
-  if [[ ! -x "$source_dx" ]]; then
-    echo "dx 源可执行文件不存在：$source_dx" >&2
-    return 1
-  fi
-
-  target_dir=""
-  if [[ -w "/usr/local/bin" ]]; then
-    target_dir="/usr/local/bin"
-  elif [[ -w "/opt/homebrew/bin" ]]; then
-    target_dir="/opt/homebrew/bin"
-  else
-    target_dir="$HOME/.local/bin"
-    mkdir -p "$target_dir"
-    if [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then
-      export PATH="$HOME/.local/bin:$PATH"
-    fi
-    persist_user_local_bin_path
-  fi
-
-  target_path="$target_dir/dx"
-  ln -sf "$source_dx" "$target_path"
-  command -v dx >/dev/null 2>&1
-}
-
-ensure_agent_browser() {
-  # 优先使用用户态 pnpm，减少全局权限问题。
-  if command -v pnpm >/dev/null 2>&1; then
-    pnpm add -g agent-browser@latest
-  elif command -v npm >/dev/null 2>&1; then
-    npm install -g agent-browser@latest
-  elif command -v brew >/dev/null 2>&1; then
-    brew install agent-browser
-  else
-    echo "缺少 npm/pnpm/brew，无法安装 agent-browser" >&2
-    return 1
-  fi
-
-  if ! command -v agent-browser >/dev/null 2>&1; then
-    local pnpm_bin npm_prefix
-    pnpm_bin="$(pnpm bin -g 2>/dev/null || true)"
-    npm_prefix="$(npm prefix -g 2>/dev/null || true)"
-    echo "agent-browser 安装后仍不可用，请检查 PATH（pnpm: ${pnpm_bin:-N/A}，npm: ${npm_prefix:-N/A}/bin）" >&2
-    return 1
-  fi
-
-  if ! run_silent agent-browser install; then
-    run_silent agent-browser install --with-deps || {
-      echo "agent-browser Chromium 安装失败" >&2
-      return 1
-    }
-  fi
-}
-
-force_dx() {
-  local pnpm_bin dx_installed dx_cmd
-  if ! install_pnpm; then
-    DX_FORCE_OK=0
-    DX_FORCE_MSG="pnpm 不可用，无法执行 dx 强制初始化"
-    return 1
-  fi
-
-  if pnpm add -g @ranger1/dx@latest >/dev/null 2>&1; then
-    pnpm_bin="$(pnpm bin -g 2>/dev/null || true)"
-    dx_installed=""
-    if [[ -n "$pnpm_bin" && -x "$pnpm_bin/dx" ]]; then
-      dx_installed="$pnpm_bin/dx"
-    elif command -v dx >/dev/null 2>&1; then
-      dx_installed="$(command -v dx)"
-    fi
-
-    if [[ -z "$dx_installed" ]]; then
-      DX_FORCE_OK=0
-      DX_FORCE_MSG="dx 安装后未找到可执行文件（pnpm bin: ${pnpm_bin:-N/A}）"
-      return 1
-    fi
-
-    if ! expose_dx_globally "$dx_installed"; then
-      DX_FORCE_OK=0
-      DX_FORCE_MSG="dx 已安装但未能暴露为全局命令（pnpm bin: ${pnpm_bin:-N/A}）"
-      return 1
-    fi
-
-    dx_cmd="$(command -v dx || true)"
-    if [[ -n "$dx_cmd" ]] && dx initial >/dev/null 2>&1; then
-      DX_FORCE_OK=1
-      DX_FORCE_MSG="已安装并暴露全局 dx（${dx_cmd}），并执行 dx initial"
-      return 0
-    fi
-
-    DX_FORCE_OK=0
-    DX_FORCE_MSG="dx 已暴露为全局命令但 dx initial 执行失败（dx: ${dx_cmd:-N/A}）"
-    return 1
-  fi
-
-  DX_FORCE_OK=0
-  DX_FORCE_MSG="强制命令执行失败：pnpm add -g @ranger1/dx@latest"
-  return 1
-}
-
-write_check_file() {
-  local key="$1" ok="$2" ver="$3" msg="$4" file="$5"
-  printf '%s|%s|%s|%s\n' "$key" "$ok" "$ver" "$msg" >"$file"
-}
-
-read_field() {
-  local key="$1" field="$2"
-  local f="$LAST_CHECK_DIR/${key}.res"
-  if [[ ! -f "$f" ]]; then
-    echo ""
-    return 0
-  fi
-  awk -F'|' -v idx="$field" '{print $idx}' "$f"
-}
-
-check_ok() {
-  local key="$1"
-  [[ "$(read_field "$key" 2)" == "1" ]]
-}
-
-run_parallel_checks() {
-  local round="$1"
-  local dir="$CACHE_ROOT/round-${round}"
-  mkdir -p "$dir"
-
-  (
-    if command -v python3 >/dev/null 2>&1; then
-      write_check_file "python3" "1" "$(python3 --version 2>&1 | head -n1)" "ok" "$dir/python3.res"
-    else
-      write_check_file "python3" "0" "" "python3 未安装" "$dir/python3.res"
-    fi
-  ) &
-
-  (
-    if command -v python >/dev/null 2>&1; then
-      local py_ver py_major
-      py_ver="$(python --version 2>&1 | head -n1)"
-      py_major="$(python -c 'import sys; print(sys.version_info[0])' 2>/dev/null || true)"
-      if [[ "$py_major" == "3" ]]; then
-        write_check_file "python_alias" "1" "$py_ver" "ok" "$dir/python_alias.res"
-      else
-        write_check_file "python_alias" "0" "$py_ver" "python 存在但不是 Python 3" "$dir/python_alias.res"
-      fi
-    else
-      write_check_file "python_alias" "0" "" "python 别名不可用" "$dir/python_alias.res"
-    fi
-  ) &
-
-  (
-    if command -v pnpm >/dev/null 2>&1; then
-      write_check_file "pnpm" "1" "pnpm $(pnpm --version 2>/dev/null | head -n1)" "ok" "$dir/pnpm.res"
-    else
-      write_check_file "pnpm" "0" "" "pnpm 未安装" "$dir/pnpm.res"
-    fi
-  ) &
-
-  (
-    if command -v dx >/dev/null 2>&1; then
-      local v
-      v="$(dx --version 2>/dev/null | head -n1 || true)"
-      if [[ -z "$v" ]]; then
-        v="$(dx -v 2>/dev/null | head -n1 || true)"
-      fi
-      write_check_file "dx" "1" "${v:-dx (版本未知)}" "ok" "$dir/dx.res"
-    else
-      write_check_file "dx" "0" "" "dx 未安装" "$dir/dx.res"
-    fi
-  ) &
-
-  (
-    if command -v agent-browser >/dev/null 2>&1; then
-      write_check_file "agent_browser" "1" "$(agent-browser --version 2>/dev/null | head -n1)" "ok" "$dir/agent_browser.res"
-    else
-      write_check_file "agent_browser" "0" "" "agent-browser 未安装" "$dir/agent_browser.res"
-    fi
-  ) &
-
-  (
-    if command -v rg >/dev/null 2>&1; then
-      write_check_file "rg" "1" "$(rg --version 2>/dev/null | head -n1)" "ok" "$dir/rg.res"
-    else
-      write_check_file "rg" "0" "" "rg 未安装" "$dir/rg.res"
-    fi
-  ) &
-
-  wait
-  LAST_CHECK_DIR="$dir"
-}
-
-all_good() {
-  local keys="python3 python_alias pnpm dx agent_browser rg"
-  local k
-  for k in $keys; do
-    if ! check_ok "$k"; then
-      return 1
-    fi
-  done
-  [[ "$DX_FORCE_OK" == "1" ]]
-}
-
-print_report() {
-  local round="$1"
-  echo
-  echo "===== Doctor 报告（第 ${round} 轮）====="
-  printf '%-14s | %-4s | %-40s | %s\n' "检查项" "状态" "版本" "说明"
-  printf '%-14s-+-%-4s-+-%-40s-+-%s\n' "--------------" "----" "----------------------------------------" "------------------------------"
-
-  local keys="python3 python_alias pnpm dx agent_browser rg"
-  local k ok txt ver msg
-  for k in $keys; do
-    ok="$(read_field "$k" 2)"
-    txt="FAIL"
-    [[ "$ok" == "1" ]] && txt="PASS"
-    ver="$(read_field "$k" 3)"
-    msg="$(read_field "$k" 4)"
-    printf '%-14s | %-4s | %-40s | %s\n' "$k" "$txt" "$ver" "$msg"
-  done
-
-  if [[ "$DX_FORCE_OK" == "1" ]]; then
-    printf '%-14s | %-4s | %-40s | %s\n' "dx_force" "PASS" "@ranger1/dx@latest" "$DX_FORCE_MSG"
-  else
-    printf '%-14s | %-4s | %-40s | %s\n' "dx_force" "FAIL" "@ranger1/dx@latest" "$DX_FORCE_MSG"
-  fi
-
-  if command -v node >/dev/null 2>&1; then
-    echo "node: $(node -v 2>/dev/null | head -n1)"
-  fi
-  if command -v npm >/dev/null 2>&1; then
-    echo "npm: $(npm -v 2>/dev/null | head -n1)"
-  fi
-}
-
-for round in $(seq 1 "$MAX_ROUNDS"); do
-  echo "[doctor] 第 ${round}/${MAX_ROUNDS} 轮：并行检测"
-  run_parallel_checks "$round"
-
-  echo "[doctor] 第 ${round}/${MAX_ROUNDS} 轮：修复阶段"
-
-  if ! check_ok "python3"; then
-    echo "[doctor] 安装 python3"
-    install_python3 || true
-  fi
-
-  if ! check_ok "python_alias"; then
-    echo "[doctor] 建立 python -> python3 调用能力"
-    ensure_python_alias || true
-  fi
-
-  if ! check_ok "rg"; then
-    echo "[doctor] 安装 rg"
-    install_rg || true
-  fi
-
-  if ! check_ok "agent_browser"; then
-    echo "[doctor] 安装/升级 agent-browser 并安装 Chromium"
-    ensure_agent_browser || true
-  else
-    echo "[doctor] agent-browser 已存在，执行升级与 Chromium 安装"
-    ensure_agent_browser || true
-  fi
-
-  echo "[doctor] 强制执行 dx 安装与初始化"
-  force_dx || true
-
-  echo "[doctor] 第 ${round}/${MAX_ROUNDS} 轮：复检"
-  run_parallel_checks "${round}-post"
-  print_report "$round"
-
-  if all_good; then
-    echo "[doctor] 全部检查通过"
-    exit 0
-  fi
-
-done
-
-echo "[doctor] 达到最大轮次 ${MAX_ROUNDS}，仍有未通过项"
-exit 1