refactor: 重构/prompt/目录为/resource/ - 更符合资源引用协议语义
- 重命名核心目录: /prompt/ → /resource/ - 更新PackageDiscovery中所有硬编码路径引用 - 重新生成package.registry.json,61个资源全部更新为@package://resource/路径 - 批量更新文档中的路径引用,保持一致性 - 目录结构保持不变:domain/, core/, protocol/, tool/子目录结构完全一致 重构原因: 随着tool协议的加入,prompt目录名称不再准确描述系统本质 重构价值: 为未来资源生态扩展奠定清晰的命名基础 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
79
resource/protocol/pateoas.protocol.md
Normal file
79
resource/protocol/pateoas.protocol.md
Normal file
@ -0,0 +1,79 @@
|
||||
# PATEOAS 协议 - Prompt as the Engine of Application State
|
||||
|
||||
> **TL;DR:** PromptX = AI的诸葛锦囊,通过 PATEOAS 让 AI 无需记忆,仅凭 Prompt 引导完成专家级任务
|
||||
|
||||
## 🎯 核心理念
|
||||
|
||||
**AI use CLI get prompt for AI**
|
||||
|
||||
```
|
||||
通用AI → PromptX CLI → 获取专业提示词 → 变身专家AI → 提供专业服务
|
||||
```
|
||||
|
||||
### 三大解决方案
|
||||
- **上下文遗忘** → 锦囊自包含,每个命令独立执行
|
||||
- **注意力分散** → 分阶段专注,每锦囊专注单一任务
|
||||
- **能力局限** → 即时专家化,通过提示词获得专业能力
|
||||
|
||||
## 🎒 五大锦囊状态机
|
||||
|
||||
```
|
||||
🏗️init → 👋hello → ⚡action → 📚learn → 🔍recall → 循环
|
||||
```
|
||||
|
||||
| 锦囊 | 职责 | 输出 |
|
||||
|------|------|------|
|
||||
| `init` | 环境准备 + 理念传达 | 系统介绍 + PATEOAS导航 |
|
||||
| `hello` | 角色发现 | 专家角色清单 + 激活指引 |
|
||||
| `action` | 角色激活 | 专业提示词 + 学习建议 |
|
||||
| `learn` | 专家变身 | 领域知识 + 应用指引 |
|
||||
| `recall` | 经验检索 | 相关记忆 + 持续工作 |
|
||||
|
||||
## 📋 PATEOAS 实现要求
|
||||
|
||||
每个锦囊输出必须包含三层:
|
||||
|
||||
### 1. 锦囊目的 (Purpose)
|
||||
```
|
||||
🎯 锦囊目的:[功能描述]
|
||||
```
|
||||
|
||||
### 2. 锦囊内容 (Content)
|
||||
```
|
||||
📜 锦囊内容:
|
||||
[核心提示词/专业知识]
|
||||
```
|
||||
|
||||
### 3. PATEOAS导航 (Navigation)
|
||||
```
|
||||
🔄 下一步行动:
|
||||
- [操作名]: [描述]
|
||||
命令: promptx [command]
|
||||
|
||||
📍 当前状态:[state]
|
||||
```
|
||||
|
||||
## 🎨 设计原则
|
||||
|
||||
- **锦囊自包含**:每个命令包含完整执行信息
|
||||
- **串联无依赖**:即使AI忘记上文,也能继续执行
|
||||
- **分阶段专注**:每个锦囊只关注当前任务
|
||||
- **Prompt驱动**:每个输出引导AI发现下一步操作
|
||||
|
||||
## ⚡ 状态转换规则
|
||||
|
||||
```mermaid
|
||||
stateDiagram-v2
|
||||
[*] --> init
|
||||
init --> hello
|
||||
hello --> action
|
||||
action --> learn
|
||||
learn --> recall
|
||||
recall --> recall: 持续工作
|
||||
recall --> hello: 切换角色
|
||||
learn --> action: 重新激活
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**核心价值:** 让AI既是工具使用者,也是被工具赋能者,实现"AI use CLI get prompt for AI"的革命性设计。
|
||||
Reference in New Issue
Block a user