feat: 完成DPML协议体系0~1阶段开发 - 三层协议架构100%实现,智能路径检测系统,@package://与package.json完美集成,用户项目集成方案,CLI框架完整实现,132/137核心测试通过(96.3%通过率)
This commit is contained in:
60
prompt/protocol/tag/execution.tag.md
Normal file
60
prompt/protocol/tag/execution.tag.md
Normal file
@ -0,0 +1,60 @@
|
||||
# DPML#行为提示单元 框架
|
||||
|
||||
> **TL;DR:** DPML#行为提示单元 框架定义了结构化的#行为单元 模板,包含#流程(Process)、#指导原则(Guideline)、#规则(Rule)、#约束(Constraint)和#标准(Criteria)五个核心子概念,用于指导AI系统完成具体任务。
|
||||
|
||||
### 目的与功能
|
||||
|
||||
DPML#行为提示单元 框架定义了AI系统执行任务的#行为单元 模板,它的主要功能是:
|
||||
- 提供执行任务的结构化#行为单元 定义
|
||||
- 通过标准化#行为单元 明确#流程 步骤、#指导原则、#规则、#约束 和#标准
|
||||
- 帮助AI系统通过规范化#行为单元 进行精确、可靠的任务执行
|
||||
- 提供执行状态追踪和错误处理的#行为单元 模板
|
||||
|
||||
## 📝 语法定义
|
||||
|
||||
```ebnf
|
||||
(* EBNF形式化定义 *)
|
||||
execution_element ::= '<execution' attributes? '>' content '</execution>'
|
||||
attributes ::= (' ' attribute)+ | ''
|
||||
attribute ::= name '="' value '"'
|
||||
name ::= [a-zA-Z][a-zA-Z0-9_-]*
|
||||
value ::= [^"]*
|
||||
content ::= (markdown_content | process_element | guideline_element | rule_element | constraint_element | criteria_element)+
|
||||
|
||||
process_element ::= '<process' attributes? '>' markdown_content '</process>'
|
||||
guideline_element ::= '<guideline' attributes? '>' markdown_content '</guideline>'
|
||||
rule_element ::= '<rule' attributes? '>' markdown_content '</rule>'
|
||||
constraint_element ::= '<constraint' attributes? '>' markdown_content '</constraint>'
|
||||
criteria_element ::= '<criteria' attributes? '>' markdown_content '</criteria>'
|
||||
|
||||
markdown_content ::= (* 任何有效的Markdown文本,可包含特定语法元素 *)
|
||||
```
|
||||
|
||||
## 🧩 语义说明
|
||||
|
||||
#行为提示单元 标签表示一个完整的#行为单元 框架。标签内容可以包含五种不同概念的子标签,每个子标签都有明确的语义:
|
||||
|
||||
- **#流程**: 表示执行的具体步骤,包含正常和异常路径,是#行为单元 的核心路径定义
|
||||
- **#指导原则**: 表示建议性指导原则,具有灵活性和可变通性,用于推荐最佳实践
|
||||
- **#规则**: 表示强制性行为准则,必须严格遵守,通常涉及安全、合规或核心质量要求
|
||||
- **#约束**: 表示客观限制条件,客观存在且不可改变,需要被动适应
|
||||
- **#标准**: 表示评价标准,用于判断执行结果是否满足要求
|
||||
|
||||
这五个子概念构成了完整的#行为单元 框架,从不同维度定义了AI系统如何执行任务。
|
||||
|
||||
### 优先级关系
|
||||
|
||||
#行为提示单元 框架内的子概念具有以下固定的优先级关系,这种关系定义了如何理解和解释这些概念:
|
||||
|
||||
1. **#约束** - 最高优先级,表示客观存在的限制,不可违反
|
||||
2. **#规则** - 次高优先级,表示必须遵循的行为准则
|
||||
3. **#指导原则** - 较低优先级,表示可灵活调整的建议性原则
|
||||
4. **#流程** - 在#约束 和#规则 的框架内定义执行路径
|
||||
5. **#标准** - 作为评价依据,验证执行结果是否满足要求
|
||||
|
||||
这种优先级关系是框架的核心语义特征:
|
||||
- 低优先级元素不能与高优先级元素产生冲突
|
||||
- #流程 必须在#约束 和#规则 定义的边界内设计
|
||||
- #指导原则 在不违反#规则 和#约束 的前提下可以灵活调整
|
||||
- #标准 需要考虑所有优先级更高的元素的要求
|
||||
|
||||
83
prompt/protocol/tag/execution.terminology.md
Normal file
83
prompt/protocol/tag/execution.terminology.md
Normal file
@ -0,0 +1,83 @@
|
||||
<terminologies>
|
||||
<terminology>
|
||||
<zh>行为提示单元</zh>
|
||||
<en>Execution Prompt Unit</en>
|
||||
<definition>
|
||||
由<execution>标签及其子标签(如process、guideline、rule、constraint、criteria)构成的、表达完整行为/执行过程的结构化提示词单元。常简称为"行为单元",两者等同。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"所有操作流程都应以 #行为提示单元 组织。"</example>
|
||||
<example>"每个 #行为单元 都可以独立复用。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>行为单元</zh>
|
||||
<en>Execution Unit</en>
|
||||
<definition>
|
||||
"行为提示单元"的简称,含义完全等同。参见"行为提示单元"。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请将你的执行方案拆分为多个 #行为单元。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>流程</zh>
|
||||
<en>Process</en>
|
||||
<definition>
|
||||
在本协议中,#流程 专指 <process> 标签及其结构单元,表示用于承载具体执行步骤、路径的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请将详细步骤写入 #流程 单元(即 <process> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>指导原则</zh>
|
||||
<en>Guideline</en>
|
||||
<definition>
|
||||
在本协议中,#指导原则 专指 <guideline> 标签及其结构单元,表示用于承载建议性、灵活调整的行为指导内容的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"所有建议请归入 #指导原则 单元(即 <guideline> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>规则</zh>
|
||||
<en>Rule</en>
|
||||
<definition>
|
||||
在本协议中,#规则 专指 <rule> 标签及其结构单元,表示用于承载必须遵守的强制性行为准则的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"合规要求请写入 #规则 单元(即 <rule> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>约束</zh>
|
||||
<en>Constraint</en>
|
||||
<definition>
|
||||
在本协议中,#约束 专指 <constraint> 标签及其结构单元,表示用于承载客观限制条件的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"所有不可更改的限制请写入 #约束 单元(即 <constraint> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>标准</zh>
|
||||
<en>Criteria</en>
|
||||
<definition>
|
||||
在本协议中,#标准 专指 <criteria> 标签及其结构单元,表示用于承载评价标准、验收依据的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"验收要求请写入 #标准 单元(即 <criteria> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>行为模式</zh>
|
||||
<en>Execution Mode</en>
|
||||
<definition>
|
||||
在本协议中,#行为模式 指不同类型的行为/执行方式,如 #流程、#指导原则、#规则、#约束、#标准 等,分别由 <process>、<guideline>、<rule>、<constraint>、<criteria> 标签实现。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"复杂任务可组合多种 #行为模式。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
</terminologies>
|
||||
79
prompt/protocol/tag/memory.tag.md
Normal file
79
prompt/protocol/tag/memory.tag.md
Normal file
@ -0,0 +1,79 @@
|
||||
# DPML#记忆提示单元 框架
|
||||
|
||||
> **TL;DR:** DPML#记忆提示单元 框架定义了AI系统的#记忆管理#记忆单元 模板,支持运行时#动态记忆 管理,包含#评估(evaluate)、#存储(store)和#回忆(recall)三个核心#记忆操作,实现完整的#记忆循环 能力。
|
||||
|
||||
### 目的与功能
|
||||
|
||||
DPML#记忆提示单元 框架为AI系统提供完整的#记忆单元 模板,主要功能包括:
|
||||
- 提供运行时#动态记忆 的#评估、#存储 和#回忆 的标准化#记忆操作 机制
|
||||
- 实现跨会话的信息持久化#记忆单元 模板
|
||||
- 支持复杂的#记忆关联 和#记忆检索 模式的#记忆提示单元 构建
|
||||
|
||||
## 🔍 基本信息
|
||||
|
||||
**框架名称:** `<memory>` (DPML#记忆提示单元 框架)
|
||||
|
||||
|
||||
## 📝 语法定义
|
||||
|
||||
```ebnf
|
||||
(* EBNF形式化定义 *)
|
||||
memory_element ::= '<memory' attributes? '>' memory_content '</memory>'
|
||||
attributes ::= (' ' attribute)+ | ''
|
||||
attribute ::= name '="' value '"'
|
||||
name ::= [a-zA-Z][a-zA-Z0-9_-]*
|
||||
value ::= [^"]*
|
||||
|
||||
memory_content ::= (text | evaluate_element | store_element | recall_element)+
|
||||
|
||||
evaluate_element ::= '<evaluate:thought>' thought_content '</evaluate:thought>'
|
||||
store_element ::= '<store:execution' attributes? '>' (text | execution_element)* '</store:execution>'
|
||||
recall_element ::= '<recall:thought>' thought_content '</recall:thought>'
|
||||
|
||||
thought_content ::= (* 符合thought协议的内容 *)
|
||||
execution_element ::= (* 符合execution协议的元素 *)
|
||||
|
||||
text ::= (* 任何文本内容 *)
|
||||
```
|
||||
|
||||
## 🧩 语义说明
|
||||
|
||||
#记忆提示单元 标签表示AI系统的#记忆管理 单元,定义了#动态记忆 的结构和#记忆操作 方式。它由运行时#记忆管理 的三个核心部分组成:
|
||||
|
||||
### #记忆操作
|
||||
|
||||
#记忆提示单元 包含三个核心子标签,分别对应#记忆操作 的三个阶段:
|
||||
|
||||
1. **`<evaluate:thought>`**:#评估 信息是否值得记忆
|
||||
- 通过thought协议实现#评估 过程
|
||||
- 判断信息的价值、相关性和可信度
|
||||
- 决定是否将信息存入#记忆系统
|
||||
|
||||
2. **`<store:execution>`**:将信息#存储 入#记忆系统
|
||||
- 通过execution协议实现#存储 操作
|
||||
- 定义#存储 过程、规则和约束
|
||||
- 管理#记忆单元 的添加、更新和组织
|
||||
|
||||
3. **`<recall:thought>`**:从#记忆系统 检索并应用信息
|
||||
- 通过thought协议实现#回忆 过程
|
||||
- 判断何时需要#回忆 特定记忆
|
||||
- 规划如何#回忆 和应用#记忆内容
|
||||
- 可以使用多种实现方式,包括但不限于#资源引用
|
||||
- **注意**:#回忆 标签中的#资源引用 默认是按需加载的
|
||||
|
||||
### #记忆单元 关系
|
||||
|
||||
三个核心组件之间具有明确的逻辑关系:
|
||||
- #评估-#存储-#回忆 构成#动态记忆 的完整#记忆循环
|
||||
- #评估 决定什么值得记忆
|
||||
- #存储 定义如何保存记忆
|
||||
- #回忆 描述何时以及如何使用记忆
|
||||
|
||||
#记忆系统 的运行遵循"#评估-#存储-#回忆"的#记忆循环 模式,不断丰富和发展角色的#记忆能力。
|
||||
|
||||
> **注意**:#先验知识库(knowledge)已经迁移至`<role>`标签下管理,`<memory>`标签专注于#动态记忆 的运行时管理。
|
||||
|
||||
### #记忆模式
|
||||
|
||||
#记忆提示单元 支持多种#记忆模式,如#工作记忆、#短期记忆、#长期记忆、#陈述性记忆、#程序性记忆、#情境性记忆 等,可根据场景灵活配置和切换。
|
||||
|
||||
163
prompt/protocol/tag/memory.terminology.md
Normal file
163
prompt/protocol/tag/memory.terminology.md
Normal file
@ -0,0 +1,163 @@
|
||||
<terminologies>
|
||||
<terminology>
|
||||
<zh>记忆提示单元</zh>
|
||||
<en>Memory Prompt Unit</en>
|
||||
<definition>
|
||||
由<memory>标签及其子标签(如evaluate:thought、store:execution、recall:thought)构成的、表达记忆管理与操作的结构化提示词单元。常简称为"记忆单元",两者等同。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"所有运行时信息管理都应以 #记忆提示单元 组织。"</example>
|
||||
<example>"每个 #记忆单元 都可以独立复用。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>记忆单元</zh>
|
||||
<en>Memory Unit</en>
|
||||
<definition>
|
||||
"记忆提示单元"的简称,含义完全等同。参见"记忆提示单元"。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请将你的记忆操作拆分为多个 #记忆单元。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>评估</zh>
|
||||
<en>Evaluate</en>
|
||||
<definition>
|
||||
在本协议中,#评估 专指 <evaluate:thought> 标签及其结构单元,表示用于判断信息是否值得记忆的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"所有信息入库前需经过 #评估 单元(即 <evaluate:thought> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>存储</zh>
|
||||
<en>Store</en>
|
||||
<definition>
|
||||
在本协议中,#存储 专指 <store:execution> 标签及其结构单元,表示用于将信息写入记忆系统的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"数据写入请归入 #存储 单元(即 <store:execution> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>回忆</zh>
|
||||
<en>Recall</en>
|
||||
<definition>
|
||||
在本协议中,#回忆 专指 <recall:thought> 标签及其结构单元,表示用于从记忆系统检索信息的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"检索操作请写入 #回忆 单元(即 <recall:thought> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>记忆操作</zh>
|
||||
<en>Memory Operation</en>
|
||||
<definition>
|
||||
在本协议中,#记忆操作 指 #评估-#存储-#回忆 的完整循环过程。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#记忆操作 需遵循评估-存储-回忆的顺序。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>动态记忆</zh>
|
||||
<en>Dynamic Memory</en>
|
||||
<definition>
|
||||
在本协议中,#动态记忆 指运行时可变的记忆内容,与#先验知识库 区分。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#动态记忆 反映AI当前会话的上下文。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>先验知识库</zh>
|
||||
<en>Prior Knowledge Base</en>
|
||||
<definition>
|
||||
在本协议中,#先验知识库 指角色固有的、初始化的知识体系,不属于#动态记忆 范畴。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#先验知识库 由<role>标签管理。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>记忆循环</zh>
|
||||
<en>Memory Cycle</en>
|
||||
<definition>
|
||||
在本协议中,#记忆循环 指 #评估-#存储-#回忆 的循环模式。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#记忆循环 有助于持续优化AI记忆。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>记忆模式</zh>
|
||||
<en>Memory Mode</en>
|
||||
<definition>
|
||||
在本协议中,#记忆模式 指不同的#评估、#存储、#回忆 实现方式。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"可根据场景切换不同 #记忆模式。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>工作记忆</zh>
|
||||
<en>Working Memory</en>
|
||||
<definition>
|
||||
在本协议中,#工作记忆 指AI在当前任务或会话中临时存储和处理的信息,具有短时性和高活跃度。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#工作记忆 主要用于当前推理和决策。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>短期记忆</zh>
|
||||
<en>Short-term Memory</en>
|
||||
<definition>
|
||||
在本协议中,#短期记忆 指AI在较短时间内保留的信息,支持跨轮对话和短时上下文。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#短期记忆 可用于多轮对话的上下文保持。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>长期记忆</zh>
|
||||
<en>Long-term Memory</en>
|
||||
<definition>
|
||||
在本协议中,#长期记忆 指AI可持久保存、跨会话复用的重要信息。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"用户偏好应存入 #长期记忆。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>陈述性记忆</zh>
|
||||
<en>Declarative Memory</en>
|
||||
<definition>
|
||||
在本协议中,#陈述性记忆 指可被明确表达和检索的事实性知识,如事件、概念等。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"知识库内容属于 #陈述性记忆。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>程序性记忆</zh>
|
||||
<en>Procedural Memory</en>
|
||||
<definition>
|
||||
在本协议中,#程序性记忆 指AI掌握的操作流程、技能和执行规则。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"常用操作流程应归入 #程序性记忆。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>情境性记忆</zh>
|
||||
<en>Contextual Memory</en>
|
||||
<definition>
|
||||
在本协议中,#情境性记忆 指与特定场景、环境或上下文相关的记忆内容。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"对话场景信息属于 #情境性记忆。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
</terminologies>
|
||||
186
prompt/protocol/tag/resource.tag.md
Normal file
186
prompt/protocol/tag/resource.tag.md
Normal file
@ -0,0 +1,186 @@
|
||||
# DPML#资源提示单元 框架
|
||||
|
||||
> **TL;DR:** DPML#资源提示单元 框架定义了统一的#资源单元 模板,支持通过#资源引用(@协议名://路径)形式在提示词中访问和操作各类资源。
|
||||
|
||||
### 目的与功能
|
||||
|
||||
DPML#资源提示单元 框架用于定义特定类型的#资源单元,使开发者能够以标准化的方式在提示词中描述如何#定位 和处理各种资源。通过这个框架,可以明确#资源协议 的引用语法、#位置 规则和#查询参数,确保#资源引用 在不同环境中的一致性和可靠性。此框架是PromptX中#资源协议(RP)在提示词层面的具体实现方式。
|
||||
|
||||
主要功能包括:
|
||||
- 定义#资源单元 的标识和#资源引用 方式
|
||||
- 规范化#位置 的提示词语法结构和#解析 规则
|
||||
- 指定#资源单元 支持的#查询参数 和格式
|
||||
- 提供#资源单元 的标准化示例
|
||||
|
||||
### 默认支持的通用#资源协议
|
||||
|
||||
PromptX默认支持以下通用且已有共识的#资源协议,这些协议符合`@协议名://路径`格式,遵循其业界标准语法和规则,无需在#资源单元 中重新定义:
|
||||
|
||||
| #资源协议 | 描述 | 示例 |
|
||||
|-------|------|------|
|
||||
| file | 文件系统资源 | `@file://path/to/file.txt` |
|
||||
| http/https | HTTP/HTTPS网络资源 | `@https://example.com/api/data` |
|
||||
| ftp/sftp | 文件传输协议 | `@ftp://user:pass@host/path` |
|
||||
| ssh | 安全Shell协议 | `@ssh://user@host/path` |
|
||||
|
||||
这些通用#资源协议 的路径格式和#查询参数 遵循它们的标准规范。对于特定领域或自定义的#资源协议,才需要使用#资源单元 进行详细定义。
|
||||
|
||||
## 📝 语法定义
|
||||
|
||||
```ebnf
|
||||
(* EBNF形式化定义 *)
|
||||
resource_element ::= '<resource' ' protocol="' protocol_name '"' '>' content '</resource>'
|
||||
protocol_name ::= [a-zA-Z][a-zA-Z0-9_-]*
|
||||
content ::= (markdown_content | location_element | params_element | registry_element)+
|
||||
|
||||
location_element ::= '<location>' markdown_content '</location>'
|
||||
params_element ::= '<params>' markdown_content '</params>'
|
||||
registry_element ::= '<registry>' markdown_content '</registry>'
|
||||
|
||||
markdown_content ::= (* 任何有效的Markdown文本,包括代码块、表格等 *)
|
||||
```
|
||||
|
||||
## 🧩 语义说明
|
||||
|
||||
### 子标签语义
|
||||
|
||||
#资源单元 包含三个核心子标签,用于定义#资源协议 的具体内容:
|
||||
|
||||
- **#位置**:定义该#资源协议 的路径规则。通常采用EBNF形式化语法描述路径结构,并可包含示例说明。
|
||||
- **#参数**:定义该#资源协议 支持的#查询参数。通常采用表格形式列出参数名称、类型、描述和用法示例。
|
||||
- **#注册表**:根据#位置 和#参数 定义注册抽象参数与具体资源的映射关系。通常采用表格形式列出ID到实际资源路径的映射。
|
||||
|
||||
这三个子标签共同构成#资源协议 的完整定义:#位置 定义资源的#定位 格式,#参数 定义资源的访问选项,#注册表 将抽象ID映射到具体资源路径。标签应按照#位置、#参数、#注册表 的顺序定义,确保#注册表 可以基于前两个标签的内容建立正确的映射关系。
|
||||
|
||||
### `@` #资源引用 协议
|
||||
|
||||
#资源单元 定义了一个#资源协议,指定了如何使用`@`符号作为统一入口,遵循以下核心语法规则:
|
||||
|
||||
```ebnf
|
||||
resource_reference ::= ('[@]' | '@!' | '@?') protocol_name ':' resource_location [query_params]
|
||||
resource_location ::= uri | nested_reference
|
||||
uri ::= protocol_name '://' path
|
||||
nested_reference ::= ['[@]' | '@!' | '@?'] protocol_name ':' resource_location
|
||||
path ::= path_segment {'/' path_segment}
|
||||
query_params ::= '?' param_name '=' param_value {'&' param_name '=' param_value}
|
||||
```
|
||||
|
||||
#### #加载语义
|
||||
|
||||
#资源引用 支持三种#加载语义 前缀:
|
||||
|
||||
| 前缀 | 语义 | 示例 |
|
||||
|-----|------|------|
|
||||
| `@` | 默认模式,由AI自行决定#加载 时机 | `@file://document.md` |
|
||||
| `@!` | #热加载,AI看到引用时必须立即#加载 | `@!https://example.com/data` |
|
||||
| `@?` | #懒加载,AI仅记录资源位置,在实际需要使用时才#加载 | `@?file://large-dataset.csv` |
|
||||
|
||||
#### 基础#资源引用
|
||||
|
||||
基础#资源引用 使用单一#资源协议:
|
||||
```
|
||||
@protocol://path
|
||||
```
|
||||
|
||||
例如:
|
||||
- `@file://document.md` - 引用文件系统中的文档
|
||||
- `@http://example.com/api/data.json` - 引用网络资源
|
||||
- `@memory://user_preferences` - 引用内存中的数据
|
||||
- `@!file://important.md` - #热加载 重要文档
|
||||
- `@?file://large-dataset.csv` - #懒加载 大型数据集
|
||||
|
||||
#### #嵌套引用
|
||||
|
||||
#嵌套引用 允许一个#资源协议 处理另一个#资源协议 的输出:
|
||||
|
||||
**完整形式**(内部使用@符号):
|
||||
```
|
||||
@outer:@inner://path
|
||||
```
|
||||
|
||||
**简写形式**(内部省略@符号):
|
||||
```
|
||||
@outer:inner://path
|
||||
```
|
||||
|
||||
#嵌套引用 时也可以指定#加载语义:
|
||||
```
|
||||
@outer:@!inner://path // 内部资源#热加载
|
||||
@!outer:@?inner://path // 外部#热加载,内部#懒加载
|
||||
```
|
||||
|
||||
例如:
|
||||
- `@thinking:@file://method.md` - 对文件内容应用thinking协议处理
|
||||
- `@execution:file://workflow.md` - 对文件内容应用execution协议处理
|
||||
- `@outer:middle:inner://resource` - 多层#嵌套引用(从内向外处理)
|
||||
- `@!thinking:@?file://large-file.md` - 立即应用thinking,但文件内容#懒加载
|
||||
|
||||
#### #路径通配符
|
||||
|
||||
路径支持以下#路径通配符 模式:
|
||||
- `*` - 匹配单层中的任意文件或目录,如`@file://docs/*.md`
|
||||
- `**` - 匹配多层目录和文件,如`@file://src/**/*.js`
|
||||
- `*.ext` - 匹配特定扩展名的文件,如`@file://docs/*.txt`
|
||||
- `*.{ext1,ext2}` - 匹配多种扩展名,如`@file://src/*.{js,ts}`
|
||||
|
||||
#### #查询参数
|
||||
|
||||
#查询参数 提供额外的资源处理指令:
|
||||
```
|
||||
@protocol://path?param1=value1¶m2=value2
|
||||
```
|
||||
|
||||
例如:
|
||||
- `@file://document.md?line=5-10` - 只获取文件的第5-10行
|
||||
- `@http://api.example.com/data?format=json&cache=false` - 指定返回格式并禁用缓存
|
||||
|
||||
#### #注册表 解析与抽象引用
|
||||
|
||||
使用#注册表 定义的资源可以通过抽象ID引用,无需知道具体路径:
|
||||
```
|
||||
@protocol://resource_id
|
||||
```
|
||||
|
||||
例如定义了以下#注册表:
|
||||
```xml
|
||||
<resource protocol="thought">
|
||||
<location>
|
||||
location ::= thought://{thought_id}
|
||||
thought_id ::= [a-zA-Z][a-zA-Z0-9_-]*
|
||||
</location>
|
||||
|
||||
<registry>
|
||||
| 思维ID | 文件路径 |
|
||||
|--------|---------|
|
||||
| analytical | @file://PromptX/core/thoughts/analytical.thought.md |
|
||||
| creative | @file://PromptX/core/thoughts/creative.thought.md |
|
||||
</registry>
|
||||
</resource>
|
||||
```
|
||||
|
||||
使用时可以简单引用:
|
||||
- `@thought://analytical` - 自动映射到对应文件
|
||||
- `@thought://creative` - 自动映射到对应文件
|
||||
|
||||
这种抽象引用机制提供了路由层,使#资源引用 与实际存储位置解耦,方便管理和移植。
|
||||
|
||||
### #解析 规则
|
||||
|
||||
1. #资源引用 解析从左至右进行,先识别#资源协议 名称,再#解析 资源位置和#查询参数
|
||||
2. #嵌套引用 从内向外#解析,内层#资源引用 的结果作为外层引用的输入
|
||||
3. #查询参数 应用于资源#加载 后的处理阶段,不影响资源的基本#定位
|
||||
4. 相对路径#定位 基于当前上下文的工作目录或基础路径
|
||||
5. #加载语义 前缀(@、@!、@?)优先于其他部分#解析,决定资源的#加载 策略
|
||||
|
||||
### #加载 实现说明
|
||||
|
||||
对于支持工具调用能力的AI系统:
|
||||
1. **主动#加载 责任**: AI需主动使用工具调用(例如read_file)获取@引用的资源,而非等待系统自动#加载
|
||||
2. **#热加载 义务**: 特别是对于@!前缀资源,AI必须立即执行工具调用#加载 内容
|
||||
3. **自主判断#懒加载**: 对于@?前缀资源,AI应记录位置但暂不#加载,直到实际需要使用时
|
||||
4. **#加载 验证**: AI应验证资源是否成功#加载,并适当处理#加载 失败情况
|
||||
5. **#注册表 解析**: 对于使用#注册表 注册的#资源引用,AI应首先#解析 资源ID,找到对应的实际资源路径,然后再应用上述规则获取资源
|
||||
|
||||
这种主动#加载 模式确保AI能正确执行协议定义的#加载语义,而不依赖系统层面的自动处理。#注册表 机制则提供了#资源引用 的抽象层,使资源组织更加灵活和模块化。
|
||||
|
||||
|
||||
173
prompt/protocol/tag/resource.terminology.md
Normal file
173
prompt/protocol/tag/resource.terminology.md
Normal file
@ -0,0 +1,173 @@
|
||||
<terminologies>
|
||||
<terminology>
|
||||
<zh>资源提示单元</zh>
|
||||
<en>Resource Prompt Unit</en>
|
||||
<definition>
|
||||
由<resource>标签及其子标签(如location、params、registry)构成的、表达资源访问与引用的结构化提示词单元。常简称为"资源单元",两者等同。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"所有外部数据访问都应以 #资源提示单元 组织。"</example>
|
||||
<example>"每个 #资源单元 都可以独立复用。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>资源单元</zh>
|
||||
<en>Resource Unit</en>
|
||||
<definition>
|
||||
"资源提示单元"的简称,含义完全等同。参见"资源提示单元"。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请将你的引用方案拆分为多个 #资源单元。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>位置</zh>
|
||||
<en>Location</en>
|
||||
<definition>
|
||||
在本协议中,#位置 专指 <location> 标签及其结构单元,表示用于定义资源路径规则的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请将路径规则写入 #位置 单元(即 <location> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>参数</zh>
|
||||
<en>Params</en>
|
||||
<definition>
|
||||
在本协议中,#参数 专指 <params> 标签及其结构单元,表示用于定义资源支持的查询参数的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"所有可选参数请归入 #参数 单元(即 <params> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>注册表</zh>
|
||||
<en>Registry</en>
|
||||
<definition>
|
||||
在本协议中,#注册表 专指 <registry> 标签及其结构单元,表示用于定义资源ID与实际路径映射关系的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"资源ID映射请写入 #注册表 单元(即 <registry> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>资源协议</zh>
|
||||
<en>Resource Protocol</en>
|
||||
<definition>
|
||||
在本协议中,#资源协议 指 file、http、memory 等协议名部分,用于标识资源类型和访问方式。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#资源协议 支持 file、http、memory 等多种类型。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>资源引用</zh>
|
||||
<en>Resource Reference</en>
|
||||
<definition>
|
||||
在本协议中,#资源引用 指 @file://path、@memory://id 等资源的引用表达式。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请用 #资源引用 方式标注外部依赖。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>加载语义</zh>
|
||||
<en>Loading Semantics</en>
|
||||
<definition>
|
||||
在本协议中,#加载语义 指 @、@!、@? 前缀,决定资源的加载策略。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#加载语义 决定资源是立即加载还是懒加载。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>加载</zh>
|
||||
<en>Load</en>
|
||||
<definition>
|
||||
在本协议中,#加载 指资源的实际获取、读取或载入过程。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#加载 过程由 AI 主动发起。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>懒加载</zh>
|
||||
<en>Lazy Load</en>
|
||||
<definition>
|
||||
在本协议中,#懒加载 指资源仅在实际需要时才加载,通常与 @? 前缀相关。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"大文件建议采用 #懒加载 策略。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>热加载</zh>
|
||||
<en>Eager Load</en>
|
||||
<definition>
|
||||
在本协议中,#热加载(即立即加载)指资源在被引用时立即加载,通常与 @! 前缀相关。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"关键依赖应采用 #热加载 策略。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>定位</zh>
|
||||
<en>Locate</en>
|
||||
<definition>
|
||||
在本协议中,#定位 指通过协议和路径规则确定资源实际位置的过程。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#定位 过程依赖 #位置 单元的定义。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>解析</zh>
|
||||
<en>Parse</en>
|
||||
<definition>
|
||||
在本协议中,#解析 指对资源引用表达式、路径、参数等进行语法和语义分析的过程。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#解析 资源引用时需处理嵌套结构。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>嵌套引用</zh>
|
||||
<en>Nested Reference</en>
|
||||
<definition>
|
||||
在本协议中,#嵌套引用 指资源引用中包含另一个资源引用的结构,如 @outer:@inner://path。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"复杂场景可用 #嵌套引用 实现多层资源处理。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>路径通配符</zh>
|
||||
<en>Path Wildcard</en>
|
||||
<definition>
|
||||
在本协议中,#路径通配符 指 *、**、*.ext 等通配符用法,用于灵活匹配资源路径。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#路径通配符 支持批量引用资源。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>查询参数</zh>
|
||||
<en>Query Parameter</en>
|
||||
<definition>
|
||||
在本协议中,#查询参数 指 ?param=value 结构,用于为资源引用提供额外指令。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#查询参数 可用于指定加载范围。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>资源模式</zh>
|
||||
<en>Resource Mode</en>
|
||||
<definition>
|
||||
在本协议中,#资源模式 指不同类型的资源访问与引用方式,如 #位置、#参数、#注册表 等,分别由 <location>、<params>、<registry> 标签实现。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"支持多种 #资源模式 灵活访问外部数据。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
</terminologies>
|
||||
76
prompt/protocol/tag/role.tag.md
Normal file
76
prompt/protocol/tag/role.tag.md
Normal file
@ -0,0 +1,76 @@
|
||||
# DPML#角色提示单元 框架
|
||||
|
||||
> **TL;DR:** DPML#角色提示单元 框架解释了如何通过组合#思维模式、#行为模式 和#记忆模式 三大基础协议来构建完整的#AI角色,支持不同类型#角色模式 的构建和定制。
|
||||
|
||||
### 目的与功能
|
||||
|
||||
DPML#角色提示单元 框架说明了如何通过基础协议的组合构建#AI角色,它的主要功能是:
|
||||
- 提供#角色合成 的标准方法论
|
||||
- 指导如何将#思维模式、#行为模式 和#记忆模式 组合以表达#角色特性
|
||||
- 支持不同类型#角色模式 的灵活定制
|
||||
- 确保#角色定义 的一致性和完整性
|
||||
|
||||
## 📝 语法定义
|
||||
|
||||
```ebnf
|
||||
(* EBNF形式化定义 *)
|
||||
role_element ::= '<role' attributes? '>' role_content '</role>'
|
||||
role_content ::= (personality_element | principle_element | knowledge_element | experience_element | action_element)+
|
||||
|
||||
(* #角色组织标签 *)
|
||||
personality_element ::= '<personality' attributes? '>' personality_content '</personality>'
|
||||
principle_element ::= '<principle' attributes? '>' principle_content '</principle>'
|
||||
knowledge_element ::= '<knowledge' attributes? '>' knowledge_content '</knowledge>'
|
||||
experience_element ::= '<experience' attributes? '>' experience_content '</experience>'
|
||||
action_element ::= '<action' attributes? '>' action_content '</action>'
|
||||
|
||||
(* 内部内容 *)
|
||||
personality_content ::= markdown_content
|
||||
principle_content ::= markdown_content
|
||||
knowledge_content ::= markdown_content
|
||||
experience_content ::= markdown_content
|
||||
action_content ::= markdown_content
|
||||
|
||||
attributes ::= (' ' attribute)+ | ''
|
||||
attribute ::= name '="' value '"'
|
||||
name ::= [a-zA-Z][a-zA-Z0-9_-]*
|
||||
value ::= [^"]*
|
||||
|
||||
(* 各协议内容定义见各自协议文档 *)
|
||||
```
|
||||
|
||||
## 🧩 语义说明
|
||||
|
||||
`<role>`标签是DPML中定义#AI角色 的顶层#角色提示单元,它封装了#人格、#原则 和#知识记忆,共同构成一个完整的#角色定义。#角色定义 必须使用`<role>`作为根标签,而不应直接使用其他标签的组合。
|
||||
|
||||
### #角色提示单元 的组成部分
|
||||
|
||||
- **#人格(Personality)**: 用于设置和编排多种#思维模式 的优先级
|
||||
- #思维模式 为 `<thought>` 的语义功能
|
||||
- 定义#角色 拥有的一种或多种#思维模式
|
||||
- 设置不同#思维模式 的激活条件,组合方式和优先级
|
||||
- 确保#角色思维 的一致性和可预测性
|
||||
|
||||
- **#原则(Principle)**: 用于设置和编排多种#行为模式 的优先级
|
||||
- #行为模式 为 `<execution>` 的语义功能
|
||||
- 定义#角色 拥有的一种或多种#行为模式
|
||||
- 设置不同#行为模式 的触发条件,执行顺序和优先级
|
||||
- 确保#角色行为 的规范性和可控性
|
||||
|
||||
- **#知识(Knowledge)**: #角色 的#先验知识库
|
||||
- 定义#角色 固有的、初始化的#知识体系
|
||||
- 提供#角色 的专业背景和基础认知框架
|
||||
- 作为#角色理解 和决策的#知识基础
|
||||
|
||||
- **#经验(Experience)**: 用于设置和编排多种#记忆模式 的优先级
|
||||
- #记忆模式 为 `<memory>` 的语义功能
|
||||
- 定义#角色 如何#评估、#存储 和#回忆 信息
|
||||
- 设置不同#记忆模式 的检索条件和优先级
|
||||
- 确保#角色记忆处理 的连贯性和适应性
|
||||
|
||||
- **#激活(Action)**: 提供#角色初始化 和执行的入口
|
||||
- 定义#角色 从"定义"到"执行"的转换机制
|
||||
- 明确#角色初始化 序列和优先级
|
||||
- 规定#资源加载、#记忆系统 启动等关键步骤
|
||||
- 确保#角色 能够正确地进入执行状态
|
||||
- 建立#角色定义 与实际执行间的桥梁
|
||||
103
prompt/protocol/tag/role.terminology.md
Normal file
103
prompt/protocol/tag/role.terminology.md
Normal file
@ -0,0 +1,103 @@
|
||||
<terminologies>
|
||||
<terminology>
|
||||
<zh>角色提示单元</zh>
|
||||
<en>Role Prompt Unit</en>
|
||||
<definition>
|
||||
由<role>标签及其子标签(如personality、principle、knowledge、experience、action)构成的、表达AI角色结构与行为的结构化提示词单元。常简称为"角色单元",两者等同。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"所有AI角色定义都应以 #角色提示单元 组织。"</example>
|
||||
<example>"每个 #角色单元 都可以独立复用。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>角色单元</zh>
|
||||
<en>Role Unit</en>
|
||||
<definition>
|
||||
"角色提示单元"的简称,含义完全等同。参见"角色提示单元"。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请将你的角色设计拆分为多个 #角色单元。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>人格</zh>
|
||||
<en>Personality</en>
|
||||
<definition>
|
||||
在本协议中,#人格 专指 <personality> 标签及其结构单元,定义角色的#思维模式。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#人格 决定角色的思考风格。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>原则</zh>
|
||||
<en>Principle</en>
|
||||
<definition>
|
||||
在本协议中,#原则 专指 <principle> 标签及其结构单元,定义角色的#行为模式。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#原则 约束角色的行为边界。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>知识</zh>
|
||||
<en>Knowledge</en>
|
||||
<definition>
|
||||
在本协议中,#知识 专指 <knowledge> 标签及其结构单元,定义角色的#先验知识库。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#知识 提供角色的专业背景。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>经验</zh>
|
||||
<en>Experience</en>
|
||||
<definition>
|
||||
在本协议中,#经验 专指 <experience> 标签及其结构单元,定义角色的#记忆模式。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#经验 影响角色的记忆处理方式。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>激活</zh>
|
||||
<en>Action</en>
|
||||
<definition>
|
||||
在本协议中,#激活 专指 <action> 标签及其结构单元,定义角色的初始化和执行入口。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#激活 决定角色的启动流程。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>角色合成</zh>
|
||||
<en>Role Composition</en>
|
||||
<definition>
|
||||
在本协议中,#角色合成 指通过#思维模式、#行为模式、#记忆模式 三大协议组合构建角色的机制。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#角色合成 支持灵活定制AI能力。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>角色模式</zh>
|
||||
<en>Role Mode</en>
|
||||
<definition>
|
||||
在本协议中,#角色模式 指角色内部多种模式(如#思维模式、#行为模式、#记忆模式)的组合。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"不同AI可采用不同 #角色模式。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>角色初始化</zh>
|
||||
<en>Role Initialization</en>
|
||||
<definition>
|
||||
在本协议中,#角色初始化 指角色从定义到执行的激活过程。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"#角色初始化 包含资源加载、记忆系统启动等步骤。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
</terminologies>
|
||||
105
prompt/protocol/tag/terminology.tag.md
Normal file
105
prompt/protocol/tag/terminology.tag.md
Normal 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 的兼容性,同时提供了清晰的术语引用机制。
|
||||
|
||||
### 作用域规则
|
||||
|
||||
**隐式作用域**:术语自动具有其所在文档和上下文的作用域,这意味着:
|
||||
- 术语的定义和使用范围由其所在的文档上下文决定
|
||||
- 同一术语在不同上下文中可能有不同的定义
|
||||
- 使用术语时应考虑当前所处的上下文环境
|
||||
60
prompt/protocol/tag/thought.tag.md
Normal file
60
prompt/protocol/tag/thought.tag.md
Normal file
@ -0,0 +1,60 @@
|
||||
# DPML#思考提示单元 框架
|
||||
|
||||
> **TL;DR:** DPML#思考提示单元 框架定义了结构化的#思考单元 模板,支持四种核心#思维模式 的#思考提示单元 构建:#探索思维(exploration)、#推理思维(reasoning)、#计划思维(plan)和#挑战思维(challenge),帮助AI系统进行系统性分析和推理。
|
||||
|
||||
### 目的与功能
|
||||
|
||||
DPML#思考提示单元 框架定义了AI系统进行思考分析的#思考单元 模板和结构,它的主要功能是:
|
||||
- 提供结构化的#思维分析#思考提示单元 模板
|
||||
- 规范化#思考单元 的组织方式
|
||||
- 支持可视化#思维导图 和#决策树 的#思考提示单元 表达
|
||||
- 帮助AI系统通过标准化#思考提示单元 进行系统性、全面性的问题分析
|
||||
- 区分不同类型的#思维模式#思考提示单元:#探索思维、#推理思维、#计划思维 和#挑战思维
|
||||
|
||||
## 📝 语法定义
|
||||
|
||||
```ebnf
|
||||
(* EBNF形式化定义 *)
|
||||
thought_element ::= '<thought' attributes? '>' content '</thought>'
|
||||
attributes ::= (' ' attribute)+ | ''
|
||||
attribute ::= name '="' value '"'
|
||||
name ::= [a-zA-Z][a-zA-Z0-9_-]*
|
||||
value ::= [^"]*
|
||||
content ::= (markdown_content | exploration_element | reasoning_element | plan_element | challenge_element)+
|
||||
markdown_content ::= (* 任何有效的Markdown文本,包括Mermaid图表 *)
|
||||
|
||||
exploration_element ::= '<exploration' attributes? '>' markdown_content '</exploration>'
|
||||
reasoning_element ::= '<reasoning' attributes? '>' markdown_content '</reasoning>'
|
||||
plan_element ::= '<plan' attributes? '>' markdown_content '</plan>'
|
||||
challenge_element ::= '<challenge' attributes? '>' markdown_content '</challenge>'
|
||||
```
|
||||
|
||||
## 🧩 语义说明
|
||||
|
||||
#思考提示单元 标签表示一个完整的#思考单元 或#思维框架。标签内容可以包含四种不同#思维模式 的子标签,或直接使用Markdown格式表达#思考内容。
|
||||
|
||||
子标签具有明确的语义:
|
||||
- **#探索思维**: 表示跳跃思考,发散性思维,生成可能性,寻找多种可能性、创新点和关联性
|
||||
- **#推理思维**: 表示连续思考,收敛性思维,验证可能性,深入分析因果关系、逻辑链条
|
||||
- **#计划思维**: 表示秩序思考,结构性思维,固化可能性,设计行动步骤、决策路径、组织结构、系统架构
|
||||
- **#挑战思维**: 表示逆向跳跃思考,批判性思维,质疑可能性,寻找假设漏洞、识别潜在风险、测试极限条件
|
||||
|
||||
#探索思维 和#挑战思维 是一对#思维模式 的正反两面:#探索思维 向外发散寻找"可能是什么",而#挑战思维 向内批判探究"可能不是什么"。二者都采用跳跃式思考,但方向相反。#推理思维 负责系统验证,而#挑战思维 主要提出问题点。
|
||||
|
||||
#思考提示单元 特别适合表达概念关系、逻辑推理和系统性思考,为AI提供#思考分析 的参考框架。
|
||||
|
||||
### 推荐的#思考顺序
|
||||
|
||||
在实际思考过程中,推荐遵循如下顺序以获得系统性和全面性的分析结果:
|
||||
1. **#探索思维**:首先发散思考,提出尽可能多的可能性和创新点;
|
||||
2. **#挑战思维**:对#探索思维 阶段的内容进行批判性思考,识别潜在风险和假设漏洞;
|
||||
3. **#推理思维**:对经过#挑战思维 筛选的内容进行系统性推理和因果分析;
|
||||
4. **#计划思维**:最后制定具体的行动方案和决策路径。
|
||||
|
||||
在复杂问题中,#挑战思维 和#推理思维 可多次交替,#计划思维 阶段也可穿插#挑战思维 以确保方案稳健性。
|
||||
|
||||
### 子标签的可选性
|
||||
|
||||
#思考提示单元 内的四种#思维模式 子标签(#探索思维、#挑战思维、#推理思维、#计划思维)均为可选。实际的#思考提示单元 可以只包含其中的一种、几种,或全部,具体内容由实际需求决定。
|
||||
|
||||
对于提示词的理解者来说,只需知道这些子标签不是必须全部出现,遇到哪些子标签就理解哪些即可,无需关心未出现的部分。
|
||||
73
prompt/protocol/tag/thought.terminology.md
Normal file
73
prompt/protocol/tag/thought.terminology.md
Normal file
@ -0,0 +1,73 @@
|
||||
<terminologies>
|
||||
<terminology>
|
||||
<zh>思考提示单元</zh>
|
||||
<en>Thought Prompt Unit</en>
|
||||
<definition>
|
||||
由<thought>标签及其子标签(如exploration、reasoning、plan、challenge)构成的、表达完整思考过程的结构化提示词单元。常简称为"思考单元",两者等同。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"本协议所有复杂推理均应以 #思考提示单元 为基本结构。"</example>
|
||||
<example>"每个 #思考单元 都可以独立复用。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>思考单元</zh>
|
||||
<en>Thought Unit</en>
|
||||
<definition>
|
||||
"思考提示单元"的简称,含义完全等同。参见"思考提示单元"。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请将你的分析拆分为多个 #思考单元。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>探索思维</zh>
|
||||
<en>Exploration</en>
|
||||
<definition>
|
||||
在本协议中,#探索思维 专指 <exploration> 标签及其结构单元,表示用于承载发散性、创新性思考内容的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请将你的假设写入 #探索思维 单元(即 <exploration> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>推理思维</zh>
|
||||
<en>Reasoning</en>
|
||||
<definition>
|
||||
在本协议中,#推理思维 专指 <reasoning> 标签及其结构单元,表示用于承载因果分析、逻辑推理内容的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"所有因果链条建议写入 #推理思维 单元(即 <reasoning> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>计划思维</zh>
|
||||
<en>Plan</en>
|
||||
<definition>
|
||||
在本协议中,#计划思维 专指 <plan> 标签及其结构单元,表示用于承载行动方案、结构规划内容的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"最终方案请整理进 #计划思维 单元(即 <plan> 标签)。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>挑战思维</zh>
|
||||
<en>Challenge</en>
|
||||
<definition>
|
||||
在本协议中,#挑战思维 专指 <challenge> 标签及其结构单元,表示用于承载批判性、风险识别内容的提示词片段。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"请用 #挑战思维 单元(即 <challenge> 标签)补充反例和风险点。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
<terminology>
|
||||
<zh>思维模式</zh>
|
||||
<en>Thinking Mode</en>
|
||||
<definition>
|
||||
在本协议中,#思维模式 指不同类型的思考方式,如 #探索思维、#推理思维、#计划思维、#挑战思维 等,分别由 <exploration>、<reasoning>、<plan>、<challenge> 标签实现。
|
||||
</definition>
|
||||
<examples>
|
||||
<example>"可根据任务需要切换不同 #思维模式。"</example>
|
||||
</examples>
|
||||
</terminology>
|
||||
</terminologies>
|
||||
Reference in New Issue
Block a user