@yuechou/omp-mode

Oh My Pi Mode + Skill + Extension Management System.

Ported from pi-mode for Oh My Pi compatibility.

安装

# npm
npm install -g @yuechou/omp-mode

# omp
omp install @yuechou/omp-mode

配置

通过 omp 标准环境变量自定义目录：

| 环境变量 | 默认值 | 说明 | |----------|--------|------| | PI_CONFIG_DIR | .omp | 配置根目录 | | PI_CODING_AGENT_DIR | ~/.omp/agent | Agent 主目录 |

示例：

# 使用自定义目录
export PI_CODING_AGENT_DIR="/opt/omp/agent"
omp -e @yuechou/omp-mode

功能

模式管理

• /mode — 显示当前模式和可用模式
• /mode list — 列出所有模式
• /mode create <name> — 创建新模式
• /mode <name> — 切换到指定模式

系统提示替换

每个模式可以有自己的 agents.md 文件，定义该模式的角色和指南：

~/.omp/agent/modes/
├── coding/
│   ├── agents.md      ← coding 模式的角色定义
│   ├── skills/        ← coding 模式的技能
│   └── extensions/    ← coding 模式的扩展
├── research/
│   ├── agents.md
│   ├── skills/
│   └── extensions/
└── all/               ← 所有模式共享的基础层
    ├── agents.md
    ├── skills/
    └── extensions/

扩展上下文标记协议

其他扩展可以用 mode 标签包裹系统提示注入：

<extension_context mode="coding,research">
...content...
</extension_context>

• mode="all" 或无 mode 属性 = 始终激活
• mode="coding,research" = 仅在 coding 或 research 模式下激活

工具过滤

每个模式可以限制可用工具：

const MODE_TOOLS = {
  all: [],  // 空 = 所有工具
  coding: ["read", "write", "edit", "bash", "grep", "find", "ls"],
  research: ["read", "grep", "find", "ls"],
};

工具

| 工具 | 功能 | |------|------| | mode_list | 列出所有可用模式 | | mode_switch | 切换到指定模式 | | mode_create | 创建新模式 |

命令

| 命令 | 功能 | |------|------| | /mode | 显示当前模式 | | /mode list | 列出所有模式 | | /mode create <name> | 创建新模式 | | /mode <name> | 切换模式 |

事件

| 事件 | 说明 | |------|------| | mode_ready | 会话启动时发布，包含 getCurrentMode, isActiveMode, isActiveForMode | | mode_changed | 模式切换时发布，包含新的 mode 和辅助函数 |

与其他扩展集成

其他扩展可以监听模式事件：

pi.events.on("mode_ready", (data) => {
  const { getCurrentMode, isActiveMode, isActiveForMode } = data;
  // 使用这些函数检查当前模式
});

pi.events.on("mode_changed", (data) => {
  const { mode } = data;
  // 响应模式切换
});

目录结构

~/.omp/agent/
├── modes/
│   ├── coding/
│   │   ├── agents.md
│   │   ├── skills/
│   │   └── extensions/
│   ├── research/
│   │   ├── agents.md
│   │   ├── skills/
│   │   └── extensions/
│   └── all/
│       ├── agents.md
│       ├── skills/
│       └── extensions/
├── skills/           ← 全局技能
└── extensions/       ← 全局扩展

相关链接

• pi-mode - Pi 版本
• @yuechou/omp-memory - 记忆系统