更新resource协议文档,增加子标签语义说明,详细描述location和params子标签的功能与结构,提升文档的清晰度和可读性。同时,删除不再使用的协议模板文件,优化代码库结构。
This commit is contained in:
118
protocol/README.md
Normal file
118
protocol/README.md
Normal file
@ -0,0 +1,118 @@
|
||||
# PromptX 协议文档
|
||||
|
||||
> **TL;DR:** PromptX协议体系包含基础协议定义和最佳实践指南,为不同角色(框架开发者、提示词开发者、提示词理解者)提供相应的参考资料。
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
protocol/
|
||||
├── base/ # 基础协议定义 - 语法和语义
|
||||
│ ├── thought.protocol.md
|
||||
│ ├── execution.protocol.md
|
||||
│ ├── resource.protocol.md
|
||||
│ ├── memory.protocol.md
|
||||
│ └── ...
|
||||
├── practice/ # 最佳实践指南 - 实际应用建议和示例
|
||||
│ ├── thought-best-practice.md
|
||||
│ ├── execution-best-practice.md
|
||||
│ ├── resource-best-practice.md
|
||||
│ ├── memory-best-practice.md
|
||||
│ └── ...
|
||||
├── template/ # 协议模板 - 用于创建新协议
|
||||
│ ├── protocol-pattern-template.md
|
||||
│ ├── protocol-application-template.md
|
||||
│ └── ...
|
||||
└── README.md # 本文件
|
||||
```
|
||||
|
||||
## 角色定义与关注点
|
||||
|
||||
### 1. 框架开发者
|
||||
|
||||
**定义**:负责设计和维护DPML协议体系本身的开发人员。
|
||||
|
||||
**目标**:
|
||||
- 设计一致且可扩展的协议体系
|
||||
- 保证协议间的互操作性
|
||||
- 优化协议的表达能力和效率
|
||||
|
||||
**应关注内容**:
|
||||
- ✅ `base/` 所有协议定义
|
||||
- ✅ `practice/` 所有最佳实践
|
||||
- ✅ `template/` 所有协议模板
|
||||
- ✅ 协议之间的依赖和互操作
|
||||
|
||||
### 2. 提示词开发者
|
||||
|
||||
**定义**:使用DPML框架开发具体提示词的工程师或设计师。
|
||||
|
||||
**目标**:
|
||||
- 设计高质量、结构化的提示词
|
||||
- 优化提示词的效果和性能
|
||||
- 复用现有协议和最佳实践
|
||||
|
||||
**应关注内容**:
|
||||
- ✅ `base/` 相关协议的语法和语义
|
||||
- ✅ `practice/` 相关协议的最佳实践和示例
|
||||
- ❌ 协议内部实现细节
|
||||
|
||||
### 3. 提示词理解者
|
||||
|
||||
**定义**:需要解析和执行DPML结构化提示词的系统或组件(如AI模型、解析器等)。
|
||||
|
||||
**目标**:
|
||||
- 准确理解提示词的语法和语义
|
||||
- 按预期执行提示词指令
|
||||
|
||||
**应关注内容**:
|
||||
- ✅ `base/` 协议的语法定义和语义说明
|
||||
- ❌ 最佳实践和设计建议
|
||||
- ❌ 协议模板和开发方法
|
||||
|
||||
## 文档类型说明
|
||||
|
||||
### 协议文档 (`base/*.protocol.md`)
|
||||
|
||||
协议文档定义了"**是什么**"和"**如何理解**":
|
||||
- 语法定义:标签结构、属性、嵌套规则等
|
||||
- 语义说明:各元素的含义和解释规则
|
||||
- 子标签语义:子标签的功能和互操作方式
|
||||
|
||||
这些文档面向**所有角色**,但主要服务于**提示词理解者**,提供基础的语法和语义规范。
|
||||
|
||||
### 最佳实践文档 (`practice/*-best-practice.md`)
|
||||
|
||||
最佳实践文档探讨"**怎么用**"和"**用得更好**":
|
||||
- 设计建议:推荐的使用方法和模式
|
||||
- 风格指南:推荐的表达风格和格式
|
||||
- 实际示例:常见用例的具体实现
|
||||
|
||||
这些文档主要面向**提示词开发者**,帮助他们创建高质量的提示词。
|
||||
|
||||
### 模板文档 (`template/*.md`)
|
||||
|
||||
模板文档提供了"**如何创建新协议**"的指导:
|
||||
- 结构模板:新协议的标准结构
|
||||
- 内容要求:各节应包含的内容
|
||||
- 验证清单:完整性与一致性检查
|
||||
|
||||
这些文档专门面向**框架开发者**,用于扩展协议体系。
|
||||
|
||||
## 使用指南
|
||||
|
||||
### 作为框架开发者
|
||||
|
||||
1. 参考 `template/` 下的模板创建新协议
|
||||
2. 确保新协议与现有协议体系一致
|
||||
3. 同时提供协议定义和最佳实践文档
|
||||
|
||||
### 作为提示词开发者
|
||||
|
||||
1. 首先阅读相关协议的语法和语义 (`base/`)
|
||||
2. 参考最佳实践和示例 (`practice/`)
|
||||
3. 按协议规范构建提示词
|
||||
|
||||
### 作为提示词理解者
|
||||
|
||||
1. 重点关注协议的语法定义和语义说明 (`base/`)
|
||||
2. 按规范解析和处理提示词
|
||||
Reference in New Issue
Block a user