add-azuredevops

📋 共通指示：shared-instructions.md - 複数の項目に関わる注意事項です。

Azure DevOps の追加

ワークフロー

1. Memory Bank を確認 → 2. コネクタを追加 → 3. HttpRequest の修正を適用 → 4. 設定 → 5. ビルド → 6. Memory Bank を更新

---

ステップ 1：Memory Bank を確認

shared-instructions.md に従って、memory-bank.md を確認します。

ステップ 2：コネクタを追加

まず、接続 ID を確認します（connector-reference.md を参照）：

/list-connections スキルを実行します。出力から Azure DevOps の接続を探します。見つからない場合は、ユーザーに環境固有の Connections URL を使用して接続を作成するよう案内します。コンテキスト内のアクティブな環境 ID（power.config.json または前のステップから取得）を使って、次の URL を組み立てます：https://make.powerapps.com/environments/<environment-id>/connections → + New connection → コネクタを検索 → 作成。

pa app add data-source --connector azuredevops -c <connection-id>

ステップ 3：HttpRequest の修正を適用（必須）

生成されたコードには既知の問題があります。HttpRequest メソッドではパラメーター名に parameters を使用していますが、API が期待するのは body です。次の 3 つのファイルで parameters を body に変更します。

各ファイルで Edit ツールを使い、parameters を body に変更します。

1. src/generated/services/AzureDevOpsService.ts: HttpRequest メソッドを探します。パラメーターとその使用箇所を変更します。

// BEFORE (generated):
async HttpRequest(parameters: any) {
  const params = { parameters: parameters, ... };

// AFTER (fixed):
async HttpRequest(body: any) {
  const params = { body: body, ... };

2. .power/appschemas/dataSourceInfo.ts: visualstudioteamservices → HttpRequest → parameters セクションを探します。プロパティキーを変更します。

// BEFORE (generated):
HttpRequest: {
  parameters: {
    parameters: { ... }

// AFTER (fixed):
HttpRequest: {
  parameters: {
    body: { ... }

3. .power/schemas/visualstudioteamservices/visualstudioteamservices.Schema.json: /{connectionId}/httprequest → post → parameters 配列を探します。name フィールドを変更します。

// BEFORE (generated):
{ "name": "parameters", "in": "body", ... }

// AFTER (fixed):
{ "name": "body", "in": "body", ... }

ステップ 4：設定

ユーザーに、必要な Azure DevOps 操作（作業項目のクエリ、項目の作成、パイプラインのトリガーなど）を尋ねます。

HttpRequest -- 任意の ADO REST API 呼び出しを実行します。

await AzureDevOpsService.HttpRequest({
  Uri: "https://dev.azure.com/{org}/{project}/_apis/wit/wiql?api-version=7.2",
  Method: "POST",
  Body: JSON.stringify({
    query:
      "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.TeamProject] = @project"
  })
});

ドキュメント：Azure DevOps REST API

Grep を使って src/generated/services/AzureDevOpsService.ts 内の特定のメソッドを探します（生成されたファイルは非常に大きい場合があります。connector-reference.md を参照）。

ステップ 5：ビルド

npm run build

先に進む前に、TypeScript のエラーを修正します。まだデプロイしないでください。

ステップ 6：Memory Bank を更新

memory-bank.md を更新し、追加したコネクタ、適用した HttpRequest の修正、ビルドの状態を記録します。