スキルOfficialproductivity

📝update-deal

プラグイン: carta-crm
ソース: GitHub で見る ↗

説明

Carta CRM 内の既存のディールレコードを更新します。次のような場合に使用: ユーザーが「ディールを更新する」「ディールを〔ステージ〕に移動する」「ディールのステージを変更する」「ディールを編集する」「ディールのフィールドを更新する」「ディールにタグを追加する」「ディールのリードを割り当てる」「ディールの企業情報を更新する」「ディールにコンタクトを紐付ける」または「/update-deal」といった操作を求めた場合。ディール ID または企業名を受け付けます（ID が指定されていない場合は検索を行います）。明示的に指定されたフィールドのみが変更され、それ以外のフィールドはすべてそのまま保持されます。

原文を表示

Updates an existing deal record in the Carta CRM. Use this skill when the user says things like "update a deal", "move deal to [stage]", "change deal stage", "edit deal", "update deal fields", "add a tag to deal", "assign deal lead", "update company info on deal", "link contacts to deal", or "/update-deal". Accepts a deal ID or company name (will search if no ID provided). Only the fields explicitly provided are changed — all other fields are left untouched.

ユースケース

✓ディールのステージを変更するとき
✓ディールにタグを追加するとき
✓ディール情報を編集するとき
✓ディールのフィールドを更新するとき
✓ディールにコンタクトを紐付けるとき

本文（日本語訳）

概要

既存のディールを部分的に更新します。指定されたフィールドのみが変更されます。これは完全な置き換えではなく、部分更新です。まずディールIDを特定し、変更内容を収集した上で、更新ツールを呼び出してください。

ステップ 1 — ディールIDの特定

ユーザーが直接ディールIDを提供している場合は、そのIDを使用してステップ3へ進んでください。

会社名のみが指定された場合は、まず get_deal_fields を呼び出してから検索してください:

mcp__carta_crm__get_deal_fields()
mcp__carta_crm__search_deals({ query: "<会社名>", limit: 10 })

複数のディールが一致した場合は、一覧を表示してどれを更新するかユーザーに確認してください（各ディールの会社名・ステージ・IDを表示すること）。

ステップ 2 — 更新内容の収集

ユーザーに変更したい内容を確認してください:

フィールド	説明
`stageId`	ディールを別のステージに移動する
`company.name`	関連する会社名を更新する
`company.url`	会社URLを更新する（自動エンリッチメントがトリガーされる）
`comment`	ディールのコメント／メモを置き換える
`tags`	タグの配列全体を置き換える
`dealLead`	ディールリードとして割り当てるユーザーID
`addedAt`	ディールが追加された日付（ISO 8601形式）
`fields`	フィールドIDをキーとするカスタムフィールドの値
`people.advisers`	アドバイザーとして紐付けるコンタクトID
`people.introducer`	紹介者として紐付けるコンタクトID
`people.management`	マネジメントとして紐付けるコンタクトID

ステージを名前で指定して移動する場合は、先にパイプラインを取得してください:

mcp__carta_crm__get_deal_pipelines_with_stages()

IDではなくラベルでカスタムフィールドを更新する場合:

mcp__carta_crm__get_deal_custom_fields()

重要: 明示的に変更するフィールドのみを含めてください。それ以外はすべて省略してください。

ステップ 3 — ディールの更新

以下を呼び出してください:

mcp__carta_crm__update_deal({
  id: "<ディールID>",
  stageId: "<ステージID>",
  company: { name: "<名前>", url: "<URL>" },
  comment: "<更新後のコメント>",
  tags: ["<タグ1>", "<タグ2>"],
  dealLead: "<ユーザーID>",
  addedAt: "<ISO 8601形式の日付>",
  fields: { "<field_id>": "<値>" },
  people: {
    advisers: ["<コンタクトID>"],
    introducer: ["<コンタクトID>"],
    management: ["<コンタクトID>"]
  }
})

更新しないトップレベルのキーはすべて省略してください。

ステップ 4 — 結果の報告

成功した場合は、変更内容のサマリーを以下の形式で返してください:

"{会社名} のディールを更新しました（ID: {id}）。変更されたフィールド: [変更フィールドの一覧]"

エラーが発生した場合は、エラーメッセージを表示し、以下を提案してください:

ディールIDが正しいか確認する — /search-deals を実行して検索する
ステージIDが有効か確認する — get_deal_pipelines_with_stages を実行する
カスタムフィールドIDおよびコンタクトIDが有効か確認する

複数ディールの更新

同じ変更を複数のディールに適用する場合は、各ディールに対してステップ1・3・4を繰り返してください。最後に以下の形式でサマリーを表示してください:

"N件のディールを更新しました: [会社名の一覧]"

原文（English）を表示

Overview

Partially update an existing deal. Only fields provided are modified — this is a partial update, not a replacement. First resolve the deal ID, collect what to change, then call the update tool.

Step 1 — Resolve the deal ID

If the user provided a deal ID directly, use it and skip to Step 3.

If only a company name was given, call get_deal_fields first, then search:

mcp__carta_crm__get_deal_fields()
mcp__carta_crm__search_deals({ query: "<company name>", limit: 10 })

If multiple deals match, present the list and ask the user to confirm which one to update (show company name, stage, and ID for each).

Step 2 — Collect what to update

Ask the user what they want to change:

Field	Description
`stageId`	Move deal to a different stage
`company.name`	Update the associated company name
`company.url`	Update company URL — triggers auto-enrichment
`comment`	Replace the deal comment/notes
`tags`	Replace the full tags array
`dealLead`	User ID to assign as deal lead
`addedAt`	ISO 8601 date the deal was added
`fields`	Custom field values keyed by field ID
`people.advisers`	Contact IDs linked as advisers
`people.introducer`	Contact IDs linked as introducers
`people.management`	Contact IDs linked as management

If the user wants to move to a stage by name, fetch pipelines first:

mcp__carta_crm__get_deal_pipelines_with_stages()

If updating custom fields by label rather than ID:

mcp__carta_crm__get_deal_custom_fields()

Important: Only include fields that are explicitly being changed. Omit everything else.

Step 3 — Update the deal

Call:

mcp__carta_crm__update_deal({
  id: "<deal id>",
  stageId: "<stage id>",
  company: { name: "<name>", url: "<url>" },
  comment: "<updated comment>",
  tags: ["<tag1>", "<tag2>"],
  dealLead: "<user id>",
  addedAt: "<ISO 8601 date>",
  fields: { "<field_id>": "<value>" },
  people: {
    advisers: ["<contact id>"],
    introducer: ["<contact id>"],
    management: ["<contact id>"]
  }
})

Omit any top-level key that is not being updated.

Step 4 — Report result

On success, respond with a summary of what changed:

"Deal for {company name} updated (ID: {id}). Changed: [list of changed fields]"

On error, show the error message and suggest:

Verify the deal ID is correct — run /search-deals to find it
Check that stage IDs are valid — run get_deal_pipelines_with_stages
Check that custom field IDs and contact IDs are valid

Updating multiple deals

If the user wants to apply the same change to multiple deals, repeat Steps 1 and 3–4 for each. Summarize at the end:

"Updated N deals: [list of company names]"

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。