用途：为 AI 智能体提供 Google 通讯录的完整增删改查（CRUD）能力，可搜索、列出、获取、创建、更新和删除联系人。
主要能力：搜索支持按姓名、邮箱或电话查找；列表为分页返回，按姓氏排序；获取按 resource name 拉取单个联系人完整详情；创建可填写名、姓、邮箱、电话、组织、职位和备注；更新采用 patch 方式，仅修改提供的字段，脚本会自动获取当前 etag 做冲突检测；删除按 ID 移除联系人。
使用方式：先决条件为启用 Google People API 的 Google Cloud 项目，以及 OAuth 2.0 凭据（gcloud ADC 或 credentials.json）。推荐一次性配置 Gmail、Calendar 和 Contacts：uv run ~/.agents/skills/gmail/scripts/setup_workspace.py。手动配置可用 gcloud auth application-default login --scopes https://www.googleapis.com/auth/contacts,https://www.googleapis.com/auth/cloud-platform，然后运行 uv run skills/google-contacts/scripts/contacts.py verify 验证。也可将 credentials.json 放到 ~/.contacts_credentials/ 后运行 uv run skills/google-contacts/scripts/contacts.py setup。常用命令包括 search --query、list --limit/--page-token、get --id、create、update --id、delete --id，输出为 JSON，列表结果含 totalItems 与 nextPageToken。
适用场景：由智能体自动维护联系人信息、按线索查找联系方式、批量或按需创建与更新通讯录条目。
限制：需要用户自行准备 Google Cloud 项目与 OAuth 凭据；列表为分页，需用 nextPageToken 翻页；更新依赖 etag 检测冲突；具体权限范围、调用配额与失败处理细节暂未提供。