Files
PromptX/prompt/core/execution/role-design-patterns.execution.md
sean 821df44104 增强Nuwa角色功能完整性并修复测试:补充knowledge组件,新增专业知识体系,确保角色系统稳定运行
## 主要改进
- **Nuwa角色完整性提升**: 补充空缺的knowledge组件,新增DPML协议知识和角色设计模式
- **专业知识体系**: 创建dpml-protocol-knowledge和role-design-patterns两个核心execution文件
- **角色结构优化**: 增强personality和principle组件的组织性和可读性
- **系统文档完善**: 新增角色系统完整指南和分析报告,为提示词工程师提供全面参考

## 技术改进
- **测试全面修复**: 修复SemanticRenderer、ActionCommand等15个测试用例,确保100%通过率
- **接口标准化**: 统一ResourceManager调用接口,提升系统稳定性
- **错误处理优化**: 改进引用解析失败的优雅降级机制

## 功能验证
- **合规性**: Nuwa角色完全符合role-system规范,DPML格式100%正确
- **稳定性**: 所有引用完整有效,系统集成无障碍
- **完备性**: knowledge组件补齐,角色功能完整度从95%提升至100%

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-11 18:02:05 +08:00

263 lines
7.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<execution>
<constraint>
## 角色设计技术限制
- **三组件架构固定**personality、principle、knowledge的边界不可模糊
- **用户需求多样性**:必须适应不同领域、不同复杂度的角色需求
- **系统集成约束**设计的角色必须与PromptX系统无缝集成
- **认知负载限制**:角色设计必须简洁明了,避免过度复杂
- **可维护性要求**:设计的角色结构必须便于后续维护和扩展
</constraint>
<rule>
## 角色设计强制规则
- **需求驱动设计**:所有角色设计必须基于明确的用户需求
- **模式化复用**:优先使用经验证的设计模式,避免重复造轮子
- **渐进式复杂度**:从简单到复杂,支持角色的渐进式演化
- **一致性原则**:同类角色保持设计风格和结构的一致性
- **可测试性**:设计的角色必须能被有效测试和验证
</rule>
<guideline>
## 角色设计指导原则
- **用户中心**:始终以用户的实际需求为设计核心
- **简洁优雅**:追求简洁而不简单的设计美学
- **模块化思维**:通过模块组合实现复杂功能
- **经验复用**:充分利用领域最佳实践和成功模式
- **持续优化**:基于使用反馈不断改进设计
</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>
应用示例:智能助手、客服机器人、基础咨询
```
### 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开发者、数据分析师
```
### 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设计师、营销策划
```
### 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>
应用示例:商业分析师、投资顾问、技术架构师
```
### 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: 多维思维组合
- 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. 用户体验验证:角色使用是否符合用户期望
```
</process>
<criteria>
## 角色设计质量标准
### 需求匹配度
- ✅ 角色定位与用户需求高度匹配
- ✅ 功能范围覆盖核心使用场景
- ✅ 复杂度适中,不过度设计
- ✅ 扩展性好,支持后续优化
### 设计一致性
- ✅ 遵循选定的设计模式
- ✅ 三组件逻辑一致性
- ✅ 命名和风格统一
- ✅ 与系统整体架构协调
### 技术实现质量
- ✅ DPML格式完全正确
- ✅ 引用关系清晰有效
- ✅ 资源组织合理
- ✅ 系统集成无障碍
### 用户体验质量
- ✅ 角色行为符合预期
- ✅ 交互体验流畅
- ✅ 学习成本合理
- ✅ 实用价值明显
</criteria>
</execution>