AI 辅助开发

狸花猫 3.0 为 AI 辅助开发内置了一套技能（Skills），存放在本仓根目录 skills/ 下。技能以 Markdown 文件承载项目约定与工作流程，供 Claude Code、Codex 等 AI 编码工具读取——AI 按技能文件中的规范开发，无需每次口头重复约定。

🧩 技能清单

文件	类型	用途
skills/init.md	初始化流程	脚手架二次开发初始化：项目改名、版本重置、功能裁剪、多仓工作区布局
skills/lihua-backend.md	开发规范	本仓（单体后端）服务端开发与验证的项目约定

🚀 使用方式

1. 首次接管：执行 init

下载项目后第一次让 AI 接管时，对 AI 编码工具说：

执行 init

AI 会读取 skills/init.md 并按流程执行：工作区发现 → 问卷 → 改动清单确认 → 分步执行 → 验证报告。init 完成时会在各仓根目录生成 AGENTS.md 与 CLAUDE.md 入口指针（CLAUDE.md 内容仅一行 @AGENTS.md），此后每次会话 AI 都能自动发现 skills/ 与技能用途。

2. 日常开发：规范自动生效

init 之后（或未做 init 时直接指定），AI 处理本仓改动会按 skills/lihua-backend.md 中的约定工作：代码落位决策树、Controller/Service/Mapper 规范、字典与枚举纪律、附件域契约、WebSocket 推送用法、删码死活判定纪律、跨端协作与双仓同步等。你只需用自然语言描述需求。

🎯 init：二次开发初始化

init 的定位是「把脚手架变成你的项目」——问卷 → 改动清单确认 → 分步执行（每步验证 + commit），纪律高于速度。

工作区协同：init 以本仓为驱动、覆盖整个多仓工作区（本后端 + lihua-web / lihua-app 兄弟仓）；lihua 与 lihua-cloud 是二选一的两套后端，同存于一个工作区时 init 会先确认初始化哪套。最少组合为「后端 + lihua-web」。

Phase 1 问卷内容（均带默认值，一次收集）：

1. 项目名称：新名 slug（包名/artifactId/数据库名/存储键前缀）+ 中文名（品牌显示）。
2. 改名层级（三档，向上包含）：
   • 品牌层：README、web/app 应用名与页面标题、登录页文案、compose 项目名
   • 品牌+标识层（加）：Maven artifactId 与模块目录名、数据库名、package.json name、存储键前缀、SQL 文件名
   • 全量（加）：Java 包名 com.lihua → com.<slug>（约 300+ 文件，纯机械替换 + 编译兜底）
3. 初始版本：默认重置为 1.0.0（后端 pom、前端 package.json、App versionCode=100、首页版本记录）。
4. 功能裁剪（多选预设，先出细清单经确认再删）：
   • 部门+岗位：联动面最大——域本体、用户管理消费点、注册链路、默认部门切换、登录后向导、SQL 种子与两端页面
   • App 端：删除 controller/app 包，双版本基类下放合并，app-version 域整体裁剪
   • 监控：删 lihua-biz/lihua-monitor 模块与两端页面
   • 组件演示页：删两端演示页与演示路由
   • 通知公告：notice 域 + WS 红点链路 + 两端通知页面（可连带裁 WS）
5. 复述全部选择确认后执行。

执行纪律：每步一 commit（用户项目历史从 init 开始）、不 push；所有删除先列清单经确认；产出 INIT-REPORT（替换映射表、裁剪清单、豁免项、后续建议）。

📖 开发规范：lihua-backend

处理本仓服务端改动时 AI 自动遵循，覆盖：

• 代码落位：新增业务建 lihua-biz 子模块 / 通用组件建 lihua-base 子模块 / 简单工具进 base-common，四类落位决策树
• 业务结构：entity / dto / vo / mapper+XML / service / controller 标准结构与统一返回、分页、校验范式
• 安全与横切：@PreAuthorize + @Log 三件套、LoginUserContext 登录态、防重复提交、异步上下文接力
• 字典与枚举：DictEnum 纪律、字典三通道、缓存铁律、校验注解范式
• 附件域：上传 DTO 契约、分片合并原子性、HMAC 签名下载链
• WebSocket：WebSocketPushUtils 唯一投递入口、上行处理器 SPI、事务后推送
• 删码纪律：死活判定（getter/setter 形态 grep、消费方编译佐证、依赖分析误报甄别）
• 跨端协作：本仓是契约源头，先定后端契约再同步 web/app 两端；与 lihua-cloud 仓 base 层双仓同步
• 部署与验证：Dockerfile 镜像选型纪律、mvn -pl <module> -am 定向验证

⚠️ 注意事项

• AGENTS.md / CLAUDE.md 是 init 的产物，脚手架仓库本身不携带——首次使用直接对 AI 说「执行 init」即可，不必手动创建。
• 技能文件中的路径与规则随项目演进，改名波及 skills/ 内路径字样时 init 会同步更新（skill 是活文档）。
• 技能与代码冲突时，以代码为准，并向使用者回报差异。