wonderslife/pdd-skills-v3/pdd-template-engine

PDD模板引擎技能

根据功能点规格自动选择和渲染代码模板，生成符合项目规范的代码文件。支持若依框架和Activiti工作流的代码生成。

触发条件

• 用户请求"生成代码"、"使用模板生成"等
• pdd-implement-feature技能调用
• 用户指定使用特定场景模板

核心能力

1. 模板选择

2. 变量提取

• 基础变量: entityName/tableName/businessName/moduleName
• 字段变量: fields/searchFields/formFields/requiredFields
• 工作流变量: processKey/approvalRules/processVariables

3. 模板渲染 (Handlebars)

变量替换: {{variableName}}
条件渲染: {{#if condition}}...{{/if}}
循环渲染: {{#each items}}...{{/each}}
辅助函数: pascalCase / camelCase / kebabCase / snakeCase

4. 代码生成

• 后端: Controller/Service/ServiceImpl/Mapper/Mapper.xml/Entity/SQL
• 前端: Vue组件(list/form/detail)/API接口/工作流组件(approval-panel)
• 工作流: BPMN定义/ProcessService/TaskListener

执行流程

输入: spec.md + feature-matrix.md
1. 解析规格文档(实体/字段/业务规则/流程)
2. 选择场景模板(判断是否需要工作流/加载场景配置/确定模板列表)
3. 构建变量字典(基础/字段/条件变量)
4. 渲染模板文件(读取/替换/条件/循环)
5. 输出代码文件(确定路径/写入/记录日志)
输出: 生成的代码文件列表

模板变量参考

基础变量: package/entityName/entityNameLower/tableName/moduleName/businessName/permissionPrefix/author/datetime 字段变量: fields/fields[].name/type/label/comment/required/dictType 工作流变量: processKey/processName/candidateGroups/approvalRules/processVariables

使用示例

完整示例见 references/examples.md（简单CRUD生成、工作流生成、PRD约定注入）

PRD感知动态模板

脚手架感知选择

PRD约定注入

从PRD提取约定注入模板变量: 枚举编码(snake_case) | 类型映射(pythonType/javaType/tsType) | 表单组件(el-select等) | Options API数据源

Python Fullstack模板变量

modelName/schemaName/optionSchemaName/routerPrefix/fields[].saType/pydanticType/tsType

若依模板变量

packageName/entityName/mapperName/serviceName/controllerName/permissionPrefix/menuParentId/fields[].javaType/mybatisType/dictType

Bug模式库防护

完整模式定义: config/bug-patterns.yaml 模板渲染后自动检查: datetime字段类型(PATTERN-001) | /options路由顺序(PATTERN-002) | 枚举编码(PATTERN-003) | safeAlert使用(PATTERN-004) | 若依权限注解(PATTERN-R001) | 若依菜单配置(PATTERN-R002)

错误处理

协作关系

• 被调用: pdd-implement-feature
• 咨询: expert-ruoyi(若依规范) / expert-activiti(工作流规范)
• 输出给: pdd-code-reviewer(生成的代码需审查)

注意事项

1. 变量完整性 2. 条件渲染 3. 输出路径符合项目规范 4. 编码规范 5. 文本字段加@Xss注解 6. 菜单配置包含所有页面