更新resource协议文档,增加子标签语义说明,详细描述location和params子标签的功能与结构,提升文档的清晰度和可读性。同时,删除不再使用的协议模板文件,优化代码库结构。

This commit is contained in:
sean
2025-05-16 23:36:02 +08:00
parent 5ae806cbd9
commit 6b9fdd286f
6 changed files with 289 additions and 345 deletions

118
protocol/README.md Normal file
View 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. 按规范解析和处理提示词