@genee/omp-opsx-addon 0.1.0

package/README.md

@@ -0,0 +1,83 @@
+# omp-opsx-addon
+
+> Pi Extension: OpenSpec workflow orchestration — coder/reviewer/planner agents, session title & progress.
+
+---
+
+## 架构
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  主 agent (Orchestrator)                                 │
+│  system prompt 由 plugin 注入: model 选择决策 + 路由表    │
+│                                                          │
+│  用户说 "@coder 实现 X" → transform 成 task 委派指令      │
+└───────────────────────┬─────────────────────────────────┘
+                        │
+                ┌───────▼────────┐
+                │  omp 内置 task  │
+                │ (所有 role)     │
+                │  原生 subagent  │
+                └───────┬────────┘
+                        │
+               ┌────────┴──────────┐
+               │ .omp/agents/      │
+               │ coder / planner   │
+               │ code-reviewer /   │
+               │ proposal-reviewer │
+               └───────────────────┘
+```
+
+**核心机制**：主 agent 用 omp 内置 `task` 工具委派所有 4 个角色。model 选择由插件自动完成，不再有 acpx（外部 agent）路径。
+
+---
+
+## Dispatch 配置 (`opsx.yml`)
+
+两层 `opsx.yml`（全局 `~/.omp/agent/opsx.yml` + 项目 `<cwd>/.omp/opsx.yml`，项目逐键覆盖全局）。
+
+```yaml
+# role 值可以是：
+#   'auto'                       — 插件按 tier + usage 自动选 model
+#   'smol' / 'slow' / 'default'  — OMP role alias（由 OMP modelRoles 解析）
+#   'gpt-5-pro'                  — 明确 model id
+#   'anthropic/claude-opus-4-6'  — provider/model 完全限定
+
+coder: auto
+reviewer: slow
+planner: slow
+proposal-reviewer: default
+
+# 可选：限制自动选择时使用的 model 池
+model_allowlist:
+  - "anthropic/claude-opus-*"
+  - "openai/gpt-5*"
+
+# 可选：自定义 tier 评分
+tiers:
+  - pattern: "*opus*"
+    tier: top
+  - pattern: "openai/gpt-4o-mini"
+    tier: low
+
+# 可选：role → tier 期望
+role_tiers:
+  planner: top
+```
+
+---
+
+## Model 选择
+
+插件启动时从 `ModelRegistry.getAvailable()` 拿所有有鉴权的 model，从 `authStorage.fetchUsageReports()` 拉用量报告，然后按 role → tier 期望 + 用量健康度自动选最优 model。
+
+决策日志打印到 stderr：`[omp-opsx-addon] planner → anthropic/claude-opus-4-6 (tier=top, gap=0, remaining=0.80)`
+
+---
+
+## 开发
+
+```bash
+npm run typecheck
+bun test
+```