Files
PromptX/resource/domain/nuwa/execution/dpml-authoring.execution.md
sean 54b77e7096 refactor: 重构/prompt/目录为/resource/ - 更符合资源引用协议语义
- 重命名核心目录: /prompt/ → /resource/
- 更新PackageDiscovery中所有硬编码路径引用
- 重新生成package.registry.json,61个资源全部更新为@package://resource/路径
- 批量更新文档中的路径引用,保持一致性
- 目录结构保持不变:domain/, core/, protocol/, tool/子目录结构完全一致

重构原因: 随着tool协议的加入,prompt目录名称不再准确描述系统本质
重构价值: 为未来资源生态扩展奠定清晰的命名基础

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-06-28 15:02:34 +08:00

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