PIG AI CODE 使用
ℹ使用要求
具备 Claude Code（付费 Vibe Coding 工具）使用经验，能够熟练操作并运用其基础插件完成日常开发任务。
基于 Claude Code 的智能代码生成工具，专为 PIGX 微服务平台设计，支持通过表结构截图、SQL 语句或自然语言描述，大幅度提高 Claude Code 代码生成准确性和降低tokens 成本消耗
功能特性
- 智能识别：支持通过表结构截图、SQL 语句或自然语言描述生成代码
- 全栈生成：一次性生成 Java 后端 + Vue3 前端完整代码
- 多种模式：支持单表 CRUD 和主子表（一对多）两种模式
- 自动配置：智能检测项目结构，自动配置路径和依赖
- 标准规范：遵循 PIGX 项目规范，生成即可用
快速开始
项目结构要求
确保你的项目结构如下：
root/
├── .claude/
│ └── skills/ # ← 技能安装目录
├── pigx # 后端项目
├── pigx-ui # 前端项目
└── CLAUDE.md # Claude Code 上下文文件
安装技能
在 skills 目录下克隆本仓库：
cd /path/to/your/project/.claude/skills
git clone https://git.pig4cloud.com/pig/pig-ai-code-skill.git pig-ai-code
重启 Claude Code
安装完成后，重启 Claude Code 使技能生效。
开始使用
在 Claude Code 对话框中输入：
use pig-ai-code
我需要生成一个用户表的增删改查功能
[提供表结构截图或 SQL 语句]
使用示例
示例 1：通过 SQL 生成
CREATE TABLE test_user (
id BIGINT PRIMARY KEY COMMENT '主键ID',
username VARCHAR(64) NOT NULL COMMENT '用户名',
nickname VARCHAR(64) COMMENT '昵称',
email VARCHAR(128) COMMENT '邮箱',
phone VARCHAR(20) COMMENT '手机号',
status CHAR(1) DEFAULT '0' COMMENT '状态',
create_time DATETIME COMMENT '创建时间',
update_time DATETIME COMMENT '更新时间'
) COMMENT='用户表';
告诉 Claude：
use pig-ai-code
生成上面这个用户表的增删改查代码
示例 2：通过截图生成
- 在 Navicat、DataGrip 等工具中打开表结构
- 截图表结构设计
- 在对话框中输入：
use pig-ai-code
[粘贴截图]
生成这个表的增删改查功能
示例 3：通过自然语言生成
use pig-ai-code
我需要一个商品表，包含：
- 商品名称
- 商品价格
- 库存数量
- 商品分类
- 商品状态
生成增删改查代码
配置说明
必填参数
在生成过程中，AI 会询问以下信和推理以下信息
| 参数 | 说明 | 示例 |
|---|
| 模板类型 | 单表或主子表 | 单表增删改查 |
| 后端项目路径 | 后端模块的绝对路径 | /Users/xxx/pigx/pigx-upms |
| 前端项目路径 | 前端项目的绝对路径 | /Users/xxx/pigx-ui-pro |
| 模块名 | URL 路径中的模块名 | admin |
| 功能名 | 功能标识（用于文件命名） | user |
| 类名 | 实体类名 | User |
| 作者 | 代码作者 | lengleng |
| 包名 | Java 包名 | com.pig4cloud.pigx |
自动检测功能
AI 会自动检测表结构并启用相应功能：
| 字段名 | 自动启用功能 |
|---|
tenant_id | 多租户支持 |
del_flag | 逻辑删除 |
create_time / create_by | 创建时间/人自动填充 |
update_time / update_by | 更新时间/人自动填充 |
项目结构
pig-ai-code/
├── README.md # 本文档
├── SKILL.md # 详细技术文档（供 AI 参考）
├── REFERENCE.md # 模板变量参考手册
├── TEMPLATES.md # 模板文件说明
├── scripts/ # 核心脚本
│ ├── init-env.sh # 环境初始化脚本
│ ├── render.js # 模板渲染引擎
│ └── package.json # Node.js 依赖配置
└── templates/ # 代码模板
├── config.json # 模板配置文件
├── single/ # 单表模板
├── multiple/ # 主子表模板
└── common/ # 公共模板
技术架构
用户输入（截图/SQL/描述）
↓
Claude AI 智能识别
↓
收集必要参数
↓
调用 render.js 渲染模板
↓
自动生成并写入文件
技术栈
- AI 引擎：Claude Sonnet 4.5
- 代码规范：PIGX 企业级标准
生成后的下一步
1. 刷新项目
在 IDEA 中刷新后端项目，确保新文件被识别。
2. 执行菜单 SQL
找到生成的菜单 SQL 文件：
pigx-upms/menu/user_menu.sql
在数据库中执行此 SQL，创建菜单和权限。
3. 重启服务
重启对应的后端服务（如 pigx-upms），使新代码生效。
4. 访问前端
刷新前端页面，在菜单中找到新增的功能模块。
适用场景
- ✅ PIGX 微服务平台的功能模块开发
- ✅ 快速搭建标准 CRUD 功能原型
- ✅ 统一团队代码风格和规范
- ✅ 减少重复性编码工作
Powered by PIGX & Claude AI