核心概念概览

WopalSpace 基于三个核心概念构建：空间 (Space)、知识本体 (Ontology) 和 技能 (Skills)。理解这些概念是使用 WopalSpace 的基础。

💡 提示：这三个概念相互协作，共同构成了 WopalSpace 的完整生态系统。你可以把它们想象成：Space 是你的工作室，Ontology 是工作室的布局图，Skills 是工作室里的工具。

🏠

🏠 空间 (Space)

工作隔离单元 — 每个空间都是一个独立的工作环境，包含项目文件、配置、记忆和技能。空间之间完全隔离，互不干扰，让你专注于当前任务。

🗺️

🗺️ 知识本体 (Ontology)

结构定义 — Ontology 是空间的”蓝图”，通过 STRUCTURE.md 定义项目结构、模块关系和开发规则，让 AI 助手准确理解你的项目。

🔧

🔧 技能 (Skills)

能力扩展 — 可插拔的能力模块，为 AI 助手提供专业功能，如代码审查、测试生成、文档编写等。支持内置、社区和自定义技能。

空间 (Space)

空间是 WopalSpace 的核心组织单位。每个空间都是一个独立的工作上下文，包含：

  • 项目文件：你的代码、文档、资源
  • 配置：空间特定的设置和规则
  • 记忆：AI 助手的上下文记忆
  • 技能：可用的 AI 能力扩展

空间结构

一个标准的空间结构如下：

.wopal-space/
├── STRUCTURE.md          # 空间结构定义
├── REGULATIONS.md        # 空间守则和规则
├── memory/              # 记忆存储
│   ├── USER.md          # 用户档案
│   ── context.json     # 上下文缓存
├── logs/                # 操作日志
└── backup/              # 自动备份

空间隔离

每个空间完全独立，互不干扰：

特性说明
配置隔离每个空间有独立的配置文件
依赖隔离不同空间可以使用不同的依赖版本
记忆隔离AI 助手不会混淆不同空间的上下文
权限隔离可以设置不同的访问权限

⚠️ 注意：虽然空间之间是隔离的，但你仍然可以通过配置让某些技能或记忆在空间之间共享。

知识本体 (Ontology)

Ontology 定义了空间的”结构真相”。它是空间的蓝图，告诉 AI 助手：

  • 空间包含什么
  • 各部分如何组织
  • 它们之间的关系

本体文件

STRUCTURE.md 是本体文件的核心：

# 空间结构

## 模块
- `src/` - 源代码
- `docs/` - 文档
- `tests/` - 测试用例

## 规则
- 所有代码必须通过 TypeScript 检查
- 单元测试覆盖率 > 80%
- 提交前必须运行 lint

本体的作用

  1. 自动发现：AI 助手通过本体了解空间结构
  2. 智能路由：根据本体将任务路由到正确位置
  3. 一致性检查：确保空间结构符合定义
  4. 版本控制：本体文件可以纳入 Git 管理

技能 (Skills)

技能是 WopalSpace 的扩展机制。每个技能都是一个独立的能力模块：

skill/
├── name.md          # 技能名称和描述
├── commands/        # 可执行命令
├── prompts/         # AI 提示词模板
└── references/      # 参考资料

内置技能

WopalSpace 提供以下内置技能：

技能名称功能使用场景
code-review代码审查Pull Request 自动审查
test-generator测试生成自动生成单元测试
doc-writer文档编写自动生成文档
git-helperGit 辅助智能提交、分支管理
deploy-assistant部署辅助自动化部署流程

自定义技能

你可以创建自己的技能：

  1. 创建技能目录：
mkdir -p .wopal-space/skills/my-skill
  1. 定义技能：
# my-skill

## 描述
我的自定义技能，用于...

## 命令
- `generate-report`: 生成项目报告

## 示例
> 生成报告

AI: 正在分析项目结构...
  1. 注册技能：

在 STRUCTURE.md 中添加：

## Skills
- `my-skill`

三者协同

Space、Ontology、Skills 如何协同工作？

📊 协同工作流：当你执行一个任务时，WopalSpace 会按照以下流程工作：

  1. 读取 Ontology 了解项目结构
  2. 根据任务类型选择合适的 Skills
  3. 在 Space 的上下文中执行操作
  4. 将结果保存到 Space 并更新记忆

工作流程示例

假设你要创建一个新的 API 端点：

  1. AI 读取 Ontology

    AI 查看 STRUCTURE.md，了解：

    • API 代码应该在 src/api/ 目录
    • 需要创建路由、控制器、测试

  2. AI 调用 Skills

    根据任务类型，AI 自动使用：

    • code-review 技能审查代码
    • test-generator 生成测试
    • doc-writer 更新 API 文档

  3. 在 Space 中执行

    所有操作在当前空间内完成：

    • 文件创建在正确的目录
    • 配置使用空间特定设置
    • 记忆更新到空间上下文

协同架构图

─────────────────────────────────────┐
│           WopalSpace                │
│                                     │
│  ┌──────────  ┌──────────┐        │
│  │ Ontology │→│   Space  │        │
│  │ (蓝图)   │  │ (执行环境)│        │
│  └──────────┘  └──────────┘        │
│       ↓            ↑                │
│  ┌──────────┐      │                │
│  │  Skills  │──────┘                │
│  │ (能力)   │                       │
│  └──────────┘                       │
└─────────────────────────────────────┘

最佳实践

1. 保持 Ontology 简洁

# 好的 Ontology
## 模块
- `src/` - 源代码
- `docs/` - 文档

# 不好的 Ontology
## 模块
- `src/` - 源代码（包含组件、工具、服务等）
- `src/components/` - React 组件（Button、Input、Modal 等）
- `src/components/Button/` - 按钮组件...

2. 定期更新记忆

wopal memory sync

3. 技能版本控制

将技能纳入 Git 管理：

git add .wopal-space/skills/
git commit -m "feat: add code-review skill v1.2"

4. 空间备份

定期备份空间配置：

wopal backup

总结

概念角色类比
Space工作空间你的工作室
Ontology结构定义工作室的布局图
Skills能力扩展工作室里的工具

理解这三个概念后，你就能充分利用 WopalSpace 的强大功能。