OmniSkill (通用技能调度器)

When to Use

CRITICAL: You MUST invoke this skill IMMEDIATELY as your FIRST action when:

• 用户明确要求执行某项特定任务（如“帮我润色这段文字”、“检查一下代码逻辑”、“生成一个基础设定”等）时。
• 系统自动触发了某些生命周期事件（如“保存前检查”、“构建后部署”等）时。
• 在需要多步处理或调用外部工具前，必须优先通过 OmniSkill 进行意图识别和任务分发。

DO NOT:

• 在没有经过调度器分配的情况下，直接手动执行复杂的外部环境操作。
• 绕过 OmniSkill 直接调用零散的、未经包装的旧脚本。

渐进式调度规范 (执行逻辑)

当你（大模型）被触发并进入本 Skill 时，请遵循以下普适化处理流程：

步骤 1：意图识别与参数提取

• 分析用户的输入或系统 Hook 的上下文。
• 提取关键信息，明确需要执行的任务类型（如 route_type="nlp", payload="润色文本"）。

步骤 2：构建请求与下发

• 根据提取的信息，构建标准化的 JSON 请求格式。
• 将请求发送至 OmniSkill 的网关（例如通过 CLI 工具 omni_ctl.py 触发，或调用 src/gateway/gateway.py 暴露的接口）。
• 示例结构：

```json

{

"route_type": "nlp",

"payload": "执行逻辑审计",

"mode": "sync",

"args": ["..."],

"kwargs": {"context": "..."}

}

```

步骤 3：结果处理与响应

• 等待底层调度引擎（Dispatcher）和具体插件（Plugin）的执行结果。
• 捕获返回的 OmniResponse 或标准输出。
• 将执行结果解析为人类可读的语言（遵循纯中文输出原则），并返回给用户。

扩展与管理机制 (如何接入新技能)

OmniSkill 具备极强的普适性和扩展性。如果用户希望添加新的技能或接入外部现成的工具包：

1. 统一打包：使用内置的打包器将外部目录转化为标准核心包。

```bash

# 必须进入项目目录执行

cd ./omni-skill

python src/cli/omni_packager.py --source <原始路径> --target <目标包路径>

```

1. 注册与挂载：将生成的包注册到调度中枢。

```bash

python src/cli/omni_ctl.py register --name <技能名称> --runtime-type <运行环境>

```

1. 即时生效：注册完成后，无需重启系统。下次调度时，底层引擎将通过 LRU 懒加载机制自动挂载并执行该技能。若发生冲突或异常，可在 30 秒内执行 omni_ctl.py rollback 安全回滚。

当前可用子技能列表 (Available Sub-Skills)

当前暂无已注册的子技能。

(此列表由 omni_ctl 自动维护，请勿手动修改)