ai-engineering-init 1.1.0

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()

package/.codex/skills/crud/SKILL.md

@@ -0,0 +1,265 @@
+---
+name: crud
+description: |
+  当需要基于已存在的数据库表快速生成 CRUD 代码时自动使用此 Skill。
+
+  触发场景：
+  - 数据库表已存在，需要生成后端代码
+  - 需要标准的增删改查功能
+  - 快速原型开发
+  - 需要生成树形结构的 CRUD
+
+  触发词：生成CRUD、crud、代码生成、快速生成、生成代码、CRUD生成、表生成代码
+---
+
+# /crud - 快速生成 CRUD 代码
+
+作为 CRUD 代码生成助手，基于已存在的数据库表快速生成标准后端 CRUD 代码。
+
+## 🎯 适用场景
+
+### ✅ 适合使用 `/crud` 的情况
+
+- ✅ **数据库表已存在** - 表结构已设计完毕
+- ✅ **只需标准 CRUD** - 增删改查、导入导出等标准功能
+- ✅ **无复杂业务逻辑** - 没有特殊的业务规则
+- ✅ **快速原型开发** - 需要快速搭建基础功能
+- ✅ **树形结构数据** - 部门、分类等层级数据（tree 模板）
+
+### ❌ 不适合使用 `/crud` 的情况
+
+- ❌ **表结构尚未设计** → 请使用 `/dev` 命令
+- ❌ **需要复杂业务逻辑** → 请使用 `/dev` 命令后手动增强
+
+### 📋 支持的模板类型
+
+| 模板类型 | 适用场景 | 特点 |
+|---------|---------|------|
+| **crud** | 普通表 | 标准增删改查、分页列表 |
+| **tree** | 树形表 | 父子层级、展开折叠、无分页 |
+
+---
+
+## 📋 执行流程
+
+### 第一步：连接数据库并查看表结构
+
+```
+请提供表名：
+（如：sys_notice, demo_xxx）
+
+💡 数据库连接信息将从 application-dev.yml 自动读取
+```
+
+读取 `ruoyi-admin/src/main/resources/application-dev.yml` 获取数据库配置。
+
+### 第二步：分析表结构
+
+```bash
+SHOW CREATE TABLE [表名];
+DESC [表名];
+```
+
+**字段类型映射规则**：
+
+| 数据库类型 | Java类型 | 说明 |
+|-----------|---------|------|
+| BIGINT(20), BIGINT | Long | 长整数 |
+| INT(11), INT | Integer | 整数 |
+| VARCHAR(n), CHAR(n) | String | 字符串 |
+| TEXT, LONGTEXT | String | 长文本 |
+| DATETIME, TIMESTAMP | Date | 日期时间 |
+| DECIMAL(m,n) | BigDecimal | 高精度数值 |
+| TINYINT(1), CHAR(1) | String | 状态字段（0/1）|
+
+### 第三步：选择模板类型
+
+**自动检测规则**：
+- 表中包含 `parent_id` 字段且 `parent_id` 为 BIGINT → `tree` 模板
+- 其他情况 → `crud` 模板
+
+### 第四步：生成菜单 SQL
+
+根据表名前缀确定模块名：
+
+| 表名前缀 | 模块名 | 权限标识符格式 |
+|---------|--------|--------------|
+| `sys_` | `system` | `system:[功能名]:[操作]` |
+| `demo_` | `demo` | `demo:[功能名]:[操作]` |
+
+生成完整的菜单 SQL（6个权限：查看、查询、新增、修改、删除、导出）。
+
+### 第五步：生成后端代码
+
+**学习现有代码（强制执行）**：
+
+```bash
+Read ruoyi-system/src/main/java/org/dromara/system/controller/SysNoticeController.java
+Read ruoyi-system/src/main/java/org/dromara/system/service/impl/SysNoticeServiceImpl.java
+```
+
+**生成代码顺序（三层架构）**：
+
+1. **Entity** - 继承 TenantEntity，字段从表结构映射
+2. **BO** - 使用 @AutoMapper 注解
+3. **VO** - 含 Excel 导出注解
+4. **Mapper** - 继承 BaseMapperPlus
+5. **Service 接口** - 标准 CRUD 方法声明
+6. **ServiceImpl** - 业务逻辑实现，包含 buildQueryWrapper
+7. **Controller** - 标准接口 + 导入导出
+
+**查询条件生成规则**：
+
+| 字段名后缀 | 查询方式 | Java类型 | 说明 |
+|-----------|---------|---------|------|
+| `xxx_name`、`xxx_title` | LIKE | String | 名称/标题字段 |
+| `xxx_content`、`remark` | LIKE | String | 长文本/备注字段 |
+| `id`、`code` | EQ | Long/String | ID/编码字段 |
+| `status` | EQ | String | 标准状态字段 |
+| `xxx_type` | EQ | String | 分类/类型字段 |
+| `xxx_time`、`xxx_date` | BETWEEN | Date | 日期/时间范围查询 |
+
+---
+
+## 代码模板
+
+### Entity 模板
+
+```java
+package org.dromara.[模块].domain;
+
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import org.dromara.common.tenant.core.TenantEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("[表名]")
+public class [实体名] extends TenantEntity {
+
+    @TableId(value = "id")
+    private Long id;
+
+    // 业务字段...
+}
+```
+
+### BO 模板
+
+```java
+package org.dromara.[模块].domain.bo;
+
+import org.dromara.[模块].domain.[实体名];
+import org.dromara.common.mybatis.core.domain.BaseEntity;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = [实体名].class, reverseConvertGenerate = false)
+public class [实体名]Bo extends BaseEntity {
+
+    private Long id;
+
+    // 业务字段...
+}
+```
+
+### ServiceImpl 模板
+
+```java
+package org.dromara.[模块].service.impl;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+import lombok.RequiredArgsConstructor;
+import org.dromara.[模块].domain.[实体名];
+import org.dromara.[模块].domain.bo.[实体名]Bo;
+import org.dromara.[模块].domain.vo.[实体名]Vo;
+import org.dromara.[模块].mapper.[实体名]Mapper;
+import org.dromara.[模块].service.I[实体名]Service;
+import org.dromara.common.core.utils.MapstructUtils;
+import org.dromara.common.core.utils.StringUtils;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.springframework.stereotype.Service;
+
+@RequiredArgsConstructor
+@Service
+public class [实体名]ServiceImpl implements I[实体名]Service {
+
+    private final [实体名]Mapper baseMapper;
+
+    private LambdaQueryWrapper<[实体名]> buildQueryWrapper([实体名]Bo bo) {
+        LambdaQueryWrapper<[实体名]> lqw = Wrappers.lambdaQuery();
+        // 根据字段类型添加查询条件
+        return lqw;
+    }
+
+    @Override
+    public Boolean insertByBo([实体名]Bo bo) {
+        [实体名] add = MapstructUtils.convert(bo, [实体名].class);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setId(add.getId());
+        }
+        return flag;
+    }
+
+    @Override
+    public Boolean updateByBo([实体名]Bo bo) {
+        [实体名] update = MapstructUtils.convert(bo, [实体名].class);
+        return baseMapper.updateById(update) > 0;
+    }
+}
+```
+
+---
+
+## 输出清单
+
+```markdown
+✅ CRUD 代码生成完成！
+
+## 已生成文件清单
+
+### 菜单 SQL
+- ✅ 菜单 SQL（需手动执行）
+
+### 后端代码 (7个文件)
+- ✅ domain/Xxx.java (Entity)
+- ✅ domain/bo/XxxBo.java (BO)
+- ✅ domain/vo/XxxVo.java (VO)
+- ✅ mapper/XxxMapper.java (Mapper)
+- ✅ service/IXxxService.java (Service接口)
+- ✅ service/impl/XxxServiceImpl.java (Service实现)
+- ✅ controller/XxxController.java (Controller)
+
+## 下一步操作
+
+1. 执行菜单 SQL
+2. 重启后端服务
+3. 测试接口（Swagger: http://localhost:8080/doc.html）
+4. 配置菜单权限
+```
+
+---
+
+## 与 `/dev` 命令的区别
+
+| 对比项 | `/crud` | `/dev` |
+|--------|---------|--------|
+| **适用场景** | 表已存在 | 从零开始 |
+| **表结构设计** | ❌ 跳过 | ✅ 引导设计 |
+| **菜单 SQL** | ✅ 生成 | ✅ 生成 |
+| **代码生成** | ✅ 自动 | ✅ 自动 |
+| **树表支持** | ✅ 支持 | ✅ 支持 |
+| **执行速度** | ⚡ 快速 | 🐢 较慢 |
+
+**建议**：
+- 快速原型：使用 `/crud`
+- 正式开发：使用 `/dev`
+- 表已存在：使用 `/crud`