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で終了する- ユーザーへ「送信ボタンを押してください」と明示して停止する