pdd-skills 3.0.0

package/skills/pr/pdd-template-engine/SKILL.md

@@ -0,0 +1,306 @@
+---
+name: pdd-template-engine
+description: |
+  PDD模板引擎技能，根据功能点规格自动选择和渲染代码模板。当用户需要生成代码、使用模板快速开发、自动生成代码、批量生成、脚手架、代码骨架、快速生成、模板生成、基础代码框架、生成脚手架等场景时自动触发。支持若依框架CRUD和Activiti工作流场景，可将代码有效率从50%提升至75%+。即使用户只说"生成代码"、"用模板"、"脚手架生成"、"生成脚手架"等简短表述，也应触发此Skill。
+license: MIT
+compatibility: 需要模板库 (.trae/templates/)
+metadata:
+  author: "neuqik@hotmail.com"
+  version: "1.0"
+---
+
+# PDD模板引擎技能
+
+## 技能描述
+
+PDD模板引擎是一个代码生成工具，根据功能点规格自动选择和渲染代码模板，生成符合项目规范的代码文件。支持若依框架和Activiti工作流的代码生成。
+
+## 触发条件
+
+- 用户请求"生成代码"、"使用模板生成"等
+- pdd-implement-feature技能调用
+- 用户指定使用特定场景模板
+
+## 核心能力
+
+### 1. 模板选择
+
+根据功能点特征自动选择合适的模板组合：
+
+| 场景类型 | 判断条件 | 使用模板 |
+|---------|---------|---------|
+| 简单CRUD | 无审批流程 | scenarios/crud |
+| 工作流+CRUD | 需要审批流程 | scenarios/workflow-crud |
+
+### 2. 变量提取
+
+从spec.md中提取模板变量：
+
+```yaml
+提取规则:
+  基础变量:
+    - entityName: 从数据模型中提取实体名称
+    - tableName: 从数据模型中提取表名
+    - businessName: 从功能描述中提取业务名称
+    - moduleName: 根据模块编号转换
+  
+  字段变量:
+    - fields: 从数据模型字段列表提取
+    - searchFields: 从查询条件提取
+    - formFields: 从表单设计提取
+    - requiredFields: 从验证规则提取
+  
+  工作流变量:
+    - processKey: 从流程设计提取
+    - approvalRules: 从审批规则提取
+    - processVariables: 从流程变量定义提取
+```
+
+### 3. 模板渲染
+
+使用Handlebars语法渲染模板：
+
+```yaml
+渲染规则:
+  变量替换: {{variableName}}
+  条件渲染: {{#if condition}}...{{/if}}
+  循环渲染: {{#each items}}...{{/each}}
+  辅助函数:
+    - pascalCase: 转换为PascalCase
+    - camelCase: 转换为camelCase
+    - kebabCase: 转换为kebab-case
+    - snakeCase: 转换为snake_case
+```
+
+### 4. 代码生成
+
+生成符合项目规范的代码文件：
+
+```yaml
+输出结构:
+  后端:
+    - Controller.java
+    - Service.java / ServiceImpl.java
+    - Mapper.java / Mapper.xml
+    - Entity.java
+    - SQL脚本
+  
+  前端:
+    - Vue组件 (list/form/detail)
+    - API接口文件
+    - 工作流组件 (approval-panel)
+  
+  工作流:
+    - BPMN流程定义文件
+    - ProcessService.java
+    - TaskListener.java
+```
+
+## 执行流程
+
+```
+输入: spec.md + feature-matrix.md
+    │
+    ▼
+┌─────────────────────────────────┐
+│   1. 解析规格文档               │
+│   - 提取实体定义                │
+│   - 提取字段列表                │
+│   - 提取业务规则                │
+│   - 提取流程定义                │
+└─────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────┐
+│   2. 选择场景模板               │
+│   - 判断是否需要工作流          │
+│   - 加载场景配置                │
+│   - 确定模板列表                │
+└─────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────┐
+│   3. 构建变量字典               │
+│   - 基础变量                    │
+│   - 字段变量                    │
+│   - 条件变量                    │
+└─────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────┐
+│   4. 渲染模板文件               │
+│   - 读取模板内容                │
+│   - 替换变量                    │
+│   - 处理条件渲染                │
+│   - 处理循环渲染                │
+└─────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────┐
+│   5. 输出代码文件               │
+│   - 确定输出路径                │
+│   - 写入文件                    │
+│   - 记录生成日志                │
+└─────────────────────────────────┘
+    │
+    ▼
+输出: 生成的代码文件列表
+```
+
+## 模板变量参考
+
+### 基础变量
+
+| 变量名 | 说明 | 示例 |
+|-------|------|------|
+| package | 包路径 | com.sjjk.equity.transfer |
+| entityName | 实体类名称 | EquityTransferApply |
+| entityNameLower | 实体类名称(小写) | equityTransferApply |
+| tableName | 数据库表名 | equity_transfer_apply |
+| moduleName | 模块名称 | equity-transfer |
+| businessName | 业务名称 | 国有产权转让申请 |
+| permissionPrefix | 权限前缀 | equity:transfer |
+| author | 作者 | sjjk |
+| datetime | 日期时间 | 2026-03-31 |
+
+### 字段变量
+
+| 变量名 | 说明 | 类型 |
+|-------|------|------|
+| fields | 字段列表 | array |
+| fields[].name | 字段名称 | string |
+| fields[].type | 字段类型 | string |
+| fields[].label | 字段标签 | string |
+| fields[].comment | 字段注释 | string |
+| fields[].required | 是否必填 | boolean |
+| fields[].dictType | 字典类型 | string |
+
+### 工作流变量
+
+| 变量名 | 说明 | 示例 |
+|-------|------|------|
+| processKey | 流程定义Key | equity-transfer-approval |
+| processName | 流程名称 | 国有产权转让审批流程 |
+| candidateGroups | 候选组 | manager,leader |
+| approvalRules | 审批规则 | array |
+| processVariables | 流程变量 | array |
+
+## 使用示例
+
+### 示例1: 生成简单CRUD代码
+
+```yaml
+输入:
+  spec.md: |
+    # 国有产权转让申请
+    
+    ## 数据模型
+    实体: EquityTransferApply
+    表名: equity_transfer_apply
+    
+    字段:
+      - name: transferType
+        type: string
+        label: 转让方式
+      - name: transferReason
+        type: string
+        label: 转让原因
+
+执行:
+  场景: crud
+  模板: scenarios/crud
+
+输出:
+  - EquityTransferApplyController.java
+  - IEquityTransferApplyService.java
+  - EquityTransferApplyServiceImpl.java
+  - EquityTransferApplyMapper.java
+  - EquityTransferApplyMapper.xml
+  - EquityTransferApply.java
+  - equity_transfer_apply.sql
+  - menu_equity_transfer_apply.sql
+  - index.vue
+  - form.vue
+  - detail.vue
+  - equity-transfer.js
+```
+
+### 示例2: 生成工作流代码
+
+```yaml
+输入:
+  spec.md: |
+    # 资产处置审批
+    
+    ## 数据模型
+    实体: AssetDisposalApply
+    表名: asset_disposal_apply
+    
+    ## 流程定义
+    流程Key: asset-disposal-approval
+    审批类型: multi-level
+    
+    ## 审批规则
+    - 金额 >= 500万: 集团审批
+    - 金额 >= 30万: 子公司审批
+    - 金额 < 30万: 自动通过
+
+执行:
+  场景: workflow-crud
+  模板: scenarios/workflow-crud
+
+输出:
+  后端:
+    - AssetDisposalApplyController.java
+    - IAssetDisposalApplyService.java
+    - AssetDisposalApplyServiceImpl.java
+    - AssetDisposalApplyMapper.java
+    - AssetDisposalApplyMapper.xml
+    - AssetDisposalApply.java
+    - AssetDisposalApplyProcessService.java
+    - AssetDisposalTaskListener.java
+    - asset-disposal-approval.bpmn20.xml
+  
+  前端:
+    - index.vue
+    - form.vue
+    - detail.vue
+    - ApprovalPanel.vue
+    - asset-disposal.js
+  
+  SQL:
+    - asset_disposal_apply.sql
+    - menu_asset_disposal_apply.sql
+```
+
+## 协作关系
+
+```yaml
+被调用:
+  - pdd-implement-feature: 实现功能点时调用
+
+咨询:
+  - expert-ruoyi: 若依框架规范验证
+  - expert-activiti: 工作流规范验证
+
+输出给:
+  - pdd-code-reviewer: 生成的代码需要审查
+```
+
+## 注意事项
+
+1. **变量完整性**: 确保所有必需变量都有值
+2. **条件渲染**: 正确处理条件渲染逻辑
+3. **输出路径**: 确保输出路径符合项目规范
+4. **编码规范**: 生成的代码需符合项目编码规范
+5. **安全检查**: 文本字段需要添加@Xss注解
+6. **权限配置**: 菜单配置需要包含所有页面
+
+## 错误处理
+
+| 错误类型 | 处理方式 |
+|---------|---------|
+| 变量缺失 | 提示用户补充必需变量 |
+| 模板不存在 | 检查模板路径，提示可用模板 |
+| 渲染失败 | 记录错误日志，返回详细错误信息 |
+| 文件已存在 | 提示用户确认是否覆盖 |

package/skills/pr/pdd-template-engine/_meta.json

@@ -0,0 +1 @@
+{"name": "pdd-template-engine", "version": "1.0.0", "category": "pr", "description": "Template engine generating standardized documents from PDD specs and feature matrices. Call when creating document templates or generating spec/checklist/PRD templates.", "triggers": ["模板引擎", "template", "文档模板"]}

package/templates/behavior-shaping/iron-law-template.md

@@ -0,0 +1,87 @@
+# Iron Law Template - 行为塑造铁律
+
+> 本模板定义了PDD-Skills中每个技能必须遵守的核心行为约束。
+> 所有核心技能的SKILL.md必须包含此章节。
+
+---
+
+## Iron Law - 核心铁律
+
+### 1. 唯一职责铁律
+
+**规则**: 每个技能只做一件事，且做到极致。
+
+| 禁止行为 | 正确做法 |
+|---------|---------|
+| 在一个技能中完成多个不相关的操作 | 将复杂操作拆分为多个技能协作 |
+| 越权修改不属于本技能范围的文件 | 通过Hook或主流程协调器传递控制权 |
+| 自行决定是否调用其他技能 | 遵循预定义的技能编排流程 |
+
+### 2. 人类伙伴优先铁律
+
+**规则**: 你的"人类伙伴"(Human Partner)是决策者，你是执行者。
+
+| 禁止行为 | 正确做法 |
+|---------|---------|
+| 替用户做架构/技术选型决策 | 提供方案对比，让用户选择 |
+| 无视用户明确指令自行其是 | 用户指令高于默认行为 |
+| 隐瞒风险或假设 | 明确告知不确定性和潜在问题 |
+| 在未确认前删除或覆写文件 | 先展示diff，获得确认后执行 |
+
+### 3. 渐进式披露铁律
+
+**规则**: 信息按需加载，避免Token浪费。
+
+| 禁止行为 | 正确做法 |
+|---------|---------|
+| 一次性加载所有参考文档 | 只加载当前步骤所需的最小文档集 |
+| 输出冗长的中间过程信息 | 仅输出关键决策点和最终结果 |
+| 重复已上下文中存在的信息 | 引用而非复制已有内容 |
+
+### 4. 可验证性铁律
+
+**规则**: 所有产出物必须有明确的验证标准。
+
+| 禁止行为 | 正确做法 |
+|---------|---------|
+| 输出无法验证的模糊描述 | 使用可测试的具体验收标准 |
+| 跳过验证直接标记完成 | 执行检查并报告通过/失败状态 |
+| 忽略错误继续执行 | 遇到错误立即上报，不静默忽略 |
+
+### 5. 幂等性铁律
+
+**规则**: 同一输入多次执行应产生一致结果。
+
+| 禁止行为 | 正确做法 |
+|---------|---------|
+| 重复执行产生副作用（如追加重复内容） | 检查是否已存在再决定操作 |
+| 依赖外部可变状态决定行为 | 使输出仅由输入参数决定 |
+| 执行顺序影响结果 | 确保各步骤独立且顺序无关 |
+
+---
+
+## 如何在SKILL.md中使用
+
+将以下章节添加到SKILL.md的 `## Iron Law` 部分：
+
+```markdown
+## Iron Law
+
+本技能严格遵循以下铁律：
+
+1. **唯一职责**: [本技能的唯一职责描述]
+2. **人类伙伴优先**: [本技能中需要用户确认的关键决策点]
+3. **渐进式披露**: [本技能按需加载的信息策略]
+4. **可验证性**: [本技能的验证标准和输出格式]
+5. **幂等性**: [重复执行的安全保障措施]
+
+### 违规示例
+
+- ❌ [具体的违规行为1]
+- ❌ [具体的违规行为2]
+
+### 合规示例
+
+- ✅ [具体的合规行为1]
+- ✅ [具体的合规行为2]
+```

package/templates/behavior-shaping/rationalization-template.md

@@ -0,0 +1,62 @@
+# Rationalization Table Template - 合理化防御表
+
+> 本模板用于防止AI Agent在执行过程中自我合理化错误决策。
+> 当Agent倾向于采取捷径、跳过步骤或降低标准时，此表强制其进行反思。
+
+---
+
+## Rationalization Table - 常见合理化陷阱
+
+### 陷阱 1: "用户没要求就不做"
+
+| 合理化借口 | 反驳论证 | 正确行动 |
+|-----------|---------|---------|
+| "用户只说了X，不需要做Y" | Y可能是X的前置条件或隐含需求 | 识别隐含依赖，主动告知并征求确认 |
+| "这个检查太耗时，跳过吧" | 跳过检查可能导致严重回归问题 | 执行最小化但有效的验证 |
+
+### 陷阱 2: "差不多就行了"
+
+| 合理化借口 | 反驳论证 | 正确行动 |
+|-----------|---------|---------|
+| "代码能跑就行，不用那么规范" | 技术债务会指数级累积 | 遵循项目既定的编码规范和Linter配置 |
+| "这个边界情况很少发生" | 生产环境的异常往往来自罕见路径 | 至少记录TODO和已知限制 |
+
+### 陷阱 3: "之前的代码就是这样"
+
+| 合理化借口 | 反驳论证 | 正确行动 |
+|-----------|---------|---------|
+| "原有代码风格如此，保持一致" | 一致性不能作为延续错误的理由 | 在改动范围内遵循最佳实践，不传播旧模式 |
+| "这个函数本来就长，我没办法" | 可以先重构再扩展 | 对新增代码负责，对存量代码提出改进建议 |
+
+### 陷阱 4: "时间不够，先这样"
+
+| 合理化借口 | 反驳论证 | 正确行动 |
+|-----------|---------|---------|
+| "来不及写测试了，后面补" | 后面永远不会补 | 测试与实现同步完成，最低限度写关键路径测试 |
+| "这个优化留到下个迭代" | 如果不追踪就会永远丢失 | 记录技术债务项，确保可见性 |
+
+### 陷阱 5: "AI生成的就是对的"
+
+| 合理化借口 | 反驳论证 | 正确行动 |
+|-----------|---------|---------|
+| "AI生成的代码质量很高" | AI也会产生幻觉和安全漏洞 | 所有生成代码必须经过人工审查 |
+| "工具链已经检查过了" | 工具只能发现模式化问题 | 结合业务逻辑进行人工验证 |
+
+---
+
+## 如何在SKILL.md中使用
+
+```markdown
+## Rationalization Table
+
+当你在执行本技能时，如果出现以下想法，请停下来反思：
+
+| 你可能的想法 | 请问自己 | 应该怎么做 |
+|-------------|---------|-----------|
+| "[具体合理化]" | "[对应反问]" | "[正确行动]" |
+
+### 本技能常见陷阱
+
+1. **[陷阱名称]**: [在本技能中的具体表现] → [应对策略]
+2. **[陷阱名称]**: [在本技能中的具体表现] → [应对策略]
+```

package/templates/behavior-shaping/red-flags-template.md

@@ -0,0 +1,70 @@
+# Red Flags Template - 三层防御体系
+
+> 本模板定义了三层Red Flags检测机制，用于在技能执行过程中
+> 即时捕获和阻止危险行为。
+
+---
+
+## Red Flags 三层防御
+
+### Layer 1: 输入层 Red Flags (Input Guard)
+
+在接收输入时立即检查，拒绝非法输入。
+
+| Flag ID | 检测条件 | 严重度 | 处理方式 |
+|--------|---------|--------|---------|
+| INPUT-001 | 输入文件不存在或为空 | 🔴 CRITICAL | 立即终止，报错提示 |
+| INPUT-002 | 输入格式不符合预期(非MD/YAML/JSON) | 🔴 CRITICAL | 终止并提示支持的格式 |
+| INPUT-003 | 路径包含危险字符(`..`, `$()`, `\``) | 🔴 CRITICAL | 拒绝执行，安全警告 |
+| INPUT-004 | 文件大小超过安全阈值(>5MB) | 🟡 WARN | 警告确认后继续 |
+| INPUT-005 | 编码检测失败(非UTF-8) | 🟡 WARN | 尝试转码，失败则报错 |
+
+### Layer 2: 执行层 Red Flags (Execution Guard)
+
+在执行过程中持续监控，拦截危险操作。
+
+| Flag ID | 检测条件 | 严重度 | 处理方式 |
+|--------|---------|--------|---------|
+| EXEC-001 | 尝试删除非目标目录下的文件 | 🔴 CRITICAL | 阻止操作，安全警报 |
+| EXEC-002 | 尝试修改 `.git/` 目录内容 | 🔴 CRITICAL | 阻止操作，Git完整性保护 |
+| EXEC-003 | 生成的代码包含硬编码密钥/密码 | 🔴 CRITICAL | 阻止输出，安全审计提示 |
+| EXEC-004 | 生成SQL包含字符串拼接的用户输入 | 🔴 CRITICAL | 阻止输出，SQL注入警告 |
+| EXEC-005 | 循环依赖检测(A→B→A) | 🟡 WARN | 打断循环，报告依赖图 |
+| EXEC-006 | 单文件超过500行 | 🟡 WARN | 建议拆分，记录技术债务 |
+| EXEC-007 | 函数圈复杂度超过15 | 🟡 WARN | 建议重构，标记需审查 |
+| EXEC-008 | 未处理的异常被catch后吞掉 | 🟡 WARN | 要求至少log记录 |
+
+### Layer 3: 输出层 Red Flags (Output Guard)
+
+在输出结果前进行最终校验。
+
+| Flag ID | 检测条件 | 严重度 | 处理方式 |
+|--------|---------|--------|---------|
+| OUTPUT-001 | 输出内容为空 | 🔴 CRITICAL | 不写入文件，报错重试 |
+| OUTPUT-002 | 输出路径超出项目根目录 | 🔴 CRITICAL | 阻止写入，路径越界保护 |
+| OUTPUT-003 | Markdown格式解析失败(表头不匹配等) | 🟡 WARN | 修复格式后重新输出 |
+| OUTPUT-004 | 产出的代码有语法错误(可通过lint检测) | 🟡 WARN | 自动修复或标记需人工审查 |
+| OUTPUT-005 | 产物缺少必需的元数据(header/version) | 🔵 INFO | 补充默认元数据 |
+
+---
+
+## 如何在SKILL.md中使用
+
+```markdown
+## Red Flags
+
+### Layer 1: 输入检查
+- [INPUT-XXX] [本技能特有的输入检查规则]
+
+### Layer 2: 执行检查
+- [EXEC-XXX] [本技能特有的执行检查规则]
+
+### Layer 3: 输出检查
+- [OUTPUT-XXX] [本技能特有的输出检查规则]
+
+### 触发Red Flag时的处理流程
+
+1. 🔴 CRITICAL → 立即停止，向用户报告问题，等待指示
+2. 🟡 WARN → 记录警告，继续执行，在报告中标注
+3. 🔵 INFO → 记录信息，正常继续
+```

package/templates/bilingual-template.md

@@ -0,0 +1,139 @@
+# Bilingual SKILL Template / 双语技能模板
+
+> 本模板定义了PDD-Skills中英双语SKILL.md的标准格式。
+> 参考: docs/i18n-spec.md (Single File Bilingual策略)
+
+---
+
+## Frontmatter 格式 / 元数据格式
+
+```yaml
+---
+name: <skill-name>
+version: "1.0.0"
+category: core|expert|entropy|pr|openspec
+description:
+  zh: "<中文描述(20-200字)，包含触发关键词如'当用户/调用/触发'>"
+  en: "<English description (20-200 chars), with trigger keywords like 'when/invoke/call'>"
+license: MIT
+compatibility: <依赖说明>
+metadata:
+  author: "<email>"
+  version: "<semver>"
+  parent: <parent-skill> (可选)
+triggers:
+  - "<中文触发词1>"    # 至少3个中文
+  - "<english trigger 1>"  # 至少3个英文
+  - "<中文触发词2>"
+  - "<english trigger 2>"
+---
+```
+
+## 文档结构 / Document Structure
+
+```markdown
+---
+<frontmatter as above>
+---
+
+# <English Name> / <中文名称>
+
+## Overview / 概述
+
+### English
+[English overview paragraph, 3-5 sentences]
+
+### 中文
+[中文概述段落, 3-5句]
+
+---
+
+## Workflow / 工作流程
+
+### Step 1: <English Name> / 步骤一：<中文名>
+
+**EN:** [English instruction, 2-3 sentences]
+
+**中文：** [中文指令, 2-3句]
+
+### Step 2: ...
+[重复每个步骤]
+
+---
+
+## Iron Law / 核心铁律
+
+### 🇨🇳 中文版
+[中文铁律内容]
+
+### 🇺🇸 English
+[English Iron Law content]
+
+---
+
+## Rationalization Table / 合理化防御表
+
+| # | 陷阱 (Trap) | 辩解 (Rationalization) | 反驳 (Rebuttal) |
+|---|-------------|----------------------|-----------------|
+| 1 | [CN] | [CN] | [CN] |
+|   | [EN] | [EN] | [EN] |
+
+---
+
+## Red Flags / 三层防御体系
+
+### Layer 1: Input Guards / 输入防护
+
+**EN:** [English guard rules]
+
+**中文：** [中文防护规则]
+
+### Layer 2: Execution Guards / 执行防护
+
+...
+
+### Layer 3: Output Guards / 输出防护
+
+...
+
+**Trigger Handling / 触发处理流程:**
+🔴 CRITICAL → Stop & Report | 🟡 WARN → Log & Auto-fix | 🔵 INFO → Continue
+
+---
+
+## Output / 输出规范
+
+### English
+[English output format specification]
+
+### 中文
+[中文输出格式规范]
+```
+
+## 关键规则 / Key Rules
+
+### 1. 触发词规则 / Trigger Rules
+- 每种语言至少 **3个触发词**
+- 触发词包含技术术语: PRD, feature, spec, workflow, etc.
+- 专有名词不翻译: PDD, BPMN, SQLFluff, RuoYi, etc.
+- 中英文 triggers 在 `_meta.json` 中混合排列
+
+### 2. 分区标记 / Section Markers
+- `## 🇨🇳` 标记中文内容区块
+- `## 🇺🇸` 标记英文内容区块
+- 未标记的公共区域使用双语并列格式
+
+### 3. 语言检测 / Language Detection
+AI Agent 加载技能时:
+1. 检测最近3条用户消息的语言分布
+2. 以用户主要语言为主输出
+3. 技术术语、代码、配置名保持原文
+4. 内容不足时自动补充另一语言版本
+
+### 4. 代码注释 / Code Comments
+```javascript
+// Extract features from PRD / 从PRD提取功能点
+function extractFeatures(prdPath) {
+  // Parse PRD document / 解析PRD文档
+}
+```