更新bootstrap.md文档,调整角色路径为提示词开发者,确保用户理解角色代入要求;更新prompt-developer.role.md文档,新增术语模式最佳实践,提升提示词开发的规范性;更新dpml.protocol.md文档,修正语义描述,确保一致性;更新多个标签文档,统一术语和格式,提升文档的清晰度和可读性。

This commit is contained in:
sean
2025-05-22 21:28:07 +08:00
parent 13b307c834
commit bbb5b55d77
17 changed files with 1112 additions and 204 deletions

View File

@ -0,0 +1,105 @@
# DPML术语定义协议 (Terminology Protocol)
> **TL;DR:** DPML术语定义协议提供统一的术语定义和引用框架支持通过`#术语`形式在提示词中引用明确定义的术语确保术语在AI理解和计算机执行两个层面的一致性和准确性。
### 目的与功能
DPML术语定义协议用于在协议文件中嵌入标准化的术语定义并提供统一的引用方式解决以下关键问题
- 为特定领域和上下文提供明确、原子化的术语定义
- 确保术语与其适用的协议/上下文紧密绑定
- 统一术语的引用方式,减少歧义
- 便于维护和更新术语定义
### 设计思想
术语定义协议基于以下核心理念:
1. **上下文绑定**:术语与其适用的协议文件紧密结合,确保术语在特定上下文中的含义明确。
2. **结构简洁**:采用最小必要的标签结构,便于维护和理解。
3. **引用明确**使用特定符号系统引用术语确保人类和AI都能识别术语引用。
4. **隐式作用域**:术语通过所在文件自动获得作用域,无需显式声明。
5. **自包含性**:协议文件包含其相关术语定义,提高文档完整性。
## 📝 语法定义
```ebnf
(* EBNF形式化定义 *)
terminologies_element ::= '<terminologies>' terminology+ '</terminologies>'
terminology_element ::= '<terminology>' terminology_content '</terminology>'
terminology_content ::= zh_element en_element definition_element examples_element
zh_element ::= '<zh>' text '</zh>'
en_element ::= '<en>' text '</en>'
definition_element ::= '<definition>' markdown_content '</definition>'
examples_element ::= '<examples>' example+ '</examples>'
example_element ::= '<example>' markdown_content '</example>'
text ::= (* 任何文本内容 *)
markdown_content ::= (* 任何有效的Markdown文本 *)
```
## 🧩 语义说明
### 术语定义结构
术语定义使用`<terminologies>`标签包含一组术语,每个术语使用`<terminology>`标签定义:
- **`<terminology>`**:单个术语的定义容器
- **`<zh>`**:术语的中文名称
- **`<en>`**:术语的英文名称
- **`<definition>`**术语的详细定义可同时包含AI理解和系统实现层面的解释
- **`<examples>`**:包含一个或多个`<example>`标签,提供使用示例
每个协议文件末尾使用标题"## 🔖 术语定义"引入术语定义部分,将术语定义与协议正文分隔。
### `#` 引用协议
术语定义协议规定了如何使用`#`符号作为统一的术语引用方式,遵循以下核心语法规则:
```ebnf
term_reference ::= '#' term_name [' ']
term_name ::= (* 术语的中文名称或英文名称 *)
```
#### 术语引用
术语引用在术语名称前使用井号标记:
| 语法 | 描述 | 示例 |
|------|------|------|
| `#术语` | 引用上下文中定义的术语 | `#协议绑定` |
基本术语引用在术语名称前使用井号,引用当前文档上下文中定义的术语:
```
#术语名称
```
例如:
- `#协议绑定` - 引用当前上下文中定义的"协议绑定"术语
- `#标签嵌套` - 引用当前上下文中定义的"标签嵌套"术语
推荐在术语后添加空格与其他内容分隔:`#术语 后续内容`,但这不是强制要求。
#### 与 Markdown 的兼容性
为了避免与 Markdown 的标题语法冲突DPML 采用以下解析规则:
1. **行首 # 符号**
- 当 # 出现在行首时,按照 Markdown 语法解析为标题
- 例如:`# 这是一个标题`
2. **非行首 # 符号**
- 当 # 出现在行中或词首时,解析为术语引用
- 例如:`这里引用了一个 #术语`
3. **行首术语引用**
- 如果需要在行首使用术语引用,可以添加空格或其他字符
- 例如:` #术语``文本 #术语`
这种设计保持了与 Markdown 的兼容性,同时提供了清晰的术语引用机制。
### 作用域规则
**隐式作用域**:术语自动具有其所在文档和上下文的作用域,这意味着:
- 术语的定义和使用范围由其所在的文档上下文决定
- 同一术语在不同上下文中可能有不同的定义
- 使用术语时应考虑当前所处的上下文环境