Teams Desktop Automation

When to Use

Teams デスクトップでチャット本文を下書きするとき
Teams Web / Playwright / CDP が使えず、認証済みデスクトップアプリを使うとき
宛先と本文を検証し、ユーザーの最終送信待ちで止めるとき

使わない: 会議参加、通話、チャネル投稿、ファイル共有、メッセージ送信後の編集・削除。

Safety Contract

送信しない。 宛先と本文を入力した画面で停止し、最終の送信ボタンはユーザー本人に押してもらう。
宛先は表示名だけで決めず、組織ディレクトリ等で確認したメールアドレスと照合する。
Teams のウィンドウタイトルで宛先・期待アカウントを確認する。候補が0件または複数なら停止する。
既存下書きが別内容なら上書きしない。同一本文なら再入力せず成功扱いにする。
SendKeys、送信ボタンの click / InvokePattern、座標クリックを実行しない。
認証、MFA、アカウント切替が必要なら、対象と完了の目印を示してユーザーへ引き継ぐ。

Workflow

宛先の表示名、社内メールアドレス、期待する Teams アカウント、本文を確定する。
Teams が起動中か確認する。必要なら helper の Open で対象チャットを開く。この操作は Teams を前面化し得るため、実行前にユーザーへ知らせる。
Inspect でウィンドウタイトル、composer、既存下書き、送信ボタンを確認する。
Draft で本文を入力する。異なる既存下書きがあれば停止する。
ready-for-user-send、DraftMatches=true、SendEnabled=true、SendActionPerformed=false を確認する。
必要なら -ScreenshotPath で現在画面を保存し、ユーザーへ送信操作を依頼して止める。

Commands

PowerShell 7 (pwsh) で実行する。

$script = '.github/skills/teams-desktop-automation/scripts/Set-TeamsDesktopDraft.ps1'

& $script -Mode Open `
  -RecipientDisplayName '<display-name>' `
  -RecipientEmail '<user@example.com>' `
  -ExpectedAccount '<signed-in-account@example.com>'

& $script -Mode Inspect `
  -RecipientDisplayName '<display-name>' `
  -RecipientEmail '<user@example.com>' `
  -ExpectedAccount '<signed-in-account@example.com>'

& $script -Mode Draft `
  -RecipientDisplayName '<display-name>' `
  -RecipientEmail '<user@example.com>' `
  -ExpectedAccount '<signed-in-account@example.com>' `
  -Message '<message>' `
  -ScreenshotPath 'output/teams-draft.png'

Failure Handling

Open 後に対象タイトルがまだ出ない場合は、同じ Draft を連打せず Inspect を1回行う。
UIA が composer を公開しない場合は未確認として止める。Web 版への自動迂回やアプリ再起動は行わない。
Draft の結果が曖昧なら再入力しない。現在値を Inspect で読み、同一本文か確認する。
アプリの foreground、入力欄 focus、送信ボタンの操作は完了条件に含めない。

Validation

& .github/skills/teams-desktop-automation/scripts/Test-TeamsDesktopDraft.ps1

実機テストは既存チャットを壊さないよう、Inspect を先に実行する。Draft は実際にユーザーへ見せる本文が確定している場合だけ使う。

Done Criteria

対象表示名と期待アカウントがウィンドウタイトルで一致する
composer の下書きが要求本文と完全一致する
送信ボタンが存在し有効である
SendActionPerformed=false で終了する
ユーザーへ「送信ボタンを押してください」と明示して停止する