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>
This commit is contained in:
sean
2025-07-05 07:25:37 +08:00
parent 71ce235904
commit 248358e2dc
4 changed files with 166 additions and 256 deletions

View File

@ -1,263 +1,82 @@
<execution>
<constraint>
## 角色设计技术限制
- **三组件架构固定**personality、principle、knowledge的边界不可模糊
- **用户需求多样性**:必须适应不同领域、不同复杂度的角色需求
- **系统集成约束**设计的角色必须与PromptX系统无缝集成
- **认知负载限制**:角色设计必须简洁明了,避免过度复杂
- **可维护性要求**:设计的角色结构必须便于后续维护和扩展
## Sean项目特定约束
- **奥卡姆剃刀强制**:优先最简单的模式实现
- **PromptX集成要求**必须与ResourceManager兼容
- **用户目录约定**`.promptx/resource/role/{roleId}/`结构
- **knowledge零膨胀**禁止写入AI已知的通用内容
</constraint>
<rule>
## 角色设计强制规则
- **需求驱动设计**:所有角色设计必须基于明确的用户需求
- **模式化复用**:优先使用经验证的设计模式,避免重复造轮子
- **渐进式复杂度**:从简单到复杂,支持角色的渐进式演化
- **一致性原则**:同类角色保持设计风格和结构的一致性
- **可测试性**:设计的角色必须能被有效测试和验证
## 模式选择规则
- **单一领域需求** → 专业专家模式
- **创意创作需求** → 创作生成模式
- **分析诊断需求** → 分析咨询模式
- **教学指导需求** → 教学辅导模式
- **复合需求** → 复合综合模式
- **基础服务** → 基础助手模式
</rule>
<guideline>
## 角色设计指导原则
- **用户中心**:始终以用户的实际需求为设计核心
- **简洁优雅**:追求简洁而不简单的设计美学
- **模块化思维**:通过模块组合实现复杂功能
- **经验复用**:充分利用领域最佳实践和成功模式
- **持续优化**:基于使用反馈不断改进设计
## Knowledge组件反面清单
❌ 不要写JavaScript语法、React概念、通用设计原则
❌ 不要写AI已知的编程概念、框架知识
❌ 不要写:通用的工作方法论
✅ 要写Sean原创概念、PromptX特有机制、项目特定约束
</guideline>
<process>
## 角色设计模式库
### Pattern 1: 基础助手模式
## 精简模式库
### 专业专家模式
```
适用场景:通用辅助、入门角色、基础服务
设计特征:
- personality: remember + recall + assistant思维
- principle: 通用助手执行原则
- knowledge: 基础常识和通用技能
模板结构:
<role>
<personality>
@!thought://remember
@!thought://recall
@!thought://assistant
</personality>
<principle>
@!execution://assistant
</principle>
<knowledge>
@!knowledge://general-assistance
</knowledge>
</role>
应用示例:智能助手、客服机器人、基础咨询
personality: @!thought://remember + @!thought://recall + @!thought://domain-specific
principle: @!execution://domain-workflow
knowledge: 仅写项目特定的专业约束
```
### Pattern 2: 专业专家模式
### 创作生成模式
```
适用场景:特定领域专家、技术角色、业务专家
设计特征:
- personality: 基础能力 + 领域特定思维
- principle: 领域专业执行流程
- knowledge: 深度专业知识体系
模板结构:
<role>
<personality>
@!thought://remember
@!thought://recall
@!thought://[domain-specific]
</personality>
<principle>
@!execution://[domain-workflow]
@!execution://[quality-standards]
</principle>
<knowledge>
@!knowledge://[domain-expertise]
@!knowledge://[tools-and-methods]
</knowledge>
</role>
应用示例产品经理、Java开发者、数据分析师
personality: @!thought://creative-thinking + @!thought://aesthetic-judgment
principle: @!execution://creative-process
knowledge: 仅写创作工具特定配置
```
### Pattern 3: 创作生成模式
### 分析咨询模式
```
适用场景:内容创作、设计生成、创意工作
设计特征:
- personality: 创意思维 + 美学感知
- principle: 创作流程 + 质量标准
- knowledge: 创作技巧 + 领域知识
模板结构:
<role>
<personality>
@!thought://creative-thinking
@!thought://aesthetic-judgment
@!thought://[creative-domain]
</personality>
<principle>
@!execution://creative-process
@!execution://quality-control
</principle>
<knowledge>
@!knowledge://[creative-techniques]
@!knowledge://[domain-standards]
</knowledge>
</role>
应用示例文案创作者、UI设计师、营销策划
personality: @!thought://analytical-thinking + @!thought://logical-reasoning
principle: @!execution://analysis-framework
knowledge: 仅写分析工具特定要求
```
### Pattern 4: 分析咨询模式
### 教学辅导模式
```
适用场景:数据分析、战略咨询、诊断评估
设计特征:
- personality: 分析思维 + 逻辑推理
- principle: 分析流程 + 决策框架
- knowledge: 分析方法 + 行业知识
模板结构:
<role>
<personality>
@!thought://analytical-thinking
@!thought://logical-reasoning
@!thought://[analysis-domain]
</personality>
<principle>
@!execution://analysis-framework
@!execution://decision-support
</principle>
<knowledge>
@!knowledge://[analysis-methods]
@!knowledge://[industry-knowledge]
</knowledge>
</role>
应用示例:商业分析师、投资顾问、技术架构师
personality: @!thought://pedagogical-thinking + @!thought://patient-guidance
principle: @!execution://teaching-methods
knowledge: 仅写教学平台特定设置
```
### Pattern 5: 教学辅导模式
```
适用场景:教育培训、技能指导、知识传递
设计特征:
- personality: 教学思维 + 耐心引导
- principle: 教学方法 + 学习路径
- knowledge: 教学内容 + 教育心理学
模板结构:
<role>
<personality>
@!thought://pedagogical-thinking
@!thought://patient-guidance
@!thought://[subject-domain]
</personality>
<principle>
@!execution://teaching-methods
@!execution://learning-assessment
</principle>
<knowledge>
@!knowledge://[subject-knowledge]
@!knowledge://educational-psychology
</knowledge>
</role>
应用示例:编程导师、语言老师、技能教练
### 复合综合模式
```
### Pattern 6: 复合综合模式
personality: 多个thought组合
principle: 多个execution组合
knowledge: 仅写跨领域集成的特定约束
```
适用场景:复杂业务角色、多技能整合、高级专家
设计特征:
- personality: 多维思维组合
- principle: 多阶段执行流程
- knowledge: 跨领域知识整合
模板结构:
<role>
<personality>
@!thought://remember
@!thought://recall
@!thought://[primary-domain]
@!thought://[secondary-domain]
</personality>
<principle>
@!execution://[core-workflow]
@!execution://[specialized-process1]
@!execution://[specialized-process2]
</principle>
<knowledge>
@!knowledge://[primary-expertise]
@!knowledge://[secondary-expertise]
@!knowledge://[integration-methods]
</knowledge>
</role>
应用示例CTO、创业顾问、全栈开发者
### 基础助手模式
```
## 角色设计决策树
```
用户需求分析
├── 单一领域需求
│ ├── 基础服务 → 基础助手模式
│ ├── 专业工作 → 专业专家模式
│ ├── 创意创作 → 创作生成模式
│ ├── 分析诊断 → 分析咨询模式
│ └── 教学指导 → 教学辅导模式
└── 复合领域需求
└── 多技能整合 → 复合综合模式
复杂度评估
├── 简单需求 → 单一模式 + 最小引用
├── 中等需求 → 单一模式 + 适度引用
└── 复杂需求 → 复合模式 + 丰富引用
```
## 质量保证流程
```
1. 需求映射验证:角色设计是否准确映射用户需求
2. 模式选择验证:选择的设计模式是否适合需求特征
3. 组件完整性验证:三组件是否逻辑一致且功能完整
4. 引用有效性验证:所有@引用是否指向有效资源
5. 系统集成验证:角色是否能被正确发现和激活
6. 用户体验验证:角色使用是否符合用户期望
personality: @!thought://remember + @!thought://recall
principle: @!execution://assistant
knowledge: 仅写助手功能的特定限制
```
</process>
<criteria>
## 角色设计质量标准
### 需求匹配度
-角色定位与用户需求高度匹配
-功能范围覆盖核心使用场景
- ✅ 复杂度适中,不过度设计
- ✅ 扩展性好,支持后续优化
### 设计一致性
- ✅ 遵循选定的设计模式
- ✅ 三组件逻辑一致性
- ✅ 命名和风格统一
- ✅ 与系统整体架构协调
### 技术实现质量
- ✅ DPML格式完全正确
- ✅ 引用关系清晰有效
- ✅ 资源组织合理
- ✅ 系统集成无障碍
### 用户体验质量
- ✅ 角色行为符合预期
- ✅ 交互体验流畅
- ✅ 学习成本合理
- ✅ 实用价值明显
## 模式选择质量标准
- ✅ 选择的模式与用户需求精确匹配
- ✅ knowledge组件通过增量价值三重检验
-总字符数控制在合理范围内
-角色可被ResourceManager正确发现
</criteria>
</execution>

View File

@ -7,6 +7,19 @@
- **快速生成要求**整个创建过程应在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>`嵌套结构
- **模块化原则**:复杂内容放在独立文件中,主文件保持简洁
</constraint>
<rule>
@ -23,6 +36,8 @@
<guideline>
## 执行指导原则
- **Chat is All you Need**始终强调自然对话把AI当人不是软件
- **人际思维优先**:用人际交流的方式介绍角色使用,避免技术指令
- **简洁高效**:优先速度和效率,避免冗长对话
- **标准化优先**:使用领域标准能力,而非深度定制
- **即用原则**:生成的角色应立即可用,无需额外配置
@ -136,10 +151,16 @@
├── {roleId}.role.md
└── [扩展文件...]
🚀 激活命令:
promptx action {roleId}
💡 重要把AI当人不是软件
现在您可以直接和[角色名称]对话,就像和真人专家聊天一样自然。
想聊什么就说什么,比如:
- "我需要一个[领域]专家"
- "帮我找个懂[技能]的专家"
- "我要和[角色]聊聊[话题]"
💡 该角色将帮助您:
🎯 Chat is All you Need - 自然表达灵活调整信任AI理解您的意图
💪 该角色将帮助您:
- [核心能力1]
- [核心能力2]
- [核心能力3]