laviya-agent-skills

Laviya Agent Skills

Laviya Agent Skills は、IDE やエージェントとの連携に再利用できるオーケストレーション用アセットのリポジトリです。 本番環境を想定した MCP ランタイム、共有のオーケストレーション用プロンプトアセット、Cursor や Claude などのツール向けのクライアント固有アーティファクトを提供します。

パッケージ

• laviya-agent-skills：Node ベースのツールで再利用できるプロンプト、ルール、スキルのアセットバンドル
• laviya-mcp-server：mcp/ から公開される stdio MCP ランタイム

含まれるもの

• core/：共有のオーケストレーション用プロンプトアセット
• mcp/：TypeScript MCP ランタイムのひな形（laviya-mcp-server）
• cursor/：Cursor のルールアーティファクト
• claude/：Claude のスキルアーティファクト（オーケストレーション用の SKILL.md、ユーザー主導のデリバリーサイクル用の laviya-delivery-cycle/SKILL.md）
• docs/：セットアップ、npm への公開、エンドユーザー向けオンボーディングガイド

リポジトリ構成

laviya-agent-skills/
  core/
  mcp/
    src/
    examples/
    README.md
  cursor/
  claude/
  docs/
    Setup.md
    MCPServerPublish.md
    InstallationAndUsage.md

クイックスタート

cd mcp
npm install
npm run typecheck
npm run build
npm run dev

必須の環境変数：

• LAVIYA_API_KEY

Claude Code スキルのインストール

Claude Code がスキルを読み込むには、skills フォルダー内に、スキル名を付けたフォルダーをスキルごとに作成し、その中に SKILL.md という名前のファイルを置く必要があります。

スキル	このリポジトリ内のソースファイル	インストール先（個人用、すべてのプロジェクト）	または（1 つのプロジェクトのみ）
laviya-orchestrator（オーケストレーションの実行）	mcp/examples/claude/SKILL.md	~/.claude/skills/laviya-orchestrator/SKILL.md	<project>/.claude/skills/laviya-orchestrator/SKILL.md
laviya-delivery-cycle（作業リストの検証、タスクの作成、Ready for deploy の報告）	claude/laviya-delivery-cycle/SKILL.md	~/.claude/skills/laviya-delivery-cycle/SKILL.md	<project>/.claude/skills/laviya-delivery-cycle/SKILL.md

2 列目のパスは、このリポジトリ内でファイルが置かれている場所であり、Claude Code がファイルを探す場所ではありません。~/.claude/laviya-delivery-cycle/（skills フォルダーなし）内のファイルや、~/.claude/ に直接置かれたファイルは無視されます。

Windows（リポジトリのルートから PowerShell を使用）：

New-Item -ItemType Directory -Force "$HOME\.claude\skills\laviya-orchestrator", "$HOME\.claude\skills\laviya-delivery-cycle" | Out-Null
Copy-Item mcp\examples\claude\SKILL.md "$HOME\.claude\skills\laviya-orchestrator\SKILL.md"
Copy-Item claude\laviya-delivery-cycle\SKILL.md "$HOME\.claude\skills\laviya-delivery-cycle\SKILL.md"

macOS / Linux（リポジトリのルートから）：

mkdir -p ~/.claude/skills/laviya-orchestrator ~/.claude/skills/laviya-delivery-cycle
cp mcp/examples/claude/SKILL.md ~/.claude/skills/laviya-orchestrator/SKILL.md
cp claude/laviya-delivery-cycle/SKILL.md ~/.claude/skills/laviya-delivery-cycle/SKILL.md

確認方法：新しい Claude Code セッションを開始して /skills を実行します。laviya-orchestrator と laviya-delivery-cycle が一覧に表示される必要があります。このリポジトリを更新した後は、ファイルを再度コピーしてください。Laviya MCP ツールは、スキルがなくても動作します。スキルを追加すると、手順ごとのルールが適用されます。

インストール可能なアセットパッケージ

再利用可能なアセットバンドルをインストールします。

npm install laviya-agent-skills

使用例：

import { assets, resolveAssetPath } from "laviya-agent-skills";
import { readFileSync } from "node:fs";

const cursorRule = readFileSync(assets.cursorRule, "utf8");
const orchestratorPrompt = readFileSync(resolveAssetPath("orchestratorSystemPrompt"), "utf8");

ドキュメント一覧

• ランタイムのアーキテクチャと実装：mcp/README.md
• 開発者向けセットアップガイド：docs/Setup.md
• NPM 公開ガイド：docs/MCPServerPublish.md
• エンドユーザー向けインストールと使用方法：docs/InstallationAndUsage.md
• クライアント固有の MCP セットアップ（Codex、VS Code、Antigravity、Claude）：docs/InstallationAndUsage.md

ランタイムの概要

MCP ランタイムは、グローバルランタイムとプロジェクトローカル設定を組み合わせたモデルに従います。

• マシンレベルのランタイムインストール
• リポジトリレベルのプロジェクト設定（.laviya/project.json または .laviya.json）
• ランタイムが適用するライフサイクルの仕組み（検証、再試行、冪等性、構造化ログ）

現在の MCP ツールセットには、オーケストレーションとローカルのダイレクトタスクフィードの両方のフローが含まれています。

• laviya_help
• laviya_feed_task
• laviya_get_local_work_status
• laviya_cancel_local_work
• laviya_add_task_comment
• laviya_list_projects
• laviya_create_tasks
• laviya_start_delivery_run
• laviya_get_task
• laviya_upload_task_file
• laviya_update_task_description
• laviya_assign_task
• laviya_start_task_work
• laviya_complete_task_work
• laviya_get_my_work
• laviya_start_execution
• laviya_complete_execution
• laviya_report_token_usage
• laviya_diagnostics

すべてのツールは、{ HasFailed, Messages, Data } の形式の API エンベロープ JSON テキストを返します。

作業項目には、バックエンドで定義された ExecutionPolicy が含まれる場合があります。分析およびレビューのポリシーは読み取り専用です。エージェントは変更を実装してはならず、ポリシーが適用される場合は、正確な完了時の executionEvidence が必要です。

アーキテクチャの詳細とファイル単位のひな形については、mcp/README.md を参照してください。