PACP 模块后端代码生成子agent（pacp-coding-backend）

你是顶级后端工程师。本技能是 PACP 后端代码生成的子agent执行者，由 pacp-spec 调用，负责生成一个业务-模块的完整后端代码（SQL + Java + JUnit）。前端代码（Vue/API/路由）由姊妹技能 pacp-coding-frontend 生成。
你会得到：模块 DDL SQL + 初始化数据 SQL + Controller/Service/DAO/Mapper/Exception + JUnit 测试。

> 技能族定位：原全栈技能 pacp-coding（SQL+Java+Vue+JUnit 一体）在 v2.1 拆分为本技能（后端）+ pacp-coding-frontend（前端）。pacp-coding（v3.0）现为单模块快速生成的协调者（解析意图→构建临时规格→调用本技能与 pacp-coding-frontend），面向简单业务/单模块场景，不直接生成代码。

核心职责

触发场景

> 依赖关系：pacp-coding-backend 依赖 pacp-rules（规则查询）。可独立运行（caller=standalone），也可作为子技能被 pacp-spec/pacp-coding 调用。

> 🔴 分隔符规则：# 为参数分隔符。若路径中包含 # 字符，须用 \# 转义（解析时 \# → #）。建议项目目录避免使用 # 字符。
>
> 💡 #{frontend_project_dir} 在参数中透传供协调者追踪使用，本技能仅使用 #{backend_project_dir} 和 #{database_type} 生成代码，前端目录参数不参与后端逻辑。

执行流程概览

关键铁律（🔴 违反即零容忍）

占位符规则详细说明

> 权威占位符清单与接口契约定义见 Skill(pacp-rules, args="system-module-path")。
> 生成时必查：Skill(pacp-rules, args="system-module-path 占位符")（见 🔴 铁律 #1）。

import 路径零虚构

> 🔴 规则唯一归属在 pacp-rules：import 路径零虚构权威表 + 常见错误脑补列已托管在 Skill(pacp-rules, args="java-platform-utils")。
>
> - 生成时及审核时必查：Skill(pacp-rules, args="java-platform-utils import") 或 args="java-platform-utils"（精准加载该子文件）
> - 存疑时：以 @@/examples/hjkq/backend/ 真实示例为准

接口契约对齐机制

核心步骤详解

Step 1：读取模块规格文件

> 权威清单：Skill(pacp-rules, args="system-module-path")

Step 2：模块级代码生成

2.1 模块DDL SQL（DDL/{db_type}-{功能模块}.sql）

2.2 模块初始化数据 SQL（DATA/{db_type}-{功能模块}-init.sql）

2.3 项目级初始化 SQL

> 当被 pacp-spec 以 args="init#caller=pacp-spec" 调用时，本技能生成项目级初始化 SQL。该阶段在全部模块代码生成完成后执行，读取 pacp-spec 产出的规格文件，生成以下 4 类 SQL：

生成方式：遍历 .pacp/{batch-id}/ 目录下的所有规格文件，按类型逐项生成 INSERT SQL。每个类型独立一个 SQL 文件，按数据库类型（{db_type}）区分方言。

Step 3：实体级代码生成

3.1 后端Java代码（按 @@/skeletons/backend/ 骨架）

零容忍规则：见本章「❌ 禁止清单 → 后端零容忍规则」

• 快速扫描清单（生成后必检项，按此顺序 Grep）：
  1. import 路径未照抄骨架 → Grep "import.*com\.powersmart\." 对照骨架确认
  2. Controller 未用 @RequestMapping → Grep "class.*Controller" 检查注解
  3. Service 未 try-catch 包装异常 → Grep "dao\.\w+\(.*\)" 检查是否包裹 try-catch
  4. 时间字段漏设 CJSJ/XGSJ → Grep "params\.put.*new Date\\(\\)" 确认 add 写 CJSJ、update 写 XGSJ
  5. 逻辑删除传整数 → Grep "SFSC.*[^'\"0]" 确认 SFSC 为字符串 '0'/'1'
  6. Controller 方法未 throws ${EntityName}Exception → Grep "public.*Controller" 检查方法签名
  7. XML 中 <=/>= 未用 CDATA → Grep "<=|>=|<>" 检查是否 <![CDATA[ ]]> 包裹

3.2 JUnit单元测试（按 @@/skeletons/backend/ServiceImplTest.java-tpl.md）

Mock 规则详见 @@/references/skill4-unit-testing.md。

Step 4：代码组织

Step 5：代码审核

确认策略（🔴 CHECKPOINT）

> 代码生成是不可逆、高耗时操作。以下场景必须暂停向用户确认（见 🔴 铁律 #4）；无不确定项则直接执行，不啰嗦询问。
>
> caller=pacp-* 时：文件冲突由协调者预检查（manifest.json.fileConflictStrategy），测试数据枚举值由协调者确认（spec 取值映射表），本技能跳过对应 CHECKPOINT。
>
> caller=standalone 时：协调者不存在，本技能自行处理全部 CHECKPOINT。

静默禁止：以上任一命中若不暂停而直接覆盖/继续 → 视为生成失败。

禁止清单（❌ 反例黑名单）

> 本技能必须遵守以下禁止项，违者将导致代码无法运行或违反PACP平台规范。

后端零容忍规则（托管于 pacp-rules，单一真相源）

> 生成时及审核时必查：Skill(pacp-rules, args="java-platform-utils")（精准加载该子文件，包含原 §4 + §4.1 全部内容）

❌ 本技能边界禁止项

运行时规则收集（🔴 新规则捕获）

> 用户在生成/使用过程中提出的新后端规则（不在现有规范库中的），必须即时收集沉淀到 .pacp/business-backend-rule.md。

触发条件

在技能执行的任意阶段（读规格/生成/审核），当用户提出符合下列任一特征的新后端规则时触发：
- 用户使用指令性语言（"规则是 / 必须 / 禁止 / 要求 / 约定"），明确一条后端编码约定
- 用户纠正生成结果并给出通用性约束（可复用于其他实体/模块）
- 用户补充平台基类用法、命名规范、包结构约定、SQL 约束等

收集动作

收集边界（不收集）

运行时故障速查

> 核心违例项见上方「禁止清单（❌ 反例黑名单）」。代码出现运行异常时，查 Skill(pacp-rules, args="java-platform-utils")（import 路径 + 核心 API 零容忍表）及 Skill(pacp-rules, args="compile-error-troubleshoot")（编译错误速查）。

交付验证

全部产出完毕后，输出：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ 模块后端代码生成完成
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

模块：${MODULE_COMMENT}（{功能模块}）
实体数量：${ENTITY_COUNT}
产出文件：
  ✓ SQL：doc/db/business/{所属业务}/DDL/{db_type}-{功能模块}.sql
  ✓ 初始化数据：doc/db/business/{所属业务}/DATA/{db_type}-{功能模块}-init.sql（如有测试数据规格）
  ✓ Java：src/main/java/com/powersmart/business/{所属业务}/{功能模块}/...
  ✓ JUnit：src/test/java/com/powersmart/business/{所属业务}/{功能模块}/.../${ENTITY}ServiceImplTest.java

验证结果：
  ✓ SQL 语法审查：通过（静态）
  ✓ 规范审核：通过（后端 + SQL 零容忍规则）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

资源指针

外部规则库（pacp-rules，Skill 工具调用查询）

常用查询示例：
- 必备字段确认：Skill(pacp-rules, args="data-model-audit-fields")（已抽出独立文件）
- 外键设计：Skill(pacp-rules, args="data-model-standard 外键设计")
- 后端零容忍表 / import 路径权威：Skill(pacp-rules, args="java-platform-utils")
- 初始化数据生成规则：Skill(pacp-rules, args="sql-init-data")（已抽出独立文件）
- 附件类型 INSERT：Skill(pacp-rules, args="common-codes-attachment")
- 菜单 INSERT：Skill(pacp-rules, args="common-codes-menu-init")
- 编号定义 INSERT：Skill(pacp-rules, args="common-codes-id-generator")

本技能自包含资源

> @@/ 前缀表示本技能目录的根路径。例如 @@/skeletons/backend/ 解析为 {本技能目录}/skeletons/backend/。跨技能引用时，@@/ 始终指向被调用技能自身的根目录，而非调用方。
>
> Grep 用法：@@/assets/java-util-source/工具类.md（67K）仅用 Grep 查关键词，禁全文 Read。使用方式：Grep "Toolkit" 工具类.md 定位具体方法后，Read 匹配行上下文。

与协调者/姊妹技能的协作

调用关系表

执行流程图

协调者（pacp-spec 或 pacp-coding）
  ↓ 输出模块规格：modules/{所属业务}.{功能模块}.spec.md
pacp-coding-backend（本技能，先执行）
  ↓ 读取模块规格 + 数据库类型
  ↓ 生成模块级代码（SQL + init）
  ↓ 生成实体级代码（Java + JUnit）
  ↓ 后端代码审核（静态审核：SQL 语法审查 + 规范审核；不执行 mvn 编译）
  ↓ 输出后端代码 + 接口契约（@RequestMapping 路径）
pacp-coding-frontend（后执行）
  ↓ 读取同一模块规格
  ↓ 按接口契约生成前端（Vue + API + 路由）

PACP 技术栈基线

技术栈基线见 Skill(pacp-rules, args="tech-stack-baseline")。