面向编程智能体的 System One
安装 System One agent skill，在 Claude Code / Cursor / Codex 中做分类、工具路由或完成检查。
编程智能体可以先安装一份简短指令，再按已发布的 TypeScript SDK 和托管 HTTP API 编写接入代码。该技能本身不会创建工具、不会自行消耗积分，也不会授予执行权限。
本页用于把接入说明安装进编程智能体。若要在自己的智能体产品里加入决策步骤，请看接入智能体。
常见问题
Q: 如何把 System One skills 加到 Claude Code？
A: 安装 System One agent skill，然后粘贴分类、工具路由或完成检查提示词。Skill 调用托管 System One API 并返回类型化决策。
Q: Cursor 或 Codex 能用吗？
A: 可以。同一 skill/提示词模式适用于 Cursor 与 Codex；执行仍留在智能体本地。
Q: 这里的 Claude Code skill 是什么？
A: 可复用的 agent skill，让 Claude Code 通过 System One 的 Choice、Score 或 Noul 做结构化决策，而不是自由发挥猜测。
一条命令安装
公开的 skills CLI 可以从 GitHub 路径安装 SKILL.md 包：
npx skills add system-one-ai/system-one-web/skills/system-oneCLI 也接受仓库加技能名、main 的 tree URL、本地克隆，或带 #branch 的 Git URL。
不要使用 /tree/<含斜杠的分支名>/，CLI 无法解析这类路径。
npx skills add system-one-ai/system-one-web --skill system-one
npx skills add https://github.com/system-one-ai/system-one-web/tree/main/skills/system-one
npx skills add ./skills/system-one
npx skills add /absolute/path/to/system-one-web/skills/system-one
npx skills add https://github.com/system-one-ai/system-one-web.git#<branch> --skill system-one也可以直接从本站安装，不必克隆仓库。这条安装方式不经过 npm：
npx skills add https://system-one.dev手动方式：把 skills/system-one/ 复制到 .agents/skills/system-one/，再把 AGENTS.md 贴进项目说明、把 cursor-rules.mdc 贴进 .cursor/rules/。
先配置一次
在 API 密钥控制台创建平台密钥，只放在服务端：
export SYSTEM_ONE_API_KEY="replace-with-your-platform-key"
export SYSTEM_ONE_BASE_URL="https://system-one.dev/v1"
# 本地 `pnpm dev`：
# export SYSTEM_ONE_BASE_URL="http://localhost:7001/v1"省略 model，让托管 API 使用部署默认模型。不要编造或写死模型 ID。若要换用其他模型，让智能体调用 GET /v1/models，并把准确的 name 写入请求或 SYSTEM_ONE_MODEL。托管纯文本 SDK 组合为 @system-one-ai/core@0.6.0、@system-one-ai/adapter-system-one@0.6.0 和 @system-one-ai/transport-fetch@0.6.0。公开接口只有 GET /v1/models 和 POST /v1/systemone。细节见托管快速开始和 API 参考。
计费
新账号注册即送 100 积分。费用按请求大小算：每 4KB 算一块，不足 4KB 也按一块。费用 = 块数 × 问题数 × 模型单价。调用失败不扣积分。
可粘贴的提示词
安装完成后，复制下面其中一条。每条都要求智能体提出类型明确的决策，执行权留在你的应用。
添加分类器
请使用 System One 技能。添加一个服务端分类器，用 Choice 把这条客服消息分到 billing、support 或 review。只安装 @system-one-ai/core@0.6.0、@system-one-ai/adapter-system-one@0.6.0 和 @system-one-ai/transport-fetch@0.6.0。省略 model，使用 API 默认模型；不要编造或写死模型 ID。持久保存 Idempotency-Key。返回所选团队、概率和置信度。如果缺少 confidence，或最高的两个概率接近，则分到 review。不要分派工单或联系客户。
消息：年费套餐扣了两次，请退掉多收的那一笔。路由工具
请使用 System One 技能，在连接任何工具调度器之前先做决策。用 Choice 在白名单工具 search_docs、ask_user、human_review 中选择。省略 model，使用 API 默认模型。maxRetries 保持 0，并把 Idempotency-Key 与完整请求一起保存。如果答案缺失、请求失败或置信度低，选择 human_review。不要执行工具、不要编造工具名，也不要把 API 密钥放进提示词。
用户请求：能说明一下积分如何计算吗？完成检查
请使用 System One 技能检查这项任务是否看起来已完成。用 Noul 判断“既定目标是否已达成”，再用 Choice 在 complete、verify_more、incomplete 中选择。省略 model，使用 API 默认模型。概率接近 0.5、答案缺失或请求失败都视为 verify_more。不要把工作标为完成，也不要跳过测试。
目标：为生产端点增加 API 密钥认证。
已完成：加入了 Authorization 检查和密钥查找。
验证：单元测试通过；尚未测试生产请求和限流行为。智能体不应把 SYSTEM_ONE_API_KEY 写入源码或对话。高概率不是退款、调用工具或关闭任务的许可。见决策原语和智能体工作流中的阈值。