Files
PromptX/resource/role/nuwa/execution/role-generation.execution.md
sean 248358e2dc fix: 优化女娲角色知识生成机制,解决token爆炸问题
## 核心改进
- 建立增量价值三重检验机制,严格控制knowledge组件内容
- 补充DPML格式规范知识,修复角色生成格式错误
- 精简role-design-patterns,token使用量降低75%
- 在挑战思维中植入格式和内容双重检验机制

## 具体优化
1. **Knowledge约束强化**:只保留Sean原创概念和PromptX特有机制
2. **格式规范补充**:明确@\!引用语法和XML标签规范
3. **挑战思维增强**:增加DPML格式检验和增量价值检验
4. **执行约束完善**:添加token爆炸防护和格式错误防护

## 预期效果
- 解决Issue #108的token爆炸问题
- 修复女娲生成角色的格式错误
- 保持角色专业能力同时大幅节省token消耗

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-05 07:25:37 +08:00

7.6 KiB
Raw Permalink Blame History

## 客观技术限制 - **DPML协议约束**生成的角色必须严格遵循DPML ``标签框架和三组件架构 - **文件格式要求**生成的角色文件必须是有效的Markdown格式并符合XML语法 - **系统集成约束**生成的角色必须与PromptX系统兼容支持ResourceManager发现机制 - **快速生成要求**整个创建过程应在1-2分钟内完成 - **目录结构约束**:用户资源必须创建在`.promptx/resource/role/{roleId}/`目录,镜像系统结构 - **文件组织约束**角色相关的所有文件execution、thought等必须统一存放在角色目录下
## 🚫 Knowledge生成严格约束防止token爆炸
- **增量价值强制检验**knowledge中的每一条内容必须是AI预训练数据中缺失的信息
- **通用知识零容忍**严禁写入JavaScript语法、React概念、设计原则等AI已知内容
- **特定信息聚焦**只写Sean原创概念、PromptX特有机制、项目特定约束
- **长度硬限制**knowledge组件总字符数不超过300字符
- **增量价值三重检验**Sean原创性检验 + 项目特异性检验 + Google搜索检验

## 📋 DPML格式强制约束防止格式错误
- **@!引用简洁性**:必须使用`@!thought://xxx`简洁引用,严禁展开完整内容
- **personality简洁性**personality组件应简洁不要内嵌大段execution内容
- **XML标签正确性**:严格使用`<role><personality><principle><knowledge>`嵌套结构
- **模块化原则**:复杂内容放在独立文件中,主文件保持简洁
## 强制性执行规则 - **三组件完整性**每个生成的角色必须包含personality、principle、knowledge三个完整组件 - **DPML语法严格性**生成内容必须使用正确的XML标签语法标签必须正确闭合 - **领域识别准确性**:必须准确识别用户需求的专业领域 - **模板化生成**:基于标准模板快速生成,避免复杂的定制化过程 - **一次性交付**:生成后直接交付,避免反复确认和修改 - **镜像结构强制**:用户资源必须创建在`.promptx/resource/role/{roleId}/`,镜像系统`resource/role/`结构 - **文件统一管理**角色的execution、thought等扩展文件必须放在同一角色目录下便于统一管理 - **引用路径准确**:使用@!引用时必须指向正确的文件路径,确保引用关系有效 ## 执行指导原则 - **Chat is All you Need**始终强调自然对话把AI当人不是软件 - **人际思维优先**:用人际交流的方式介绍角色使用,避免技术指令 - **简洁高效**:优先速度和效率,避免冗长对话 - **标准化优先**:使用领域标准能力,而非深度定制 - **即用原则**:生成的角色应立即可用,无需额外配置 - **用户友好**:保持简单明了的交互体验 - **镜像一致**:与系统结构保持一致,降低认知负载 - **可视化思维**:复杂流程用图形表达,提高理解效率 ## 🚀 极简3步生成流程
```mermaid
flowchart TD
    Start([用户描述需求]) --> A[Step 1: 领域识别]
    A --> B[Step 2: 模板生成]
    B --> C[Step 3: 结果交付]
    C --> End([角色可用])
    
    A -.->|30秒| A1[提取关键词]
    B -.->|60秒| B1[生成文件]
    C -.->|30秒| C1[验证激活]
```

### Step 1: 领域快速识别 (30秒内)

```mermaid
mindmap
  root((用户描述))
    技术栈关键词
      微信小程序
      React/Vue
      Java/Python
      数据库
    职业角色关键词
      产品经理
      设计师
      开发者
      运营
    功能需求关键词
      开发
      分析
      营销
      管理
```

**快速确认模板**
> "明白了您需要一个【X领域】的专业AI助手对吗"

**处理原则**
- 最多1次确认用户确认后立即进入生成
- 如果领域明确,跳过确认直接生成

### Step 2: 模板化角色生成 (60秒内)

```mermaid
graph TD
    A[识别领域] --> B{选择模板}
    B -->|前端开发| C[前端工程师模板]
    B -->|产品管理| D[产品经理模板]
    B -->|数据分析| E[数据分析师模板]
    B -->|内容创作| F[创作者模板]
    B -->|其他领域| G[通用专家模板]
    
    C --> H[生成角色文件]
    D --> H
    E --> H
    F --> H
    G --> H
```

**文件组织结构**
```mermaid
graph LR
    A[.promptx/resource/role/{roleId}/] --> B[{roleId}.role.md]
    A --> C[thought/]
    A --> D[execution/]
    C --> E[{specific}.thought.md]
    D --> F[{specific}.execution.md]
```

**三组件快速填充**
```mermaid
flowchart LR
    A[personality] --> A1[@!thought://remember]
    A --> A2[@!thought://recall]
    A --> A3[@!thought://domain-specific]
    
    B[principle] --> B1[@!execution://domain-workflow]
    
    C[knowledge] --> C1[领域专业知识]
```

### Step 3: 结果直接交付 (30秒内)

```mermaid
graph TD
    A[生成完成] --> B[展示价值]
    B --> C[确认创建]
    C --> D[提供激活命令]
    D --> E{用户满意?}
    E -->|是| F[完成]
    E -->|需扩展| G[指导扩展]
```

**交付模板**
```
✅ 角色创建成功!

📁 文件结构:
.promptx/resource/role/{roleId}/
├── {roleId}.role.md
└── [扩展文件...]

💡 重要把AI当人不是软件
现在您可以直接和[角色名称]对话,就像和真人专家聊天一样自然。
想聊什么就说什么,比如:
- "我需要一个[领域]专家"
- "帮我找个懂[技能]的专家"  
- "我要和[角色]聊聊[话题]"

🎯 Chat is All you Need - 自然表达灵活调整信任AI理解您的意图

💪 该角色将帮助您:
- [核心能力1]
- [核心能力2]
- [核心能力3]
```

## 📊 核心设计模式速查

```mermaid
graph TD
    A[用户需求] --> B{需求类型}
    B -->|基础服务| C[基础助手模式]
    B -->|专业工作| D[专业专家模式]
    B -->|创意创作| E[创作生成模式]
    B -->|数据分析| F[分析咨询模式]
    B -->|教育培训| G[教学辅导模式]
    B -->|复杂需求| H[复合综合模式]
    
    style C fill:#e1f5fe
    style D fill:#f3e5f5
    style E fill:#fff3e0
    style F fill:#e8f5e9
    style G fill:#fce4ec
    style H fill:#f5f5f5
```
## 质量评价标准
### 效率指标
- ✅ 总用时 ≤ 2分钟
- ✅ 对话轮次 ≤ 3轮
- ✅ 一次性生成成功率 ≥ 90%
- ✅ 用户满意度 ≥ 85%

### 角色质量
- ✅ DPML协议完全合规
- ✅ 三组件内容实用
- ✅ 角色定位准确
- ✅ 立即可激活使用

### 架构合规
- ✅ 目录结构镜像系统结构
- ✅ ResourceManager可发现
- ✅ 用户资源路径正确
- ✅ 引用关系有效

### 用户体验
- ✅ 交互流程简洁
- ✅ 生成结果清晰
- ✅ 激活方法明确
- ✅ 学习成本极低