
2026/04/08 21:34
**Show HN:** 「Skrun — どんなエージェントスキルもAPIとしてデプロイ」
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
Summary
ツールは、任意の Agent Skill(@skrun-dev/cli)を POSTSKILL.mdを介して呼び出し可能な API に変換します。これにより、マルチモデルで状態を保持するエージェントを構築・テスト・デプロイが簡単な CLI コマンドだけで行えます。/run
Quick start:npm install -g @skrun-dev/cli skrun init --from-skill ./my-skill # または `skrun init my-agent` skrun dev # http://localhost:3000 でローカルサーバーを起動 skrun test # テストの検証 skrun deploy # エージェントのビルド、プッシュ、および公開エージェントを呼び出す curl の例:
curl -X POST http://localhost:4000/api/agents/dev/my-skill/run \ -H "Content-Type: application/json" -d '{"input":"..."}'Configuration (
) では、モデル(Anthropic, OpenAI, Google Gemini Flash, Mistral, Groq with automatic fallback)、入力/出力、権限、状態、およびテストを指定します。agent.yaml
State & tools: エージェントは実行間でキー‑バリュー形式の状態を保持し、ローカル CLI スクリプトや MCP サーバー(例:)を呼び出すことができます。@playwright/mcp
Demo agents では、フレームワークを示す,code-review,pdf-processing,seo-audit,data-analyst,email-drafterが紹介されています。web-scraper
Registry & future steps:(例:.env)を設定し、GOOGLE_API_KEYを実行してレジストリを起動します。その後pnpm dev:registryでログインし、エージェントをプッシュしてからskrun login --token <token>に POST することで呼び出します。/api/agents/dev/<agent>/run
CLI commands には,init,init --from-skill,dev,test,build,deploy,push/pull,login/logoutが含まれます。logs <agent>
このプロジェクトは MIT ライセンスの下でオープンソースとして GitHub()にホストされており、https://github.com/skrun-dev/skrunの仕様、CLI の使用方法、および貢献ガイドラインを網羅したドキュメントが用意されています。agent.yaml
本文
任意の Agent Skill(SKILL.md)を POST /run で呼び出せる API に変換 – マルチモデル、ステートフル、オープンソース
クイックスタート
npm install -g @skrun-dev/cli # 既存のスキルをインポート → デプロイ → 呼び出し skrun init --from-skill ./my-skill skrun deploy curl -X POST localhost:4000/api/agents/dev/my-skill/run \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{"input": {"query": "analyze this"}}'
はじめに
新しいエージェントを作成する
skrun init my-agent cd my-agent # SKILL.md(指示書)と agent.yaml(設定)が生成されます
既存のスキルをインポート
skrun init --from-skill ./path-to-skill # SKILL.md を読み込み、2〜3つの質問を投げて agent.yaml を自動生成します
ローカルで開発・テスト
skrun dev # ✓ Server running at http://localhost:3000 # POST /run ready — watching for changes... skrun test # ✓ basic-test (output.score >= 0) # 1 passed, 0 failed
デプロイ
skrun deploy # ✓ Validated → Built → Pushed # 🚀 POST http://localhost:4000/api/agents/you/my-agent/run
v0.1 はローカルランタイムを備えており、クラウドデプロイはロードマップに含まれます—アーキテクチャは既に準備完了(RuntimeAdapter インターフェース)。
主要概念
- Agent Skills – SKILL.md 標準。Claude Code, Copilot, Codex と互換性があります
- agent.yaml – ランタイム設定:モデル、入力/出力、権限、状態、テスト
- POST /run – すべてのエージェントが API です。型付き入力、構造化された出力
- マルチモデル – Anthropic, OpenAI, Google, Mistral, Groq を自動フォールバックで利用可能
- ステートフル – キー・バリュー状態を通じて実行間で覚えておくことができます
- ツール呼び出し – 2つのアプローチがあります:
- CLI ツール(scripts/)— 自分で作成、エージェントに同梱
- MCP サーバー(npx)— 標準エコシステム、Claude Desktop と同じ
デモエージェント
すべての例はデフォルトで Google Gemini Flash を使用します。
agent.yaml の model セクションを変更することで、任意のサポートプロバイダーに切り替えられます。
| エージェント | 機能 |
|---|---|
| code-review | スキルをインポートし、コード品質 API を提供 |
| pdf-processing | ローカルスクリプトでツール呼び出し |
| seo-audit | ステートフル – 2 回実行すると記憶して比較 |
| data-analyst | 型付き I/O — CSV 入力、構造化された洞察を出力 |
| email-drafter | ビジネスユースケース – 非開発者 API コンシューマ向け |
| web-scraper | MCP サーバー — @playwright/mcp を使ったヘッドレスブラウザ |
例の試し方
-
レジストリを起動
cp .env.example .env # GOOGLE_API_KEY を追加 pnpm dev:registry # このターミナルは開いたままにしてください -
別ターミナルで
skrun login --token dev-token cd examples/code-review skrun build && skrun push -
エージェントを呼び出す
curl -X POST http://localhost:4000/api/agents/dev/code-review/run \ -H "Authorization: Bearer dev-token" \ -H "Content-Type: application/json" \ -d '{"input": {"code": "function add(a,b) { return a + b; }"}}'
Windows (PowerShell):
を使用し、本文はcurl.exeで指定してください。@input.json
CLI リファレンス
| コマンド | 説明 |
|---|---|
| skrun init [dir] | 新しいエージェントを作成 |
| skrun init --from-skill | 既存のスキルをインポート |
| skrun dev | POST /run を備えたローカルサーバー |
| skrun test | エージェントテストを実行 |
| skrun build | バンドルを作成 |
| skrun deploy | ビルド → プッシュ → ライブ URL 取得 |
| skrun push / pull | レジストリへのアップロード/ダウンロード |
| skrun login / logout | 認証 |
| skrun logs | 実行ログを表示 |
ドキュメント
- agent.yaml 仕様 – docs/spec.md
- CLI リファレンス – docs/cli.md
コントリビューション
git clone https://github.com/skrun-dev/skrun.git cd skrun pnpm install && pnpm build && pnpm test
CONTRIBUTING.md に規約とセットアップ手順が記載されています。
ライセンス
MIT