## 目标 制定DPML Protocol的RFC规范文档，建立标准化的协议定义。 ## 背景 DPML (Deepractice Prompt Markup Language) 是用于定义AI应用的声明式标记语言协议。目前已有基础实现（Agent runtime），但缺少正式的协议规范文档。 ## 设计原则 ### RFC vs W3C 双层设计 根据之前讨论确定的设计策略： - **RFC层（协议核心）**：面向实现者 - 语法定义（BNF/ABNF） - 数据结构规范 - 解析规则 - 可被计算机验证和解析 - **W3C层（使用指南）**：面向使用者 - 实用示例 - 最佳实践 - 领域扩展（Agent/Task/Role/Workflow） - 可被AI和人类理解 ### 核心理念 - **声明式优先**：像写HTML一样定义AI行为 - **可扩展性**：插件系统和领域扩展机制 - **标准化**：确保一致性和互操作性 - **低门槛**：5分钟上手，无需深入了解AI模型内部 ## 协议范围 ### 1. 核心协议（当前focus） - XML/HTML-like 标记语法 - 基础元素定义（agent, llm, prompt等） - 属性系统（api-key, model等） - 引用机制（@env:, @file:等） - 验证规则 ### 2. 领域扩展（未来） - Agent Domain - 对话式AI助手（已实现） - Task Domain - 状态机任务定义（规划中） - Role Domain - AI角色人格定义（规划中） - Workflow Domain - 工作流编排（规划中） ## 待讨论问题 1. **协议命名** - 正式名称确认：DPML Protocol - 版本策略：如何管理协议版本 2. **RFC文档结构** - 采用标准RFC格式还是简化版本 - 章节组织方式 - 示例的详细程度 3. **语法规范** - 使用ABNF还是其他形式描述语法 - 标签命名规范 - 属性值类型系统 4. **扩展机制** - 如何定义自定义标签 - 插件系统规范 - 命名空间策略 5. **与现有实现对齐** - 当前packages/dpml的实现与协议的关系 - 如何保证实现遵循规范 ## 产出物 - [ ] DPML Protocol RFC 文档（英文） - [ ] 协议概述页面（中英文，网站用） - [ ] 核心规范页面（中英文，网站用） - [ ] BNF/ABNF 语法定义 - [ ] 验证规则文档 ## 参考 - RFC 2616 (HTTP/1.1) - RFC 7946 (GeoJSON) - HTML5 Specification - 现有的 `/Users/sean/Deepractice/projects/PromptX/packages/resource/resources/protocol/dpml.protocol.md` ## 里程碑 1. **Phase 1**: 协议框架和核心语法定义 2. **Phase 2**: Agent Domain详细规范 3. **Phase 3**: 扩展机制和插件系统规范 4. **Phase 4**: 其他领域规范（Task/Role/Workflow） --- **协作方式**：使用本issue作为RFC讨论和迭代的工作空间