leniu-dev 2.0.0

package/init.sh

@@ -0,0 +1,178 @@
+#!/usr/bin/env bash
+# =============================================================================
+# AI Engineering 初始化脚本
+# 用法: ./init.sh [--tool claude|codex|all] [--dir <目标目录>] [--force]
+# 远程: bash <(curl -fsSL https://raw.githubusercontent.com/xu-cell/ai-engineering-init/main/init.sh)
+# =============================================================================
+set -e
+
+# ── 颜色 ──────────────────────────────────────────────────────────────────────
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+# ── 常量 ──────────────────────────────────────────────────────────────────────
+REPO_URL="https://github.com/xu-cell/ai-engineering-init"
+BRANCH="main"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd || echo "${PWD}")"
+
+# ── Banner ────────────────────────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}${BLUE}┌─────────────────────────────────────────┐${NC}"
+echo -e "${BOLD}${BLUE}│      AI Engineering 初始化工具  v1.0      │${NC}"
+echo -e "${BOLD}${BLUE}└─────────────────────────────────────────┘${NC}"
+echo ""
+
+# ── 解析参数 ──────────────────────────────────────────────────────────────────
+TOOL=""
+TARGET_DIR="${PWD}"
+FORCE=false
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --tool|-t)   TOOL="$2";        shift 2 ;;
+    --dir|-d)    TARGET_DIR="$2";  shift 2 ;;
+    --force|-f)  FORCE=true;       shift   ;;
+    --help|-h)
+      echo -e "用法: ${BOLD}init.sh${NC} [选项]"
+      echo ""
+      echo "选项:"
+      echo "  --tool, -t <工具>   指定工具: claude | codex | all"
+      echo "  --dir,  -d <目录>   目标目录（默认：当前目录）"
+      echo "  --force,-f          强制覆盖已有文件"
+      echo "  --help, -h          显示此帮助"
+      echo ""
+      echo "示例:"
+      echo "  ./init.sh --tool claude"
+      echo "  ./init.sh --tool all --dir /path/to/project"
+      echo "  ./init.sh --tool codex --force"
+      echo ""
+      exit 0
+      ;;
+    *) echo -e "${RED}未知参数: $1${NC}"; exit 1 ;;
+  esac
+done
+
+# ── 交互菜单 ──────────────────────────────────────────────────────────────────
+if [ -z "$TOOL" ]; then
+  echo -e "${CYAN}请选择要初始化的 AI 工具：${NC}"
+  echo ""
+  echo -e "  ${BOLD}1${NC}) ${GREEN}Claude Code${NC}   — 初始化 .claude/ + CLAUDE.md"
+  echo -e "  ${BOLD}2${NC}) ${YELLOW}OpenAI Codex${NC}  — 初始化 .codex/ + AGENTS.md"
+  echo -e "  ${BOLD}3${NC}) ${BLUE}全部工具${NC}       — 同时初始化 Claude + Codex"
+  echo ""
+  read -rp "$(echo -e "${BOLD}请输入选项 [1-3]: ${NC}")" choice
+  case $choice in
+    1) TOOL="claude" ;;
+    2) TOOL="codex"  ;;
+    3) TOOL="all"    ;;
+    *) echo -e "${RED}无效选项，退出。${NC}"; exit 1 ;;
+  esac
+fi
+
+echo ""
+echo -e "  目标目录: ${BOLD}${TARGET_DIR}${NC}"
+echo -e "  初始化工具: ${BOLD}${TOOL}${NC}"
+echo ""
+
+# ── 确定文件来源 ──────────────────────────────────────────────────────────────
+if [ -f "${SCRIPT_DIR}/CLAUDE.md" ] || [ -d "${SCRIPT_DIR}/.claude" ]; then
+  SOURCE_DIR="${SCRIPT_DIR}"
+  echo -e "${GREEN}  ✓ 使用本地仓库文件${NC}"
+else
+  echo -e "${YELLOW}  → 正在从 GitHub 下载配置文件...${NC}"
+  TEMP_DIR=$(mktemp -d)
+  # shellcheck disable=SC2064
+  trap "rm -rf '${TEMP_DIR}'" EXIT
+
+  if command -v git &>/dev/null; then
+    git clone --depth=1 --branch "${BRANCH}" "${REPO_URL}" "${TEMP_DIR}/repo" \
+      2>&1 | grep -v "^Cloning" || true
+  else
+    echo -e "${RED}  ✗ 未找到 git，请先安装 git 或手动克隆仓库:${NC}"
+    echo -e "    git clone ${REPO_URL}"
+    exit 1
+  fi
+
+  SOURCE_DIR="${TEMP_DIR}/repo"
+  echo -e "${GREEN}  ✓ 下载完成${NC}"
+fi
+
+echo ""
+echo -e "${BOLD}正在复制文件...${NC}"
+echo ""
+
+# ── 复制函数 ──────────────────────────────────────────────────────────────────
+copy_item() {
+  local src="$1"
+  local dest="$2"
+  local label="$3"
+
+  if [ ! -e "${src}" ]; then
+    echo -e "${YELLOW}  ⚠  ${label} 在源目录中不存在，跳过${NC}"
+    return
+  fi
+  if [ -e "${dest}" ] && [ "$FORCE" = false ]; then
+    echo -e "${YELLOW}  ⚠  ${label} 已存在，跳过（--force 可强制覆盖）${NC}"
+    return
+  fi
+  if [ -d "${src}" ]; then
+    cp -r "${src}" "${dest}"
+  else
+    cp "${src}" "${dest}"
+  fi
+  echo -e "${GREEN}  ✓  ${label}${NC}"
+}
+
+# ── 初始化函数 ────────────────────────────────────────────────────────────────
+init_claude() {
+  echo -e "${CYAN}[Claude Code]${NC}"
+  copy_item "${SOURCE_DIR}/.claude"   "${TARGET_DIR}/.claude"   ".claude/ 目录"
+  copy_item "${SOURCE_DIR}/CLAUDE.md" "${TARGET_DIR}/CLAUDE.md" "CLAUDE.md"
+}
+
+init_codex() {
+  echo -e "${CYAN}[OpenAI Codex]${NC}"
+  copy_item "${SOURCE_DIR}/.codex"    "${TARGET_DIR}/.codex"    ".codex/ 目录"
+  copy_item "${SOURCE_DIR}/AGENTS.md" "${TARGET_DIR}/AGENTS.md" "AGENTS.md"
+}
+
+# ── 执行初始化 ────────────────────────────────────────────────────────────────
+case "$TOOL" in
+  claude) init_claude ;;
+  codex)  init_codex  ;;
+  all)    init_claude; echo ""; init_codex ;;
+  *)
+    echo -e "${RED}无效的工具类型: ${TOOL}${NC}"
+    echo -e "${YELLOW}有效选项: claude | codex | all${NC}"
+    exit 1
+    ;;
+esac
+
+# ── 完成提示 ──────────────────────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}${GREEN}✅ 初始化完成！${NC}"
+echo ""
+
+case "$TOOL" in
+  claude|all)
+    echo -e "${CYAN}Claude Code 使用：${NC}"
+    echo -e "  1. 按需修改 ${BOLD}CLAUDE.md${NC} 中的项目信息"
+    echo -e "  2. 在 Claude Code 中输入 ${BOLD}/start${NC} 快速了解项目"
+    echo -e "  3. 输入 ${BOLD}/dev${NC} 开始开发新功能"
+    echo ""
+    ;;
+esac
+
+case "$TOOL" in
+  codex|all)
+    echo -e "${CYAN}Codex 使用：${NC}"
+    echo -e "  1. 按需修改 ${BOLD}AGENTS.md${NC} 中的项目说明"
+    echo -e "  2. 在 Codex 中使用 .codex/skills/ 下的技能"
+    echo ""
+    ;;
+esac

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "leniu-dev",
+  "version": "2.0.0",
+  "description": "AI 工程化开发工具 — 一键安装 Skills、Commands、Hooks 到 Claude Code / Cursor / Codex",
+  "keywords": [
+    "claude-code",
+    "cursor",
+    "codex",
+    "ai-engineering",
+    "skills",
+    "leniu"
+  ],
+  "homepage": "https://github.com/xu-cell/ai-engineering-init",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xu-cell/ai-engineering-init.git"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build:skills": "node scripts/build-skills.js",
+    "check:skills": "node scripts/build-skills.js --check"
+  },
+  "bin": {
+    "leniu-dev": "./bin/index.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "scripts/",
+    ".claude/",
+    ".cursor/",
+    ".codex/",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "init.sh"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/scripts/build-skills.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+
+/**
+ * build-skills.js
+ *
+ * 从 src/skills/ 单一源生成 .claude/skills/, .codex/skills/, .cursor/skills/ 三个平台目录。
+ * 根据 src/platform-map.json 决定每个技能分发到哪些平台。
+ *
+ * 用法：
+ *   node scripts/build-skills.js          # 构建
+ *   node scripts/build-skills.js --check  # 仅检查一致性（CI 用）
+ */
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+const ROOT = path.resolve(__dirname, '..');
+const SRC_DIR = path.join(ROOT, 'src', 'skills');
+const PLATFORM_MAP_PATH = path.join(ROOT, 'src', 'platform-map.json');
+
+const PLATFORM_DIRS = {
+  claude: path.join(ROOT, '.claude', 'skills'),
+  codex: path.join(ROOT, '.codex', 'skills'),
+  cursor: path.join(ROOT, '.cursor', 'skills'),
+};
+
+const CHECK_MODE = process.argv.includes('--check');
+
+// ── 工具函数 ────────────────────────────────────────────
+
+function loadPlatformMap() {
+  const raw = fs.readFileSync(PLATFORM_MAP_PATH, 'utf-8');
+  return JSON.parse(raw);
+}
+
+function getSkillPlatforms(skillName, platformMap) {
+  if (platformMap.overrides[skillName]) {
+    return platformMap.overrides[skillName].platforms;
+  }
+  return platformMap.defaults.platforms;
+}
+
+function hashFile(filePath) {
+  const content = fs.readFileSync(filePath);
+  return crypto.createHash('md5').update(content).digest('hex').slice(0, 8);
+}
+
+function copyDirRecursive(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function dirContentsEqual(dir1, dir2) {
+  if (!fs.existsSync(dir1) || !fs.existsSync(dir2)) return false;
+
+  const entries1 = getAllFiles(dir1).map(f => path.relative(dir1, f)).sort();
+  const entries2 = getAllFiles(dir2).map(f => path.relative(dir2, f)).sort();
+
+  if (entries1.length !== entries2.length) return false;
+
+  for (let i = 0; i < entries1.length; i++) {
+    if (entries1[i] !== entries2[i]) return false;
+
+    const content1 = fs.readFileSync(path.join(dir1, entries1[i]));
+    const content2 = fs.readFileSync(path.join(dir2, entries2[i]));
+
+    if (!content1.equals(content2)) return false;
+  }
+  return true;
+}
+
+function getAllFiles(dir) {
+  const results = [];
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...getAllFiles(fullPath));
+    } else {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+function removeDirRecursive(dirPath) {
+  if (fs.existsSync(dirPath)) {
+    fs.rmSync(dirPath, { recursive: true, force: true });
+  }
+}
+
+// ── 主逻辑 ──────────────────────────────────────────────
+
+function build() {
+  const platformMap = loadPlatformMap();
+  const skillDirs = fs.readdirSync(SRC_DIR, { withFileTypes: true })
+    .filter(d => d.isDirectory())
+    .map(d => d.name)
+    .sort();
+
+  const stats = { claude: 0, codex: 0, cursor: 0 };
+  const errors = [];
+
+  // 构建每个技能到目标平台
+  for (const skillName of skillDirs) {
+    const platforms = getSkillPlatforms(skillName, platformMap);
+    const srcSkillDir = path.join(SRC_DIR, skillName);
+
+    for (const platform of platforms) {
+      const destSkillDir = path.join(PLATFORM_DIRS[platform], skillName);
+
+      if (CHECK_MODE) {
+        // 检查模式：对比内容是否一致
+        if (!dirContentsEqual(srcSkillDir, destSkillDir)) {
+          errors.push(`${platform}/skills/${skillName} 与 src/skills/${skillName} 不一致`);
+        }
+      } else {
+        // 构建模式：删除旧的，复制新的
+        removeDirRecursive(destSkillDir);
+        copyDirRecursive(srcSkillDir, destSkillDir);
+      }
+      stats[platform]++;
+    }
+  }
+
+  if (CHECK_MODE) {
+    // 反向检查：平台目录中是否存在 src 中没有的技能
+    for (const [platform, platformDir] of Object.entries(PLATFORM_DIRS)) {
+      if (!fs.existsSync(platformDir)) continue;
+      const platformSkills = fs.readdirSync(platformDir, { withFileTypes: true })
+        .filter(d => d.isDirectory())
+        .map(d => d.name);
+
+      for (const skill of platformSkills) {
+        const platforms = getSkillPlatforms(skill, platformMap);
+        if (!platforms.includes(platform)) {
+          errors.push(`${platform}/skills/${skill} 不应存在（platform-map 未配置）`);
+        }
+        if (!fs.existsSync(path.join(SRC_DIR, skill))) {
+          errors.push(`${platform}/skills/${skill} 在 src/skills/ 中不存在`);
+        }
+      }
+    }
+  }
+
+  return { stats, errors, skillCount: skillDirs.length };
+}
+
+// ── 执行 ────────────────────────────────────────────────
+
+console.log(CHECK_MODE ? '🔍 检查三平台一致性...' : '🔨 从 src/skills/ 构建三平台目录...');
+console.log();
+
+const { stats, errors, skillCount } = build();
+
+console.log(`📦 src/skills/ 源技能数: ${skillCount}`);
+console.log(`   → .claude/skills/: ${stats.claude} 个`);
+console.log(`   → .codex/skills/:  ${stats.codex} 个`);
+console.log(`   → .cursor/skills/: ${stats.cursor} 个`);
+console.log();
+
+if (errors.length > 0) {
+  console.error(`❌ 发现 ${errors.length} 个不一致:`);
+  errors.forEach(e => console.error(`   • ${e}`));
+  process.exit(1);
+} else {
+  console.log(CHECK_MODE ? '✅ 三平台与 src/skills/ 完全一致' : '✅ 构建完成');
+}

package/src/platform-map.json

@@ -0,0 +1,100 @@
+{
+  "description": "平台映射配置 - 定义每个技能分发到哪些平台",
+  "defaults": {
+    "platforms": ["claude", "codex", "cursor"]
+  },
+  "overrides": {
+    "codex-code-review": {
+      "platforms": ["claude"],
+      "note": "Codex 代码审查工作流，仅 Claude 平台使用"
+    },
+    "add-todo": {
+      "platforms": ["codex"],
+      "note": "快速添加待办，仅 Codex 平台 slash command"
+    },
+    "check": {
+      "platforms": ["codex"],
+      "note": "代码规范检查，仅 Codex 平台 slash command"
+    },
+    "crud": {
+      "platforms": ["codex"],
+      "note": "快速生成 CRUD，仅 Codex 平台 slash command"
+    },
+    "dev": {
+      "platforms": ["codex"],
+      "note": "开发新功能，仅 Codex 平台 slash command"
+    },
+    "init-docs": {
+      "platforms": ["codex"],
+      "note": "初始化业务文档，仅 Codex 平台 slash command"
+    },
+    "next": {
+      "platforms": ["codex"],
+      "note": "下一步建议，仅 Codex 平台 slash command"
+    },
+    "progress": {
+      "platforms": ["codex"],
+      "note": "项目进度梳理，仅 Codex 平台 slash command"
+    },
+    "start": {
+      "platforms": ["codex"],
+      "note": "项目快速了解，仅 Codex 平台 slash command"
+    },
+    "sync": {
+      "platforms": ["codex"],
+      "note": "项目代码状态同步，仅 Codex 平台 slash command"
+    },
+    "update-status": {
+      "platforms": ["codex"],
+      "note": "项目状态智能更新，仅 Codex 平台 slash command"
+    },
+    "leniu-java-code-style": {
+      "platforms": ["codex", "cursor"],
+      "note": "代码风格规范，Codex 和 Cursor 平台使用"
+    },
+    "skill-creator": {
+      "platforms": ["codex", "cursor"],
+      "note": "技能创建元技能，Claude 平台有内置 add-skill，仅分发到 Codex 和 Cursor"
+    },
+    "openspec-new-change": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 变更，Claude 平台转为 /opsx-new 命令"
+    },
+    "openspec-ff-change": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 快进，Claude 平台转为 /opsx-ff 命令"
+    },
+    "openspec-apply-change": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 实现，Claude 平台转为 /opsx-apply 命令"
+    },
+    "openspec-continue-change": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 继续，Claude 平台转为 /opsx-continue 命令"
+    },
+    "openspec-archive-change": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 归档，Claude 平台转为 /opsx-archive 命令"
+    },
+    "openspec-bulk-archive-change": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 批量归档，Claude 平台转为 /opsx-bulk-archive 命令"
+    },
+    "openspec-explore": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 探索，Claude 平台转为 /opsx-explore 命令"
+    },
+    "openspec-onboard": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 新手引导，Claude 平台转为 /opsx-onboard 命令"
+    },
+    "openspec-sync-specs": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 同步，Claude 平台转为 /opsx-sync 命令"
+    },
+    "openspec-verify-change": {
+      "platforms": ["codex", "cursor"],
+      "note": "OpenSpec 验证，Claude 平台转为 /opsx-verify 命令"
+    }
+  }
+}