Hermes Agent: プラグイン

# Jiraプラグインのインストール
hermes plugin install hermes-plugin-jira

# Notionプラグインのインストール
hermes plugin install hermes-plugin-notion

# そのまま会話で使用可能
me: PROJ-123のステータスを確認して
Agent: [Jira Plugin] PROJ-123: In Progress, 優先度 High

hermes-plugin-jira/
├── manifest.yaml         # プラグインマニフェスト
├── tools/                # プラグインが提供するツール
│   ├── jira_search.py
│   ├── jira_create.py
│   └── jira_update.py
├── skills/               # プラグインが提供するスキル
│   └── sprint-review.yaml
├── templates/            # 出力テンプレート
└── config.yaml           # プラグイン設定

# manifest.yaml
name: "hermes-plugin-jira"
version: "1.2.0"
description: "Jira integration for Hermes Agent"
author: "community"
license: "MIT"

dependencies:
  hermes_version: ">=1.0.0"
  python_packages:
    - "jira>=3.5.0"

tools:
  - name: "jira_search"
    description: "Search Jira issues"
    category: "communication"
  - name: "jira_create"
    description: "Create Jira issue"
    category: "communication"
  - name: "jira_update"
    description: "Update Jira issue"
    category: "communication"

skills:
  - name: "sprint-review"
    description: "Generate sprint review report"

permissions:
  - network: ["*.atlassian.net"]
  - filesystem: []
  - env_vars: ["JIRA_URL", "JIRA_TOKEN"]

# プラグインマーケットからインストール
hermes plugin install hermes-plugin-jira

# Gitリポジトリからインストール
hermes plugin install git+https://github.com/user/hermes-plugin-jira

# ローカルパスからインストール
hermes plugin install ./my-plugin

# 特定バージョンのインストール
hermes plugin install hermes-plugin-jira@1.2.0

# インストール済みプラグイン一覧
hermes plugin list

# 出力例：
# ┌─────────────────────┬─────────┬──────────┬─────────┐
# │ Plugin              │ Version │ Status   │ Tools   │
# ├─────────────────────┼─────────┼──────────┼─────────┤
# │ jira                │ 1.2.0   │ ✅ Active│ 3       │
# │ notion              │ 0.9.1   │ ✅ Active│ 4       │
# │ figma               │ 0.5.0   │ ⏸️ Paused│ 2       │
# └─────────────────────┴─────────┴──────────┴─────────┘

# プラグインの更新
hermes plugin update jira

# プラグインの無効化（アンインストールなし）
hermes plugin pause figma

# プラグインの有効化
hermes plugin resume figma

# プラグインのアンインストール
hermes plugin uninstall figma

# インストール
hermes plugin install hermes-plugin-github

# 設定
hermes config set plugins.github.token "${GITHUB_TOKEN}"
hermes config set plugins.github.default_repo "myorg/myrepo"

# 使用
me: レビュー待ちのPRをリストアップ
Agent: [GitHub Plugin] レビュー待ちPR 3件：
  - #42: Fix auth flow (alice, 2h ago)
  - #43: Add rate limiting (bob, 5h ago)
  - #44: Update dependencies (carol, 1d ago)

# my_plugin/tools/hello.py
from hermes import Tool, ToolResult

class HelloTool(Tool):
    name = "hello"
    description = "Say hello to someone"
    category = "custom"
    
    parameters = {
        "name": {"type": "str", "required": True}
    }
    
    def execute(self, name: str) -> ToolResult:
        return ToolResult(
            success=True,
            data={"message": f"Hello, {name}!"},
            summary=f"Greeted {name}"
        )

# my_plugin/manifest.yaml
name: "my-plugin"
version: "0.1.0"
description: "My custom plugin"
author: "me"

tools:
  - name: "hello"
    description: "Say hello"
    category: "custom"

permissions:
  - network: []
  - filesystem: []

# stock-plugin/tools/stock_query.py
from hermes import Tool, ToolResult
import httpx

class StockQueryTool(Tool):
    name = "stock_query"
    description = "Query stock price and metrics"
    category = "finance"
    
    parameters = {
        "symbol": {
            "type": "str",
            "required": True,
            "description": "Stock symbol (e.g., AAPL)"
        },
        "metric": {
            "type": "str",
            "required": False,
            "default": "price",
            "enum": ["price", "pe", "volume", "market_cap"]
        }
    }
    
    def execute(self, symbol: str, metric: str = "price") -> ToolResult:
        api_key = self.get_env("STOCK_API_KEY")
        response = httpx.get(
            f"https://api.stock.com/quote",
            params={"symbol": symbol, "apikey": api_key}
        )
        data = response.json()
        
        return ToolResult(
            success=True,
            data=data,
            summary=f"{symbol} {metric}: {data.get(metric, 'N/A')}"
        )

# インストール前にプラグイン権限をレビュー
hermes plugin audit hermes-plugin-xxx

# 出力例：
# ⚠️ 権限レビュー：
# - network: *.example.com ✅
# - filesystem: /tmp ⚠️ (範囲制限を推奨)
# - subprocess: true ❌ (無効化またはコードレビューを推奨)
# - env_vars: API_KEY ✅