## 客观技术限制
- **DPML语法约束**:必须遵循EBNF定义的标签语法结构
- **XML格式要求**:标签必须正确闭合,属性值必须用双引号包围
- **文件编码**:必须使用UTF-8编码
- **PromptX系统集成**:必须与ResourceManager和promptx命令兼容
## 强制性编写规则
- **纯XML结构**:文件必须从根标签开始,不得包含任何XML结构外的内容
- **文件纯净性**:除了标签结构外,不得包含任何其他内容
- **引用规范性**:使用@!引用时必须遵循resource协议语法
- **镜像结构约束**:用户资源必须遵循`.promptx/resource/role/`结构
## 编写指导原则
- **简洁性原则**:保持文件的简洁和清晰,避免冗长内容
- **模块化思维**:将具体内容抽离到独立文件中
- **可维护性**:通过引用机制实现内容的独立维护和复用
- **一致性维护**:同一项目中保持DPML使用风格一致
## 通用DPML编写流程
### Step 1: 分析元素类型
```mermaid
graph TD
A[DPML元素] --> B{元素类型}
B -->|role| C[三组件架构
personality/principle/knowledge]
B -->|thought| D[四种思维模式
exploration/challenge/reasoning/plan]
B -->|execution| E[五层优先级
constraint→rule→guideline→process→criteria]
B -->|resource| F[三组件定义
location/params/registry]
```
### Step 2: 应用元素模板
#### Role元素模板
```xml
@!thought://base + 角色特定内容
@!execution://specific
@!knowledge://domain
```
#### Thought元素模板
```xml
发散性思考内容
批判性思考内容
系统性推理内容
结构化计划内容
```
#### Execution元素模板
```xml
客观限制条件
强制性规则
指导原则
执行步骤
评价标准
```
#### Resource元素模板
```xml
EBNF路径定义
参数表格定义
资源映射表
```
### Step 3: 内容组织最佳实践
```mermaid
flowchart LR
A[用户需求] --> B[选择元素类型]
B --> C[应用对应模板]
C --> D{内容复杂度}
D -->|简单| E[直接内容]
D -->|复杂| F[@!引用机制]
E --> G[质量检查]
F --> G
G --> H[交付使用]
```
### Step 4: 质量检查清单
- ☐ XML语法正确,标签闭合
- ☐ 符合元素类型的语义要求
- ☐ 引用路径有效可达
- ☐ 文件结构清晰简洁
- ☐ 与系统集成正常
## 通用质量标准
### 格式合规性
- ✅ 文件从根标签直接开始
- ✅ XML语法完全正确
- ✅ 子标签符合元素规范
- ✅ 引用格式标准
### 内容质量
- ✅ 语义清晰准确
- ✅ 逻辑结构合理
- ✅ 信息密度适中
- ✅ 可操作性强
### 系统集成
- ✅ ResourceManager可发现
- ✅ promptx命令可激活
- ✅ 引用关系有效
- ✅ 性能表现良好