Agent Skills › o8-run/o8 › o8-code

o8-code

GitHub

指导检查和修改 o8 应用（Next.js/React/Tauri）的代码、API 路由、模型调用及架构契约。规范 TypeScript 风格、端口注册、API 中间件安全策略及 AI SDK 使用边界，确保遵循运行时真相和严格模式。

.agents/skills/o8-code/SKILL.md o8-run/o8

Trigger Scenarios

需要修改或检查应用代码结构时涉及 API 路由、端口配置或架构变更时编写 TypeScript 代码需遵循特定规范和限制时

Install

npx skills add o8-run/o8 --skill o8-code -g -y

More Options

Non-standard path

npx skills add https://github.com/o8-run/o8/tree/main/.agents/skills/o8-code -g -y

Use without installing

npx skills use o8-run/o8@o8-code

指定 Agent (Claude Code)

npx skills add o8-run/o8 --skill o8-code -a claude-code -g -y

安装 repo 全部 skill

npx skills add o8-run/o8 --all -g -y

预览 repo 内 skill

npx skills add o8-run/o8 --list

SKILL.md

Frontmatter

{
    "name": "o8-code",
    "description": "Inspect or change application code, API behavior, routing, model calls, persistence, or architecture contracts."
}

Code and architecture

o8 is a Next.js 16 and React 19 app in a Tauri v2 shell. Desktop and mobile are separate surfaces. Orchestrator backends in src/lib/lane/orchestrator-backends/ and worker adapters in src/lib/runtimes/ are separate systems. Inspect the current registries before changing routing.
Runtime code is the source of truth for ports, routes, commands, and registrations. Never hardcode API or WebSocket ports, user home paths, or stale inventory counts. Use the existing resolvers and registries.
API middleware is default-deny for /api/*. Public routes require deliberate narrow allowlisting; externally reachable self-authenticating routes must verify their own credentials. Return structured route errors rather than throwing to the framework.
TypeScript is strict. Use the existing two-space, single-quote, semicolon style and @/ imports. The default file ceiling is 800 lines; existing waivers do not authorize new ones.
Ad-hoc model calls use the existing proxy and routing layer. The sanctioned AI SDK import boundary is src/lib/chat/gateway-client.ts. Strict-mode MCP schemas keep a plain top-level object; validate conditional relationships in the handler.
Architecture and extension contracts: docs/internals/system-architecture.md, docs/internals/runtime-adapter-contract.md, and the implementation named above. Historical inventories in docs are orientation, not runtime truth.