Skill Vision Control

🚀 Skill Vision Control (SVC)

安全なMCPスキルバージョンマネージャー - アップデートの検出、並行テスト、スマートマージ、置き換え前の確認

✨ 主な機能

• 🔍 アップデート検出 - GitHub/npmから自動的に新しいバージョンを検出します。
• 🛡️ セキュリティスキャン - ダウンロード前に自動的にスキャンします（Sentinelと統合）。
• 📦 バージョン管理 - 複数のバージョンを保持し、いつでも切り替えることができます。
• 🔀 スマートマージ - 公式のアップデートと独自の変更をマージします。
• 🧪 A/Bテスト - 切り替える前に新しいバージョンをテストします。
• ⏰ 定期チェック - 毎週/毎月自動的にアップデートをチェックします。
• 🔔 通知 - アップデートに関するデスクトップ通知を受け取ります。
• 🤖 MCPサーバー - AIにスキルを管理させます。

📦 インストール

npm install -g skill-vision-control

またはyarnを使用する場合は、以下のコマンドを実行します。

yarn global add skill-vision-control

🚀 クイックスタート

# 管理するスキルを追加
svc add weather --source github:username/weather-mcp

# アップデートを確認
svc check

# 新しいバージョンをダウンロード（古いバージョンを保持）
svc download weather

# テストして切り替え
svc switch weather --version v1.1.0

# 独自の変更がある場合は、マージする
svc merge weather

📚 ドキュメント

スキル管理

バージョン管理

カスタム変更

スケジュール

セキュリティスキャン

💻 使用例

基本的なアップデートフロー

# 1. アップデートを確認
svc check
# 出力: weather: v1.0.0 → v1.1.0 利用可能

# 2. ダウンロード（古いバージョンを保持）
svc download weather

# 3. 新しいバージョンをテスト
svc switch weather -v v1.1.0 -t official

# 4. 問題なければ確定、問題があればロールバック
svc confirm weather
# または
svc rollback weather

インストール前のセキュリティ監査

# インストール前にスキルをスキャン
svc scan ~/Downloads/some-mcp-skill

# 出力:
# 🛡️  Sentinelセキュリティスキャンレポート
# ══════════════════════════════════════════════════
# リスクレベル: 中
# 推奨事項: レビュー
# 
# ⚠️  疑わしい項目: 3件発見
#    - src/api.ts:15 - ネットワークリクエスト（axios）
#    - src/config.ts:8 - 環境変数のアクセス

# すべてのインストールされたスキルを監査
svc audit

# 特定のスキルを詳細で監査
svc audit weather -v

カスタム変更 + アップデート

# 1. カスタムブランチを作成
svc fork weather

# 2. 変更を加える...
# 3. 変更を保存
svc save weather -c "中国語のサポートを追加"

# 4. 後でアップデートが利用可能になったとき
svc check
# 出力: ⚠️ 独自の変更があります。「svc merge」を使用してください。

# 5. ダウンロードしてマージ
svc download weather
svc merge weather

# 6. 競合が存在する場合
svc conflicts weather
svc resolve weather -f src/config.ts -u custom

# 7. マージされたバージョンをテスト
svc switch weather -v v1.1.0-merged -t merged

# 8. 確定
svc confirm weather

MCPサーバーとしての使用

MCP設定に以下を追加します。

{
  "mcpServers": {
    "skill-vision-control": {
      "command": "svc",
      "args": ["serve"]
    }
  }
}

利用可能なMCPツール:

• svc_list_skills - 管理されているすべてのスキルを表示します
• svc_get_skill_info - スキルの詳細を取得します
• svc_check_updates - アップデートを確認します
• svc_get_versions - ローカルのバージョンを取得します
• svc_switch_version - バージョンを切り替えます
• svc_rollback - 前のバージョンに戻します
• svc_download_update - 新しいバージョンをダウンロードします
• svc_merge - 独自の変更とマージします
• svc_get_conflicts - マージの競合を表示します

データストレージ

すべてのデータは ~/.svc/ に保存されます。

~/.svc/
├── skills.json      # スキルレジストリ
├── schedule.json    # スケジュール設定
├── config.json      # グローバル設定
└── versions/        # バージョン保存先
    └── <skill>/
        ├── official/
        ├── custom/
        ├── merged/
        └── active -> ...

セキュリティスキャン

SVCは Sentinel のセキュリティパターンを統合して、自動的なコードスキャンを行います。

検出能力

リスクレベル

ダウンロード時の自動スキャン

svc download を実行すると、自動的にセキュリティスキャンが実行されます。

svc download weather
# 🛡️  セキュリティスキャンを実行中...
# ✅ セキュリティスキャンに合格しました
# ✓ ダウンロード完了

問題が見つかった場合:

svc download untrusted-skill
# 🛡️  セキュリティスキャンを実行中...
# 🛑 セキュリティスキャンで重大な問題が見つかりました！
# ? 引き続き実行しますか？（推奨しません）(y/N)

スキップするには（推奨しません）:

svc download weather --skip-security

設定

サポートされているソース

• GitHub: github:username/repo または username/repo
• npm: npm:package-name

スケジュールオプション

• 1d - 毎日チェック
• 7d - 毎週チェック（デフォルト）
• 14d - 隔週チェック
• 30d - 毎月チェック

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。