跳到正文
cccskills
免费在 GitHub 公开

add-provider

Scaffold a new model provider for Forge — class implementation, registry wiring, providerEnum entry, local-catalog classification, and unit test with mocked transport. Use for anything under src/models/.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.2 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

/add-provider — add a new model provider

Providers in Forge follow a uniform shape (see src/models/ollama.ts, src/models/openai.ts, src/models/anthropic.ts). Copy the shape, don't invent a new one.

Provider name: $ARGUMENTS.

1. Provider class — src/models/$ARGUMENTS.ts

  • Export a class that matches the shape of existing providers (availability probe, chat/complete, token counting, streaming).
  • Availability probe must be ~1.5s max. Long timeouts block the REPL cold-start budget.
  • Use undici for HTTP (already a dependency). Do not add axios, node-fetch, or similar.
  • Redact credentials via src/security/redact.ts before any log call.
  • Map transport errors to ForgeRuntimeError with the right retryable flag and a recoveryHint where possible.

2. Registry — src/models/registry.ts

  • Add the provider id to providerEnum.
  • Register the class in initProviders.
  • If the provider is local (Ollama-style, runs on the user's machine), add it to isLocalProvider.

3. Catalog — src/models/local-catalog.ts

  • Add model id → family classification there.
  • Do not write regexes inside your provider to detect model capabilities. The catalog is the single source of truth.

4. Router — src/models/router.ts

  • Verify the router can reach the new provider via the standard routing rules. If routing needs a change, update the router and add a test in test/unit/adapter.test.ts.

5. Unit test

  • Mock the transport (see test/unit/adapter.test.ts for the pattern).
  • Cover: availability probe success/failure, chat/complete happy path, 429 retry logic, auth failure surfaces a non-retryable structured error.

6. Docs

  • Update the provider table in docs/ARCHITECTURE.md §6.
  • Bump the provider count in README.md "At a glance" if applicable.
  • Add a one-line setup note to docs/SETUP.md.

Run /verify to close the loop.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

add-agent

免费

Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style). Use when adding anything to src/agents/.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

add-agent

免费

Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style).

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

Scaffold a new model provider for Forge — class, registry wiring, providerEnum entry, local-catalog classification, router check, and a unit test with mocked transport.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

add-tool

免费

Scaffold a new Forge tool end-to-end — type, implementation, registration, permission/risk classification, and unit test. Use when adding anything to src/tools/.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

add-tool

免费

Scaffold a new Forge tool — implementation, registration, permission/risk metadata, sandbox routing, and a unit test. Use when adding anything to src/tools/.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

add-tool

免费

Scaffold a new Forge tool end-to-end — implementation, registration, permission/risk metadata, sandbox routing, and a unit test.

中文简介正在准备中。当前显示原文说明。

hoangsonww/Forge-Agentic-Coding-CLI262026年9月28日 更新

查看 hoangsonww 的全部技能

报告此技能的问题