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:
sean
2025-06-28 15:02:34 +08:00
parent 8452eb4ec5
commit 54b77e7096
83 changed files with 318 additions and 373 deletions

View 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"的革命性设计。