leniu-dev 2.0.0

package/.codex/skills/collaborating-with-gemini/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: collaborating-with-gemini
+description: |
+  与 Google Gemini CLI 协同开发。将编码任务委托给 Gemini 进行前端原型、UI设计和代码审查。
+
+  触发场景：
+  - 需要前端/UI/样式原型设计
+  - 需要 CSS/React/Vue 组件设计
+  - 需要代码审查和 Bug 分析
+  - 用户明确要求使用 Gemini 协作
+  - 复杂前端逻辑的原型设计
+
+  触发词：Gemini、协作、多模型、前端原型、UI设计、CSS、样式、gemini协同
+
+  前置要求：
+  - 已安装 Gemini CLI (npm install -g @google/gemini-cli)
+  - 已配置 Google API Key
+
+  注意：Gemini 对后端逻辑理解有缺陷，后端任务优先使用 Codex。
+---
+
+# 与 Gemini CLI 协同开发
+
+> 通过 Python 桥接脚本调用 Gemini CLI，获取前端原型和 UI 设计建议。
+
+## 快速开始
+
+```bash
+# 相对路径（推荐，在项目根目录执行）
+python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py --cd . --PROMPT "Your task"
+```
+
+**输出**: JSON 格式，包含 `success`、`SESSION_ID`、`agent_messages` 和可选的 `error`。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `--PROMPT` | str | ✅ | - | 发送给 Gemini 的任务指令（使用英语） |
+| `--cd` | Path | ✅ | - | 工作目录根路径 |
+| `--sandbox` | bool | ❌ | `False` | 是否启用沙箱模式 |
+| `--SESSION_ID` | str | ❌ | `""` | 会话 ID（继续之前的对话） |
+| `--return-all-messages` | bool | ❌ | `False` | 返回完整推理信息 |
+| `--model` | str | ❌ | `None` | 指定模型（仅用户明确要求时使用） |
+
+## 使用模式
+
+### 1. 基础调用
+
+```bash
+python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
+  --cd . \
+  --PROMPT "Design a responsive card component for product display"
+```
+
+### 2. 多轮会话
+
+**始终保存 SESSION_ID** 用于后续对话：
+
+```bash
+# 第一轮：设计 UI
+python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
+  --cd "/project" \
+  --PROMPT "Design a mobile-first login page with form validation"
+
+# 后续轮次：使用 SESSION_ID 继续
+python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
+  --cd "/project" \
+  --SESSION_ID "uuid-from-previous-response" \
+  --PROMPT "Add dark mode support to the login page design"
+```
+
+### 3. 获取 Unified Diff 补丁
+
+```bash
+python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
+  --cd "/project" \
+  --PROMPT "Generate a unified diff to improve the CSS layout of Home.vue. OUTPUT: Unified Diff Patch ONLY."
+```
+
+### 4. 调试模式（返回完整信息）
+
+```bash
+python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
+  --cd "/project" \
+  --PROMPT "Debug this styling issue: elements overflow on mobile" \
+  --return-all-messages
+```
+
+## 返回值结构
+
+**成功时：**
+```json
+{
+  "success": true,
+  "SESSION_ID": "550e8400-e29b-41d4-a716-446655440000",
+  "agent_messages": "模型回复内容..."
+}
+```
+
+**失败时：**
+```json
+{
+  "success": false,
+  "error": "错误信息描述"
+}
+```
+
+## 协作工作流
+
+### 推荐场景
+
+| 场景 | 说明 |
+|------|------|
+| **前端/UI/UX** | Gemini 擅长 CSS、样式和视觉设计 |
+| **组件设计** | React/Vue 组件的原型设计 |
+| **响应式布局** | 移动端适配和布局优化 |
+| **样式审查** | CSS 代码质量和最佳实践 |
+
+### 重要约束
+
+1. **上下文限制**: Gemini 上下文 < 32k tokens，避免过长输入
+2. **英语交互**: 与 Gemini 交互时使用英语，获得更好效果
+3. **中文输出强制**: Gemini 倾向于输出英文，必须在每次 PROMPT 末尾追加以下约束：
+   ```
+   IMPORTANT LANGUAGE RULES:
+   - All SQL COMMENT values MUST be in Chinese (e.g., COMMENT '用户名' NOT COMMENT 'username')
+   - All Java/code comments (Javadoc, inline //, block /* */) MUST be in Chinese
+   - All field descriptions, table descriptions MUST be in Chinese
+   - Variable names and class names remain in English (camelCase/PascalCase)
+   ```
+4. **Diff 输出**: 在 PROMPT 中明确要求 `OUTPUT: Unified Diff Patch ONLY`
+5. **后端逻辑**: Gemini 对后端逻辑理解有缺陷，后端任务优先使用 Codex
+6. **重构代码**: 将 Gemini 的输出视为"脏原型"，由 Claude 重构为生产代码（**特别检查注释和 COMMENT 是否为中文，不是则修正**）
+7. **后台运行**: 对于长时间任务，使用 `Run in the background`
+
+## 与本项目的集成
+
+### 典型用例：后端代码审查
+
+```bash
+# 审查后端 Controller 代码
+python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
+  --cd . \
+  --PROMPT "Review the RESTful API design in ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/. Focus on path conventions (/list, /{id}) and proper use of @SaCheckPermission."
+```
+
+### 典型用例：Service 层代码审查
+
+```bash
+# 审查 Service 实现
+python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
+  --cd "/project" \
+  --PROMPT "Review the XxxServiceImpl.java for buildQueryWrapper implementation, MapstructUtils usage, and adherence to three-layer architecture (no DAO layer). OUTPUT: Review comments."
+```
+
+### 典型用例：Entity 设计审查
+
+```bash
+# 审查 Entity 设计
+python .claude/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
+  --cd "/project" \
+  --PROMPT "Review the Entity classes in ruoyi-modules/ruoyi-demo/src/main/java/org/dromara/demo/domain/ for proper TenantEntity inheritance, @TableLogic usage, and field naming conventions."
+```
+
+## 安装前置
+
+```bash
+# 安装 Gemini CLI
+npm install -g @google/gemini-cli
+
+# 配置 API Key
+gemini auth login
+```
+
+## 故障排除
+
+| 问题 | 解决方案 |
+|------|---------|
+| `gemini: command not found` | 确保已安装并添加到 PATH |
+| `SESSION_ID` 获取失败 | 检查网络连接和 API Key |
+| 输出被截断 | 使用 `--return-all-messages` 获取完整信息 |
+| 上下文过长 | 减少输入内容，分批处理 |
+| Windows 路径问题 | 使用正斜杠 `/` 或双反斜杠 `\\` |
+
+## Gemini vs Codex 选择指南
+
+| 任务类型 | 推荐模型 | 原因 |
+|---------|---------|------|
+| 前端 UI/CSS | Gemini | 视觉设计能力强 |
+| 后端逻辑 | Codex | 算法和逻辑分析强 |
+| 组件样式 | Gemini | CSS 和布局专长 |
+| API 设计 | Codex | 接口设计和架构 |
+| 代码审查 | 两者皆可 | 双模型交叉验证更好 |

package/.codex/skills/collaborating-with-gemini/scripts/gemini_bridge.py

@@ -0,0 +1,275 @@
+"""
+Gemini Bridge Script for Claude Agent Skills.
+Wraps the Gemini CLI to provide a JSON-based interface for Claude.
+"""
+
+import json
+import os
+import sys
+import queue
+import subprocess
+import threading
+import time
+import shutil
+import argparse
+from pathlib import Path
+from typing import Generator, List, Optional
+
+
+def _get_windows_npm_paths() -> List[Path]:
+    """Return candidate directories for npm global installs on Windows."""
+    if os.name != "nt":
+        return []
+    paths: List[Path] = []
+    env = os.environ
+    if prefix := env.get("NPM_CONFIG_PREFIX") or env.get("npm_config_prefix"):
+        paths.append(Path(prefix))
+    if appdata := env.get("APPDATA"):
+        paths.append(Path(appdata) / "npm")
+    if localappdata := env.get("LOCALAPPDATA"):
+        paths.append(Path(localappdata) / "npm")
+    if programfiles := env.get("ProgramFiles"):
+        paths.append(Path(programfiles) / "nodejs")
+    return paths
+
+
+def _augment_path_env(env: dict) -> None:
+    """Prepend npm global directories to PATH if missing."""
+    if os.name != "nt":
+        return
+    path_key = next((k for k in env if k.upper() == "PATH"), "PATH")
+    path_entries = [p for p in env.get(path_key, "").split(os.pathsep) if p]
+    lower_set = {p.lower() for p in path_entries}
+    for candidate in _get_windows_npm_paths():
+        if candidate.is_dir() and str(candidate).lower() not in lower_set:
+            path_entries.insert(0, str(candidate))
+            lower_set.add(str(candidate).lower())
+    env[path_key] = os.pathsep.join(path_entries)
+
+
+def _resolve_executable(name: str, env: dict) -> str:
+    """Resolve executable path, checking npm directories for .cmd/.bat on Windows."""
+    if os.path.isabs(name) or os.sep in name or (os.altsep and os.altsep in name):
+        return name
+    path_key = next((k for k in env if k.upper() == "PATH"), "PATH")
+    if resolved := shutil.which(name, path=env.get(path_key)):
+        return resolved
+    if os.name == "nt":
+        for base in _get_windows_npm_paths():
+            for ext in (".cmd", ".bat", ".exe"):
+                candidate = base / f"{name}{ext}"
+                if candidate.is_file():
+                    return str(candidate)
+    return name
+
+
+def run_shell_command(cmd: List[str], cwd: Optional[str] = None) -> Generator[str, None, None]:
+    """Execute a command and stream its output line-by-line."""
+    env = os.environ.copy()
+    _augment_path_env(env)
+
+    popen_cmd = cmd.copy()
+    exe_path = _resolve_executable(cmd[0], env)
+    popen_cmd[0] = exe_path
+
+    # Windows .cmd/.bat files need cmd.exe wrapper (avoid shell=True for security)
+    if os.name == "nt" and Path(exe_path).suffix.lower() in {".cmd", ".bat"}:
+        # Escape shell metacharacters for cmd.exe
+        def _cmd_quote(arg: str) -> str:
+            if not arg:
+                return '""'
+            # For Windows batch files, % and ^ must be escaped before quoting
+            arg = arg.replace('%', '%%')
+            arg = arg.replace('^', '^^')
+            if any(c in arg for c in '&|<>()^" \t'):
+                # To safely escape " inside "...", close quote, escape ", reopen
+                escaped = arg.replace('"', '"^""')
+                return f'"{escaped}"'
+            return arg
+        cmdline = " ".join(_cmd_quote(a) for a in popen_cmd)
+        comspec = env.get("COMSPEC", "cmd.exe")
+        # Use a single string to avoid subprocess list escaping on Windows
+        popen_cmd = f'"{comspec}" /d /s /c "{cmdline}"'
+
+    process = subprocess.Popen(
+        popen_cmd,
+        shell=False,
+        stdin=subprocess.DEVNULL,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.STDOUT,
+        universal_newlines=True,
+        encoding='utf-8',
+        errors='replace',
+        cwd=cwd,
+        env=env,
+    )
+
+    output_queue: "queue.Queue[Optional[str]]" = queue.Queue()
+    GRACEFUL_SHUTDOWN_DELAY = 0.3
+
+    def is_turn_completed(line: str) -> bool:
+        try:
+            data = json.loads(line)
+            return data.get("type") == "turn.completed"
+        except (json.JSONDecodeError, AttributeError, TypeError):
+            return False
+
+    def read_output() -> None:
+        if process.stdout:
+            for line in iter(process.stdout.readline, ""):
+                stripped = line.strip()
+                output_queue.put(stripped)
+                if is_turn_completed(stripped):
+                    time.sleep(GRACEFUL_SHUTDOWN_DELAY)
+                    process.terminate()
+                    break
+            process.stdout.close()
+        output_queue.put(None)
+
+    thread = threading.Thread(target=read_output)
+    thread.start()
+
+    while True:
+        try:
+            line = output_queue.get(timeout=0.5)
+            if line is None:
+                break
+            yield line
+        except queue.Empty:
+            if process.poll() is not None and not thread.is_alive():
+                break
+
+    try:
+        process.wait(timeout=5)
+    except subprocess.TimeoutExpired:
+        process.kill()
+        process.wait()
+    thread.join(timeout=5)
+
+    while not output_queue.empty():
+        try:
+            line = output_queue.get_nowait()
+            if line is not None:
+                yield line
+        except queue.Empty:
+            break
+
+
+def windows_escape(prompt):
+    """Windows style string escaping for newlines and special chars in prompt text."""
+    result = prompt.replace('\n', '\\n')
+    result = result.replace('\r', '\\r')
+    result = result.replace('\t', '\\t')
+    return result
+
+
+def configure_windows_stdio() -> None:
+    """Configure stdout/stderr to use UTF-8 encoding on Windows."""
+    if os.name != "nt":
+        return
+    for stream in (sys.stdout, sys.stderr):
+        reconfigure = getattr(stream, "reconfigure", None)
+        if callable(reconfigure):
+            try:
+                reconfigure(encoding="utf-8")
+            except (ValueError, OSError):
+                pass
+
+
+def main():
+    configure_windows_stdio()
+    parser = argparse.ArgumentParser(description="Gemini Bridge")
+    parser.add_argument("--PROMPT", required=True, help="Instruction for the task to send to gemini.")
+    parser.add_argument("--cd", required=True, type=Path, help="Set the workspace root for gemini before executing the task.")
+    parser.add_argument("--sandbox", action="store_true", default=False, help="Run in sandbox mode. Defaults to `False`.")
+    parser.add_argument("--SESSION_ID", default="", help="Resume the specified session of the gemini. Defaults to empty string, start a new session.")
+    parser.add_argument("--return-all-messages", action="store_true", help="Return all messages (e.g. reasoning, tool calls, etc.) from the gemini session. Set to `False` by default, only the agent's final reply message is returned.")
+    parser.add_argument("--model", default="", help="The model to use for the gemini session. This parameter is strictly prohibited unless explicitly specified by the user.")
+
+    args = parser.parse_args()
+
+    cd: Path = args.cd
+    if not cd.exists():
+        result = {
+            "success": False,
+            "error": f"The workspace root directory `{cd.absolute()}` does not exist. Please check the path and try again."
+        }
+        print(json.dumps(result, indent=2, ensure_ascii=False))
+        return
+
+    PROMPT = args.PROMPT
+    if os.name == "nt":
+        PROMPT = windows_escape(PROMPT)
+
+    cmd = ["gemini", "-o", "stream-json", PROMPT]
+
+    if args.sandbox:
+        cmd.extend(["--sandbox"])
+
+    if args.model:
+        cmd.extend(["--model", args.model])
+
+    if args.SESSION_ID:
+        cmd.extend(["--resume", args.SESSION_ID])
+
+    all_messages = []
+    agent_messages = ""
+    success = True
+    err_message = ""
+    thread_id = None
+
+    for line in run_shell_command(cmd, cwd=str(cd.absolute())):
+        try:
+            line_dict = json.loads(line.strip())
+            all_messages.append(line_dict)
+            item_type = line_dict.get("type", "")
+            item_role = line_dict.get("role", "")
+            if item_type == "message" and item_role == "assistant":
+                if (
+                    "The --prompt (-p) flag has been deprecated and will be removed in a future version. Please use a positional argument for your prompt. See gemini --help for more information.\n"
+                    in line_dict.get("content", "")
+                ):
+                    continue
+                agent_messages = agent_messages + line_dict.get("content", "")
+            if line_dict.get("session_id") is not None:
+                thread_id = line_dict.get("session_id")
+
+        except json.JSONDecodeError:
+            err_message += "\n\n[json decode error] " + line
+            continue
+
+        except Exception as error:
+            err_message += "\n\n[unexpected error] " + f"Unexpected error: {error}. Line: {line!r}"
+            break
+    
+    result = {}
+    
+    if thread_id is None:
+        success = False
+        err_message = "Failed to get `SESSION_ID` from the gemini session. \n\n" + err_message
+    else:
+        result["SESSION_ID"] = thread_id
+
+    if success and len(agent_messages) == 0:
+        success = False
+        err_message = (
+            "Failed to retrieve `agent_messages` data from the Gemini session. This might be due to Gemini performing a tool call. You can continue using the `SESSION_ID` to proceed with the conversation. \n\n "
+            + err_message
+        )
+    
+    
+    if success:
+        result["agent_messages"] = agent_messages
+    else:
+        result["error"] = err_message
+        
+    result["success"] = success
+
+    if args.return_all_messages:
+        result["all_messages"] = all_messages
+
+    print(json.dumps(result, indent=2, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()