Azure DevOps Boards: マイカード

Azure DevOps Boards: マイカード は何をしますか？

Azure Boards 上で自分のカードを MCP または az 経由で管理します。チームの規則は設定ファイルに保存されるため、同じスキルを異なるチームで使い回せます。

1. 最初に行うこと

1. 設定ファイルを読む — ~/.config/ado-boards/config.md（Windows の場合: %USERPROFILE%\.config\ado-boards\config.md）。ファイルがない場合は、最初にコアセットアップ（workflows/setup.md）を実行します。組織やプロジェクトを推測すると、間違った場所に書き込むことになります。not set yet とマークされた値は、最初にワークフローが必要としたときに収集されます。
2. このターンのみバックエンドを選択:
   • MCP: Azure DevOps MCP ツールが利用可能な場合（例: wit_work_item）: mcp-tools.md を読み込みます（さらに、そのマップが MCP のギャップを文書化している場合に限り、az/ のギャップファイルを1つだけ読み込みます）。
   • az: それ以外の場合: az/README.md と、このワークフロー用のセクションファイル1つを読み込みます。また、HTML の説明文や受入基準の書き込みが文字化けするか、PowerShell のクォートが失敗した場合にのみ az/windows.md も読み込みます。ログインを確認します（az account show または AZURE_DEVOPS_EXT_PAT）。どちらもない場合、ユーザー自身が az login を実行します。
   • どちらも利用不可 → セットアップを案内します。
3. 該当するワークフロー（下の表）を開き、それに従います。ワークフローは「何を」行うかを示し、バックエンドファイルは「どのように」行うかを示します。§2 のルールは両方のバックエンドに適用されます。

設定ファイルが手元にあり、1つのバックエンドが選択され、ワークフローファイルが開かれたら完了です。

ユーザーは自分でサインインします（Entra / az login）。認証情報はチャットに残りません。

2. ルール

読み取りに権限は不要です。すべての書き込みにはプレビューと明示的な「はい」が必要です — ツール自体が要求しない場合でも同様です。ボードは共有されており、MCP の書き込みはプロンプトをスキップすることが多いため、プレビューがゲートとなります。

ルール	条件
プレビューサイズ	自分のカードに対する1つの変更 → 1行（#512: State Active -> Closed. OK?）。複数の変更、または他人のカード → テーブル（ID, フィールド, 旧, 新）。10件を超える → 件数を示し、再度確認します。
読み返し	書き込み後: ID、変更内容、URL https://dev.azure.com/<org>/<project>/_workitems/edit/<id> を報告します。
親	設定で Parent required: yes の場合: 親ありでのみ作成します（親なしのカードはバックログビューから見えなくなります）。
バグ	設定でバグが別の場所にある場合: 既存のバグの下にタスクを提案します（2つ目のバグは履歴を分割します）。
外部カード	設定内のタイトルプレフィックス（例: EXT）: コメントがコメント変更やフィールド変更よりも先に報告者に同期される可能性があることを警告します。クローズ時の影響はスキップします。
単位	時間フィールドは単なる数値です。単位は設定にあります。ユーザーが別の単位を指定した場合は変換し、両方を表示し、常に単位を明示します（Boards UI はどちらにせよ「h」と表示します）。
カードは残す	閉じるか移動します。カードはボード上に残します。コメントの削除は、完全に表示して「はい」を得てから行います — どちらも元に戻せません。
自分のコメント	自分のコメントのみ編集・削除します（それ以外は ADO が拒否します）。
実際の値	見積もり、担当者、日付、影響を尋ねる — または空白のままにします。仮の数値はボード上で本物のように見えます。
安全な引用符	値を安全に引用します。タイトルに引用符が含まれる場合があります。
書き込みフッター	書き込み後: 行ったこと、スキップしたこと、次のステップを1つ。単なる読み取り: 回答のみ。

3. ワークフロー

条件	開くファイル
ADO スキルをセットアップする。設定ファイルがない、または何かが変わった	workflows/setup.md
自分のプレートに何があるか。カードを表示する。移動する。工数を記録する。閉じる	workflows/my-cards.md
カードを作成する。ストーリーをタスクに分割する	workflows/create-card.md
コメントを追加、一覧表示、編集、または削除する	workflows/comments.md
説明文または受入基準	workflows/write-description.md
スプリントを計画する。最初に何に取り組むべきか	workflows/plan-my-sprint.md

4. アジャイルリファレンス（設定ファイルで確認すること）

階層: Epic > Feature > User Story > Task。バグはチーム設定に応じてストーリーの横または下に配置されます。

種類	状態
Feature / User Story	New, Active, Resolved, Closed, Removed
Bug	New, Active, Resolved, Closed
Task	New, Active, Closed, Removed

親: Task は User Story（または Bug）の下、User Story は Feature の下。カスタム状態と必須フィールドは、一度収集されると設定ファイルに保存されます。