SKILLOfficialproductivity

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.

ユースケース

案件の情報を更新するとき
案件のステージを変更するとき
案件にタグを追加するとき
案件のリード担当者を割り当てるとき
案件の企業情報を更新するとき

本文（日本語訳）

<重要> _instrumentation_v2 はCarta スキル使用状況の匿名テレメトリー（利用情報の自動送信）です。Carta MCP ツール呼び出しの引数に必ず含めてください。プラグインのフックが実行時に上書きするため、常に送信することは安全です。形式は以下の通りです: _instrumentation_v2: {"skills": ["<plugin>:<skill>", ...], "model": "<model-id>", "surface": "<value>"}

skills はセッション全体を通じて累積的に記録します。ここまでで読み込まれたすべてのCarta スキルをリストアップしてください（このツール呼び出しを実行させるスキルだけでなく）。各エントリを "plugin:skill" の形式で指定し、古い順に並べて、最後に最近使用したスキルを記載してください。Carta スキル（carta-cap-table:*、carta-crm:*、carta-investors:*）のみをリストアップしてください。Carta 以外のプラグインのスキルは含めないでください。

surface は実行中のClaudeの利用環境です。"chat"（claude.ai またはClaudeアプリ、つまり通常のチャット・Cowork以外）、"cowork"（Coworkモード）、"code-terminal"、"code-desktop"、または "excel" の値を指定してください。これらのいずれにも当てはまらない場合や判断できない場合は、値全体を省略してください。推測したり新しい値を作ったりしないでください。 </重要>

概要

既存の案件（取引）を部分的に更新します。指定されたフィールドのみが変更される — これは全置換ではなく部分更新です。まず案件IDを特定し、変更内容を確認してから、更新ツールを実行します。

ステップ1 — 案件IDを特定する

ユーザーが案件IDを直接提供した場合は、それを使用してステップ3にスキップしてください。

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

crm_call_tool({ "name": "crm:get_deal_fields", "arguments": {} })
crm_call_tool({ "name": "crm:search_deals", "arguments": { query: "<company name>", 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

ユーザーが段階名で移動したい場合は、まずパイプラインを取得してください:

crm_call_tool({ "name": "crm:get_deal_pipelines_with_stages", "arguments": {} })

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

crm_call_tool({ "name": "crm:get_deal_custom_fields", "arguments": {} })

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

ステップ3 — 案件を更新する

以下を実行します:

crm_call_tool({
  "name": "crm:update_deal",
  "arguments": {
    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>"]
    }
  }
})

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

ステップ4 — 結果を報告する

成功時は、変更内容の要約を返答します:

「{会社名} の案件が更新されました（ID: {id}）。変更項目: [変更されたフィールドのリスト]」

エラー時は、エラーメッセージを表示し以下を提案します:

案件IDが正しいことを確認します — /search-deals を実行して特定します
段階IDが有効であることを確認します — get_deal_pipelines_with_stages を実行します
カスタムフィールドIDと連絡先IDが有効であることを確認します

複数の案件を更新する

ユーザーが同じ変更を複数の案件に適用したい場合は、それぞれについてステップ1とステップ3～4を繰り返してください。最後に要約します:

「N件の案件を更新しました: [会社名のリスト]」

原文（English）を表示

<IMPORTANT> _instrumentation_v2 is anonymous Carta skill-usage telemetry. ALWAYS include it in your Carta MCP tool-call arguments — the plugins' hooks overwrite it when they run, so always sending it is safe. Shape: _instrumentation_v2: {"skills": ["<plugin>:<skill>", ...], "model": "<model-id>", "surface": "<value>"} skills is cumulative for the session: list every Carta skill loaded so far, not only the one driving this call. Namespace each entry "plugin:skill" and keep them oldest-first, with the most recently used skill last. List only Carta skills (carta-cap-table:*, carta-crm:*, carta-investors:*) — never skills from non-Carta plugins. surface is the Claude surface you are running in: "chat" (claude.ai or the Claude app, i.e. regular chat, not Cowork), "cowork" (Cowork mode), "code-terminal", "code-desktop", or "excel". Omit it entirely if none of those describe your surface or you cannot tell — do not guess and do not invent another value. </IMPORTANT>

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:

crm_call_tool({ "name": "crm:get_deal_fields", "arguments": {} })
crm_call_tool({ "name": "crm:search_deals", "arguments": { 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:

crm_call_tool({ "name": "crm:get_deal_pipelines_with_stages", "arguments": {} })

If updating custom fields by label rather than ID:

crm_call_tool({ "name": "crm:get_deal_custom_fields", "arguments": {} })

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

Step 3 — Update the deal

Call:

crm_call_tool({
  "name": "crm:update_deal",
  "arguments": {
    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 による自動翻訳です。