Sikaru Docs

Sikaru 插件和技能

适用于 Claude Code 和 Codex 的官方 Sikaru 插件，以及供任何可加载 SKILL.md 文件的 Agent 使用的相同技能：Cursor、Devin、Capy、Pi、OpenCode、Gemini CLI、GitHub Copilot、Amp、Cline、Windsurf、Goose 等。你的编码 Agent 将学会如何为你注册 Sikaru、选择项目并使用它：调用目录中的模型、请求 System One 做出决策、编写并发布托管 Agent、在 RL 环境中评估它们，以及上传轨迹。

该插件还会通过 MCP 连接 Sikaru 的公开文档（sikaru-docs、https://docs.sikaru.ai/_mcp/server）。该服务为只读服务，无需凭据。

安装

Claude Code

claude plugin marketplace add aadi-labs/sikaru-plugins
claude plugin install sikaru@sikaru

Codex

codex plugin marketplace add aadi-labs/sikaru-plugins
codex plugin add sikaru@sikaru

任何支持技能的 Agent

npx skills add aadi-labs/sikaru-plugins

安装程序会检测你拥有的 Agent，并询问要安装到哪里。若要选择特定 Agent，请使用 -a 并传入其名称（添加 -g 可为你的用户安装，而不是安装到项目中）：

Agent	命令
Pi	npx skills add aadi-labs/sikaru-plugins -a pi
OpenCode	npx skills add aadi-labs/sikaru-plugins -a opencode
Cursor	npx skills add aadi-labs/sikaru-plugins -a cursor
Devin for Terminal	npx skills add aadi-labs/sikaru-plugins -a devin
Gemini CLI	npx skills add aadi-labs/sikaru-plugins -a gemini-cli
GitHub Copilot	npx skills add aadi-labs/sikaru-plugins -a github-copilot
Amp	npx skills add aadi-labs/sikaru-plugins -a amp
Cline	npx skills add aadi-labs/sikaru-plugins -a cline
Windsurf	npx skills add aadi-labs/sikaru-plugins -a windsurf
Goose	npx skills add aadi-labs/sikaru-plugins -a goose
Factory Droid	npx skills add aadi-labs/sikaru-plugins -a droid
Kilo Code	npx skills add aadi-labs/sikaru-plugins -a kilo
Roo Code	npx skills add aadi-labs/sikaru-plugins -a roo
Zed	npx skills add aadi-labs/sikaru-plugins -a zed
Warp	npx skills add aadi-labs/sikaru-plugins -a warp
OpenHands	npx skills add aadi-labs/sikaru-plugins -a openhands
Kiro CLI	npx skills add aadi-labs/sikaru-plugins -a kiro-cli
Qwen Code	npx skills add aadi-labs/sikaru-plugins -a qwen-code

任何其他能读取 SKILL.md 文件的 Agent 也适用：将 skills/ 中的文件夹复制到其技能目录即可。请参阅支持的 Agent 完整列表。

Capy

Capy 会将此仓库作为插件、技能和文档服务一并安装：打开设置 → MCP 和插件，选择从 GitHub 仓库安装，然后输入 https://github.com/aadi-labs/sikaru-plugins。在插件页面点击同步以获取新版本。若要将技能保留在单独的仓库中，请将它们安装到 Capy 读取仓库技能的位置：

npx skills add aadi-labs/sikaru-plugins -a universal

这会将技能写入 .agents/skills/，Capy、Cursor、Codex、OpenCode、Pi 和其他 Agent 都会读取该目录。

在其他 Agent 中通过 MCP 访问文档

Claude Code、Codex 和 Capy 会从插件获取文档服务。对于其他环境，请将 https://docs.sikaru.ai/_mcp/server 添加为远程 MCP 服务（Streamable HTTP，无需凭据）：

• OpenCode，在 opencode.json 中： {"mcp": {"sikaru-docs": {"type": "remote", "url": "https://docs.sikaru.ai/_mcp/server"}}}
• Gemini CLI，在 ~/.gemini/settings.json 中： {"mcpServers": {"sikaru-docs": {"httpUrl": "https://docs.sikaru.ai/_mcp/server"}}}
• Cursor，在 .cursor/mcp.json 中： {"mcpServers": {"sikaru-docs": {"url": "https://docs.sikaru.ai/_mcp/server"}}}
• VS Code 中的 GitHub Copilot，在 .vscode/mcp.json 中： {"servers": {"sikaru-docs": {"type": "http", "url": "https://docs.sikaru.ai/_mcp/server"}}}

没有 MCP 的 Agent（例如 Pi）可以将相同文档作为 Markdown 阅读：从 https://docs.sikaru.ai/llms.txt 开始。

接下来向你的 Agent 提问

• “帮我设置 Sikaru。”
• “列出 Sikaru 模型，并与支持推理的最便宜模型对话。”
• “为这个仓库编写一个 Sikaru Agent，验证它并运行一个任务。”
• “针对在线 Agent 运行我的评估数据集，并显示失败项。”

技能

技能	用途
sikaru	启动任何 Sikaru 任务。它会转到下方的技能，并包含共享规则。
sikaru-setup	安装 CLI、注册或登录、选择项目、获取 API 密钥、添加额度
sikaru-inference	列出并比较目录中的模型，并通过 CLI 或 OpenAI 风格的 SDK 进行对话
sikaru-decision	针对文本或 JSON 状态，询问 System One 选择题、是非题和评分问题
author-sikaru-agent	通过一份 Markdown 文档编写、验证、审核、发布和运行托管 Agent
sikaru-evals	推送环境数据集，针对在线 Agent 运行评估，并查看失败情况
sikaru-traces	上传 OTLP、ATIF 或 OpenInference 跟踪记录，并查看运行轨迹

要求

这些技能依赖 sikaru CLI。需要使用包含 decision 和 credits 组的构建版本（sikaru decision --help 应能正常运行）：

curl -fsSL https://app.sikaru.ai/install.sh | sh   # macOS and Linux
npm install -g @aadi-labs/sikaru-cli               # any platform with Node.js 20+

代码使用已发布的 SDK，它们与 CLI 版本一致：

语言	安装	导入
Python	pip install sikaru-sdk 或 uv add sikaru-sdk	from sikaru_sdk import SikaruApi
TypeScript	npm install @aadi-labs/sikaru-sdk	import { SikaruApi } from "@aadi-labs/sikaru-sdk"

注册和登录都从 sikaru login 开始，该命令也会保存你的默认项目。没有 CLI 的 Agent 请访问 https://sikaru.ai/auth.md。代码、服务和 CI 使用在 SIKARU_API_KEY 中设置的项目 API 密钥，该密钥可在 https://app.sikaru.ai 的控制面板中创建。

工作需使用预付额度，Agent 也可以为其充值：sikaru credits add --amount 20 会创建一笔由 Agent 钱包支付的充值，即使组织是新建的也可以。用户也可以在 https://app.sikaru.ai 的 Billing 中保存银行卡，这还会额外添加一次性 $5 启动额度。

仓库布局

路径	内容
.claude-plugin/	Claude Code 插件和市场清单
.codex-plugin/、.agents/plugins/	Codex 插件和市场清单
.mcp.json	供 Claude Code 和 Codex 使用的 sikaru-docs MCP 服务
server.json	文档服务在 MCP Registry 中的条目 ai.sikaru/docs
plugin.json、mcp.json	Agent Plugins 清单和 MCP 服务，供 Capy 及其他遵循规范的宿主使用
skills/	技能；每项技能都包含一个 SKILL.md 和位于 agents/openai.yaml 中的 Codex 元数据
skills.sh.json	npx skills 使用的技能列表
scripts/validate.py	清单、技能和 CLI 命令检查

开发

python3 scripts/validate.py --cli "$(which sikaru)"
claude plugin validate .

--cli 检查会对技能中提到的每个 sikaru … 命令运行 -h。CLI 命令若被重命名或移除，检查就会失败。

许可证

MIT