Agent Skills › muratgur/ordinus › provider-runtime-adapter

provider-runtime-adapter

GitHub

设计本地 AI CLI（如 Codex、Claude）的运行时适配器，实现提供商中立性。核心功能包括检测、认证状态检查、运行启动与取消、事件解析及输出捕获。强调由 Electron 主进程管理，确保可观测性与安全性，避免渲染器直接执行命令。

.claude/skills/provider-runtime-adapter/SKILL.md muratgur/ordinus

Trigger Scenarios

开发或维护本地 AI CLI 集成处理 Codex 或 Claude 的检测、认证、运行生命周期、进程管理及取消逻辑实现提供商中立的运行时接口

Install

npx skills add muratgur/ordinus --skill provider-runtime-adapter -g -y

More Options

Non-standard path

npx skills add https://github.com/muratgur/ordinus/tree/master/.claude/skills/provider-runtime-adapter -g -y

Use without installing

npx skills use muratgur/ordinus@provider-runtime-adapter

指定 Agent (Claude Code)

npx skills add muratgur/ordinus --skill provider-runtime-adapter -a claude-code -g -y

安装 repo 全部 skill

npx skills add muratgur/ordinus --all -g -y

预览 repo 内 skill

npx skills add muratgur/ordinus --list

SKILL.md

Frontmatter

{
    "name": "provider-runtime-adapter",
    "description": "Design Ordinus provider runtime adapters for local AI CLIs. Use when working on Codex, Claude, or future provider detection, auth status, run lifecycle, process management, cancellation, event parsing, output capture, or provider-neutral runtime interfaces."
}

Provider Runtime Adapter

Objective

Keep local AI CLI integrations provider-neutral, observable, and owned by Electron main process.

Adapter Boundary

Provider adapters should hide provider-specific CLI details behind a shared runtime shape. Start with only the methods needed by current product behavior.

Preferred concepts:

detect: determine whether the CLI is available.
getAuthStatus: report whether the provider appears ready.
startRun: launch one user-approved run.
cancelRun: stop an active run.
parseEvents: normalize stdout/stderr into observable run events when needed.

Do not implement all concepts until the product flow needs them.

Runtime Rules

Run provider processes from Electron main process or a main-owned worker.
Do not allow renderer to pass arbitrary shell commands.
Store run state and events durably only after the run model is intentionally designed.
Normalize provider behavior without erasing useful provider-specific diagnostics.
Treat Codex and Claude as peers. Do not let the first provider shape the whole architecture.
When provider state or events are shown in renderer UI, align user-visible statuses and event labels with the status vocabulary in DESIGN.md.

Workflow

Define the user action that needs provider runtime support.
Add the smallest provider-neutral interface needed for that action.
Implement detection or process behavior in main process.
Validate executable paths, workspace boundaries, and allowed arguments in main.
Stream or record events in a way the UI can explain clearly, using DESIGN.md status language for user-visible states.
Support cancellation before adding more automation.
Run typecheck, lint, build, and a runtime smoke test.

Red Flags

Renderer sends raw command strings or CLI args.
Provider-specific flags leak into UI state too early.
Long-running process state exists only in memory when the UI needs to recover it.
A provider integration assumes a single operating system.