搜索和查看 macOS 通讯录中的联系人信息。当用户需要查找联系人电话、邮箱、地址等信息时使用。Use when the user needs to find contact phone numbers, emails, or addresses. Keywords: 通讯录, Contacts, 联系人, 电话, 邮箱.
通过 macOS Contacts.app 搜索和查看联系人信息。
BASE="${CLAUDE_PLUGIN_ROOT:-${CODEX_HOME:-$HOME/.codex}}"
SKILLS_ROOT="$BASE/skills"
[ -d "$SKILLS_ROOT/contacts/scripts" ] || SKILLS_ROOT="$BASE/indie-toolkit/mactools/skills"
${SKILLS_ROOT}/contacts/scripts/contacts.sh
按名称模糊搜索，返回匹配的联系人及其电话、邮箱摘要。
${SKILLS_ROOT}/contacts/scripts/contacts.sh search "张三"
${SKILLS_ROOT}/contacts/scripts/contacts.sh search -n 10 "Zhang"
显示完整联系人信息：电话、邮箱、地址、公司、职位、生日、备注。
${SKILLS_ROOT}/contacts/scripts/contacts.sh show "张三"
仅显示姓名列表。
${SKILLS_ROOT}/contacts/scripts/contacts.sh list
${SKILLS_ROOT}/contacts/scripts/contacts.sh list -n 50
${SKILLS_ROOT}/contacts/scripts/contacts.sh groups
${SKILLS_ROOT}/contacts/scripts/contacts.sh group "同事"
${SKILLS_ROOT}/contacts/scripts/contacts.sh group -n 50 "家人"
| 参数 | 说明 | 默认值 |
|---|---|---|
-n <count> | 最大结果数 | 20 |
从用户问题中判断：
search 模糊搜索show 获取完整信息groups 列出群组，再用 group 查看成员从返回的联系人信息中提取用户需要的部分。如果用户只问电话号码，只返回电话相关信息即可。
show 命令优先精确匹配全名，无结果时回退到模糊匹配