スキル

wecom-cli で端末から企業微信の認可を確かめてから事務を始める

端末で企業微信の文書、To-Do、日程を扱いたい人向け。Node.js >= 18 と企業微信アカウントが必要。先に CLI を入れ、それから必須の Skill を入れる。

公式ソース · wecom-cli

インストール

npx skills add WeComTeam/wecom-cli -y -g

誰向けか

端末で企業微信を操作し、メッセージ、メール、文書、To-Do、日程、会議、WeDrive、通信録を覆い、人間と AI Agent が同じコマンドラインを使えるようにしたいときに、このスキルを使う。別のウェブ管理画面ではない。オープンプラットフォームの能力を端末へつなぎ、企業の事務効率を上げる。公式リポジトリは:

https://github.com/wecomteam/wecom-cli

前提ははっきり書く:このマシンに Node.js >= 18 と企業微信アカウント。プラットフォームは macOS (x64/arm64)、Linux (x64/arm64)、Windows (x64) に限る。アカウントが無い、版が足りない、これらのプラットフォームにいないなら、先に入れない。ブラウザで企業微信をクリックするだけで、このマシンに全体コマンドを残すつもりが無い人も、ここから始めない。

原文は CLI インストールと CLI Skill インストールを二段階に分け、Skill は必須と書く。先にコマンドライン、それから Agent に呼び出しを覚えさせる。出ていないインストーラを作らない。指名していないスキルディレクトリを足さない。原文は「人間と AI Agent」を数製品の独占とは書いていない。クライアント名簿を自分で狭めない。

3 分で最初の試行を終える

先に三つ確認する。Node.js は 18 以上。企業微信アカウントがある。今のシステムは上記プラットフォームの中。公式ページを開いて照合する:

https://github.com/wecomteam/wecom-cli

主経路は先に CLI、それから必須の CLI Skill。パッケージを入れるとこのマシンの全体コマンドが変わる。実行前に、このマシンへ @wecom/cli を残すか確認する:

npm install -g @wecom/cli

確認したあと、原文が出す Skill インストール(必須と注記)を実行する:

npx skills add WeComTeam/wecom-cli -y -g

この二段階を並列の主経路に分けない。パラメータも変えない。原文はスキルの着地ディレクトリを書いていない。経路を自分で足さない。

Agent では最初は検査だけ。文書を新しく作らず、メールを出さず、日程も変えない。まだ資格情報を配っていないなら、設定は副作用:既定はQRスキャン、--manual で手入力。実行前に、これが自分の企業微信アカウントであり、この一回の対話を終える準備があると確認する:

wecom-cli auth init

配ったあと、読み取り専用コマンドで認可状態を見る:

wecom-cli auth show

成功の合図:コマンドが正常に終わり、いまの認可状態が見える。原文は show のフィールド名を出さない。出力形式を作らない。最初はロボット通知、文書書き込み、会議予約、WeDriveアップロードをしない。Agent が「先に init、それから show」と復唱するだけで、show を本当に通していないなら、すでに認可成功だと思わない。

利用事例

事例一:認可だけ見る。CLI と必須 Skill を入れたあと、端末、または同じコマンドを呼べる Agent で wecom-cli auth show を実行する。認可状態を見る。資格情報がまだあるか確認するのに向く。実行前に、ついでに設定を変えないと確認する。成功の合図は認可状態が見えること。原文は未認可時の終了コードを書いていない。失敗したら止める。修復コマンドを作らない。この検査をメール送信や通信録読みに広げない。それらの動作に対応するコマンド文は無い。

事例二:最初に資格情報を設定する。原文は、資格情報の設定は対話式で一度だけで足り、既定はQRスキャン、--manual で手入力、と書く。コマンドは wecom-cli auth init。実行前に、このマシンへ企業微信の資格情報を残し、QRスキャンまたは手入力の準備があると確認する。配ったあと wecom-cli auth show で照合する。原文に取り消しやログアウトのコマンドは無い。資格情報のアンインストール手順を作らない。メッセージ、文書、To-Do、日程、会議、WeDrive、メール、通信録などの業務能力は機能名まで。たとえば文書の新規と読み取り、文書検索、日程の新規と管理、会議の予約と情報取得、To-Doの新規と追跡、WeDriveファイルのアップロードと取得、メールの送信と取得、通信録メンバー情報の取得、ロボットからの能動通知。それらの操作が必要なら先に公式リポジトリへ戻る。コマンドを自分で足さない。

利用上の境界

平台、ランタイム、アカウント要求は原文に従う:macOS (x64/arm64)、Linux (x64/arm64)、Windows (x64)、Node.js >= 18、企業微信アカウント。人間と AI Agent はどちらも端末で操作できるが、原文は具体的な Agent 製品を指名しない。数クライアントの独占と書かない。

インストール順は npm install -g @wecom/cli、それから必須の npx skills add WeComTeam/wecom-cli -y -g。第二の市場や出ていない skills add の変種を作らない。「必須 Skill」を CLI を飛ばしてよいとは読まない。二段階とも原文の順で終える。

資格情報の設定はこのマシンへ書く。既定はQRスキャン。--manual が使える。原文は資格情報ファイル経路、期限方針、取り消し方を書いていない。業務はメッセージ、メール、文書、To-Do、日程、会議、WeDrive、通信録を覆い、ロボット能動通知、文書検索、会議予約、WeDriveアップロードも含む。ただし根拠は能力記述で止まり、それらのサブコマンド文は無い。書いていないパラメータ、権限範囲、課金を補わない。最初は認可だけ確かめる。コマンドの無い事務動作を、すでに複製できる手順だと思わない。根拠が書いていないアンインストールや更新経路も自分で足さない。