mcpField
P
plane-api

plane-api

github.com/montagao生産性353 回インストール8 週間前に更新
リポジトリ

plane-api について

plane-api は、Plane の作業項目を作成・一覧表示・更新する内部スキルです。設定済みの認証情報を使い、JSON 形式で操作したい呼び出し元を対象とします。

主な機能

  1. 01メタデータ付き項目の作成
  2. 02条件指定による一覧と検索
  3. 03項目のフィールドとラベルの更新
  4. 04構造化 JSON の返却

活用シーン

  1. 01依頼内容から Plane 項目を作成
  2. 02状態・ラベル・期限で項目を検索
  3. 03項目の優先度や説明を変更

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/montagao/skills --skill plane-api

インストール後、Claude Code で/plane-apiを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

biome.json
bun.lock
package.json
plane.js
tsconfig.json
tests/
plane.test.js

詳細

plane-api（内部）

Plane への一貫した単一のインターフェースです。

設定

このスキルは、プロンプトを表示せず、シークレット／環境変数から Plane の接続設定を読み取ります。

  • PLANE_BASE_URL（優先）または PLANE_API_URL
  • PLANE_WORKSPACE_SLUG
  • PLANE_PROJECT_ID
  • PLANE_API_KEY

（任意：設定されている場合は、profile: "personal"|"business" などの複数のプロファイルをサポートします。）

入力仕様

呼び出し元は JSON オブジェクトを渡します。

作成

{ "action": "create", "title": "...", "description": "...（任意）", "due": "YYYY-MM-DD（任意）", "priority": "urgent|high|medium|low|none（任意）", "labels": ["claw_inbox", "..."]（任意） }

一覧表示

{ "action": "list", "limit": 20, "filters": { "labels": ["claw_inbox"]（任意）, "dueFrom": "YYYY-MM-DD"（任意）, "dueTo": "YYYY-MM-DD"（任意）, "state": "..."（任意）, "search": "..."（任意） } }

更新

{ "action": "update", "id": "work_item_id", "patch": { "title": "...（任意）", "description": "...（任意）", "due": "YYYY-MM-DD（任意）", "priority": "urgent|high|medium|low|none（任意）", "state": "...（任意）", "labels": ["..."]（任意） } }

動作

  • ユーザーに質問することはありません（呼び出し元が対応します）。
  • プラットフォームから受信メッセージ ID が提供される場合、冪等性を確保します（ベストエフォート）。
  • 構造化された JSON のみを返します。
  • 作業項目の URL を返す場合は、正規のウェブルートを使用します。
    • https://<plane-domain>/<workspaceSlug>/browse/<PROJECT_IDENTIFIER>-<SEQUENCE_ID>
  • /projects/<project>/issues/<issue> のような旧形式のリンクは、誤っていたり、適切にリダイレクトされなかったりする可能性があるため、生成しないでください。
  • ユーザー向けの課題キーを安全に解決できない場合は、推測せずに url を省略してください。

出力（常に JSON）

成功例： { "ok": true, "action": "create", "id": "...", "issue_key": "TMOM-461", "url": "https://todo.translate.mom/translatemom/browse/TMOM-461", "title": "..." }

失敗例： { "ok": false, "action": "create", "error": "...", "status": 401 }

コメント

Markdown 対応