添加初始文件结构

This commit is contained in:
sean
2025-05-15 11:45:58 +08:00
parent 132c4442d6
commit 56552d49c6
18 changed files with 1986 additions and 0 deletions

View File

@ -0,0 +1,81 @@
# context 应用协议
> **TL;DR:** context标签用于定义AI系统中各类上下文信息的结构和语义采用简单直观的HTML风格属性标记专注于"什么是上下文"是实现CAP(情境感知提示模式)的核心表达机制。
## 🔍 基本信息
**标签名:** `<context>`
### 目的与功能
context标签在提示工程中提供了情境信息的标准定义方式主要功能包括
- 定义上下文信息的名称和分类
- 提供简洁明了的上下文描述
- 支持基本的元数据标注
- 为其他模式提供情境依赖的决策支持
## 📝 语法定义
```ebnf
(* EBNF形式化定义 *)
context_element ::= '<context' attributes? '>' content '</context>'
attributes ::= (' ' attribute)+ | ''
attribute ::= name '="' value '"'
name ::= [a-zA-Z][a-zA-Z0-9_-]*
value ::= [^"]*
content ::= text
text ::= (* 任何文本内容,用于简要描述上下文 *)
```
## 🧩 语义说明
context标签用于在提示词中定义上下文信息。采用简洁的HTML风格属性标记方式通过id指定唯一标识符通过class指定分类标签内容直接描述该上下文的含义。它作为CAP模式的具体实现为AI系统提供了清晰简洁的上下文定义能力。实际的上下文感知执行逻辑由executing协议负责实现。
## 💡 最佳实践
### 核心属性
context标签主要使用以下属性
- **id**: 定义上下文的唯一标识符,如`id="rootDir"`, `id="userName"`
- **class**: 定义上下文的分类/维度,如`class="project"`, `class="user"`, `class="system"`
### 内容组织
context标签内容应简洁明了直接描述该上下文的含义和用途无需复杂的结构和格式。
### 维度分类指南
使用class属性定义context维度时建议遵循以下标准分类
- **project**: 项目相关上下文,如根目录、语言、框架等
- **user**: 用户相关上下文,如用户名、偏好、技能水平等
- **system**: 系统相关上下文,如操作系统、硬件资源等
- **environment**: 环境相关上下文如IDE、终端、网络状况等
- **task**: 任务相关上下文,如当前目标、进度、限制条件等
## 📋 使用示例
```html
<!-- 项目根目录 -->
<context id="rootDir" class="project">项目根目录路径</context>
<!-- 项目编程语言 -->
<context id="language" class="project">项目主要编程语言</context>
<!-- 项目框架 -->
<context id="frameworks" class="project">项目使用的框架列表</context>
<!-- 操作系统类型 -->
<context id="osType" class="system">操作系统类型</context>
<!-- 用户名称 -->
<context id="userName" class="user">用户名称</context>
<!-- IDE类型 -->
<context id="ideType" class="environment">集成开发环境类型</context>
<!-- 任务目标 -->
<context id="taskGoal" class="task">当前任务的主要目标</context>
```