name: "outlook_contacts"
description: "List, search, create, update, and delete contacts in the user's Outlook account."
icon: "outlook_contacts"
metadata: { "includeInPrompt": false }

Outlook Contacts / Outlook 联系人

Purpose

Manage Outlook contacts with a local helper CLI so the prompt stays concise.
The connector supports both personal Microsoft accounts and Microsoft 365 work
or school accounts.
/ 目的
通过本地辅助 CLI 管理 Outlook 联系人，使提示词保持简洁。
该连接器同时支持个人 Microsoft 账户和 Microsoft 365 工作或学校账户。

Tooling / 工具

Use:

使用：

outlook-contacts <subcommand> [options]

Core subcommands:

• disconnect
• list [--page-size 10] [--page-token <token>]
• get "AAMkAD..."
• search "alice smith" --page-size 10
• create --given-name "Alice" --family-name "Smith" --email [email protected] --phone "+15551234567"
• update "AAMkAD..." --given-name "Alice" --email [email protected]
• delete "AAMkAD..."

核心子命令：

• disconnect
  断开连接
• list [--page-size 10] [--page-token <token>]
  列出联系人
• get "AAMkAD..."
  获取联系人
• search "alice smith" --page-size 10
  搜索联系人
• create --given-name "Alice" --family-name "Smith" --email [email protected] --phone "+15551234567"
  创建联系人
• update "AAMkAD..." --given-name "Alice" --email [email protected]
  更新联系人
• delete "AAMkAD..."
  删除联系人

Common option:

• --timeout-secs N (default 30)

通用选项：

• --timeout-secs N（默认 30）

Use --page-size for result count. --top, --limit, and --max-results
are compatibility aliases only; do not use them in new commands.

请用 --page-size 控制结果数量。--top、--limit 和 --max-results
仅是兼容性别名；新命令中不要使用它们。

JSON output contract:

• disconnect: parse ok, action, status, and disconnect_url
• list / search: parse ok, count, next_page_token (when present, pass back as --page-token), total_people, and contacts[].resource_name, contacts[].display_name, contacts[].emails, contacts[].phones
• get: parse ok and contact.resource_name, contact.display_name, contact.emails, contact.phones, contact.organization, contact.title
• create / update / delete: parse ok, action, resource_name

JSON 输出契约：

• disconnect：解析 ok、action、status 和 disconnect_url
• list / search：解析 ok、count、next_page_token（若存在，将其作为 --page-token 传回）、total_people，以及 contacts[].resource_name、contacts[].display_name、contacts[].emails、contacts[].phones
• get：解析 ok 以及 contact.resource_name、contact.display_name、contact.emails、contact.phones、contact.organization、contact.title
• create / update / delete：解析 ok、action、resource_name

Auth / 认证

This skill depends on an Outlook connector managed by outlook-contacts.

本技能依赖由 outlook-contacts 管理的 Outlook 连接器。

Use:

使用：

outlook-contacts --status

Rules:

• For connect or reconnect, replace <connect_url> with the returned URL and share exactly this Markdown link: [Connect Outlook Contacts](<connect_url>); do not paste the raw URL separately.
• For disconnect, run outlook-contacts disconnect. When disconnect_url is present, replace <disconnect_url> with the returned URL and share exactly this Markdown link: [Disconnect Outlook Contacts](<disconnect_url>); do not paste the raw URL separately. If absent, say the connector is already disconnected.
• never use a shared connector helper CLI for Outlook Contacts
• do not hand-author token files or guess connector state; rely on outlook-contacts --status

规则：

• 连接或重新连接时，把 <connect_url> 替换为返回的 URL，并原样分享这个 Markdown 链接：[Connect Outlook Contacts](<connect_url>)；不要单独粘贴原始 URL。
• 断开连接时，运行 outlook-contacts disconnect。若返回了 disconnect_url，把 <disconnect_url> 替换为返回的 URL，并原样分享这个 Markdown 链接：[Disconnect Outlook Contacts](<disconnect_url>)；不要单独粘贴原始 URL。若没有返回，则说明连接器已处于断开状态。
• 绝不使用共享的连接器辅助 CLI 来操作 Outlook 联系人
• 不要手工编写令牌文件，也不要猜测连接器状态；以 outlook-contacts --status 为准

Operating Rules / 操作规则

1. Use search for finding contacts by name, email, or phone number.
   按姓名、邮箱或电话号码查找联系人时使用 search。
2. Use list for browsing contacts with pagination via --page-token (skip value).
   浏览联系人时使用 list，通过 --page-token（skip 值）进行分页。
3. Contact IDs are opaque Graph strings (for example AAMkAD...); use the exact value from list or search.
   联系人 ID 是不透明的 Graph 字符串（例如 AAMkAD...）；请使用 list 或 search 返回的精确值。
4. create, update, and delete may proceed from a clear, unambiguous user request without an additional confirmation.
   对于清晰、无歧义的用户请求，create、update 和 delete 可以直接执行，无需额外确认。
5. When updating a contact, only the specified fields change; unspecified fields keep their existing values.
   更新联系人时，只有指定的字段会变化；未指定的字段保持原有值。
6. If the CLI reports an auth error, re-check outlook-contacts --status and guide the user through reconnecting.
   如果 CLI 报告认证错误，重新检查 outlook-contacts --status，并引导用户完成重新连接。
7. Never print connector secrets or dump raw contact payloads unless the user explicitly asks for them.
   除非用户明确要求，绝不打印连接器密钥或倾倒原始联系人数据。
8. Never surface raw Graph identifiers (contact ids like AAMkAD...) or other internal response fields (change keys, page/skip tokens, raw JSON) in text shown to the user — including in summaries, lists, or per-item annotations. Reuse the ids only internally to chain follow-up commands (rule 3). The sole exceptions are when the user explicitly asks for a raw id or you must show one to troubleshoot a failure.
   绝不在展示给用户的文本中暴露原始 Graph 标识符（如 AAMkAD... 这样的联系人 ID）或其他内部响应字段（change key、分页/skip 令牌、原始 JSON）——包括在摘要、列表或逐条注释中。这些 ID 只能在内部复用以串联后续命令（见规则 3）。仅有的例外是：用户明确要求提供原始 ID，或你必须展示某个 ID 来排查故障。
   【评论】规则 8 与规则 4 形成对照：写操作免确认以提高效率，但内部标识符一律不外露，属于"操作放行、信息收口"的安全设计。