SKILLOfficialproductivity

add-note

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

説明

Carta CRM の取引記録にメモを追加するスキルです。Carta CRM MCP サーバーを通じて、メモは取引記録に対するコメントとして保存されます。次のような場合に使用： - ユーザーが「メモを追加して」「メモを記録して」「取引にメモを追加して」「Carta CRM にメモを追加して」「コメントを追加して」「取引にコメントして」などと言ったとき - または「/add-note」というコマンドが入力されたとき

原文を表示

Adds a note to a deal in the Carta CRM via the Carta CRM MCP Server; notes are stored as comments on the deal record. Use this skill when the user says things like "add a note", "log a note", "add note to a deal", "add note to Carta CRM", "add a comment", "comment on a deal", or "/add-note".

ユースケース

取引記録にメモを追加するとき
Carta CRMにコメントを記録するとき
/add-noteコマンド入力時

本文（日本語訳）

<重要> _instrumentation_v2 は、Cartaスキルの利用状況を記録する匿名のテレメトリ（利用データ）です。Carta MCPツール呼び出しの引数に常に含める必要があります。プラグインのフックが実行時に上書きするため、常に送信しても安全です。形式: _instrumentation_v2: {"skills": ["<プラグイン>:<スキル>", ...], "model": "<モデルID>", "surface": "<値>"}

skills はセッション全体の累積リストです。これまでに読み込まれたすべてのCartaスキルを列挙してください（このツール呼び出しだけでなく）。各エントリを "プラグイン:スキル" 形式で名前空間を付け、古い順に並べ、最後に最近使用したスキルを置いてください。Cartaスキルのみを列挙してください（carta-cap-table:*、carta-crm:*、carta-investors:*）。非Cartaプラグインのスキルは含めないでください。

surface はあなたが実行しているClaudeの利用環境です："chat"（claude.aiまたはClaudeアプリ、通常のチャット）、"cowork"（Coworkモード）、"code-terminal"、"code-desktop"、または "excel"。いずれにも当てはまらない場合や判断できない場合は、この項目を完全に省略してください。推測や造語は避けてください。 </重要>

概要

Carta CRM MCPサーバーでは、update_dealでcommentフィールドを使用して、ディール（取引）レコードにノート（メモ）をコメントとして追加します。ユーザーがノートをどのディールに添付するかを特定するのを支援し、ノートの内容を収集してから、そのディールを更新してください。

ステップ1 — ディールを特定する

ユーザーに、そのノートがどのディールのものかを尋ねてください。ユーザーが会社名またはディール名を挙げた場合は、検索してください：

crm_call_tool({ "name": "crm:get_deal_fields", "arguments": {} })
crm_call_tool({ "name": "crm:search_deals", "arguments": { query: "<会社名>", limit: 10 } })

複数のディールがマッチした場合は、リストを提示して、どのディールにノートを添付するかをユーザーに尋ねてください。

ユーザーがディールIDを直接提供した場合は、検索をスキップしてください。

ステップ2 — ノートの内容を収集する

ユーザーに以下を尋ねてください：

ノートテキスト（必須）— ノートの内容

ユーザーがメッセージ内でノート内容をすでに提供している場合は、それを直接抽出し、改めて尋ねなおさないでください。

既存のコメント（fetch_deal_by_deal_idから取得）を必要に応じて表示し、ユーザーが置き換えるのか追加するのかを把握しやすくしてください：

crm_call_tool({ "name": "crm:fetch_deal_by_deal_id", "arguments": { id: "<ディールID>" } })

ステップ3 — ディールにノートを追加する

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

crm_call_tool({
  "name": "crm:update_deal",
  "arguments": {
    id: "<ディールID>",
    comment: "<ノートの内容>"
  }
})

注意：commentは既存のディールコメントを置き換えます。ディールが既にコメントを持っていて、ユーザーが追加したい場合は、既存テキストと新しい内容を結合し、保存前に確認してください。

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

成功時は、以下のように返答してください：

「**{会社名}**のディール（ID：{ID}）にノートが追加されました。」

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

ディールIDが正しいか確認してください。/search-dealsを実行して検索してください。

原文（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

In the Carta CRM MCP Server, notes are added as comments on deal records using the comment field via update_deal. Help the user identify which deal to attach the note to, collect the note content, then update the deal.

Step 1 — Identify the deal

Ask the user which deal the note is for. If they named a company or deal, search for it:

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 which one to attach the note to.

If the user provided a deal ID directly, skip the search.

Step 2 — Collect the note content

Ask the user for:

Note text (required) — the content of the note

If the user has already provided the note content in their message, extract it directly without re-asking.

Optionally show the existing comment on the deal (from fetch_deal_by_deal_id) so the user knows whether they're replacing or appending:

crm_call_tool({ "name": "crm:fetch_deal_by_deal_id", "arguments": { id: "<deal id>" } })

Step 3 — Add the note to the deal

Call:

crm_call_tool({
  "name": "crm:update_deal",
  "arguments": {
    id: "<deal id>",
    comment: "<note content>"
  }
})

Note: comment replaces the existing deal comment. If the deal already has a comment and the user wants to append, combine the existing text with the new content and confirm before saving.

Step 4 — Report result

On success, respond with:

"Note added to deal {company name} (ID: {id})."

On error, show the error message and suggest:

Verify the deal ID is correct — run /search-deals to find it

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