{
  "version": 1,
  "source": {
    "kind": "explicit",
    "name": "dws-agent-selection/contact",
    "repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
    "channel": "open-source",
    "reviewed": true
  },
  "tools": {
    "contact.add_employee": {
      "agent_summary": "按手机号邀请一名员工加入当前企业",
      "use_when": [
        "用户明确要求邀请或添加员工到当前企业，且已提供企业内姓名和手机号"
      ],
      "avoid_when": [
        "需要创建企业专属登录账号时使用 contact account create；需要创建企业组织本身时使用 contact org create"
      ],
      "examples": [
        "dws contact user invite --org-user-name \"张三\" --org-user-mobile \"13800138000\" --depts '[{\"deptId\":1}]'"
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、Wukong-compatible handler 与产品 Skill 审阅邀请员工的正向意图、兄弟命令消歧和可执行示例；不改变命令身份、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.add_employee",
        "cobra-help:dws contact user invite",
        "Skill:skills/mono/references/products/contact.md",
        "live-dws-schema:contact.add_employee#FAILED"
      ]
    },
    "contact.exclusive_account_create": {
      "agent_summary": "为当前企业创建专属登录账号",
      "use_when": [
        "用户明确要求创建企业账号、专属账号或企业登录账号，并已提供员工名称和登录号"
      ],
      "avoid_when": [
        "创建企业组织本身应使用 contact org create；仅邀请已有手机号员工入企应使用 contact user invite"
      ],
      "examples": [
        "dws contact account create --org-user-name \"张三\" --login-id \"zhangsan001\" --org-user-mobile \"13800138000\""
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、Wukong-compatible handler 与产品 Skill 审阅企业账号创建的长模式消歧和可执行示例；不改变命令身份、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.exclusive_account_create",
        "cobra-help:dws contact account create",
        "Skill:skills/mono/references/products/contact.md",
        "live-dws-schema:contact.exclusive_account_create#FAILED"
      ]
    },
    "contact.get_authorized_emp_rosterInfo": {
      "agent_summary": "按字段 code 查询指定员工花名册字段值",
      "use_when": [
        "已确认 staffId 与可见字段 code，需要读花名册字段"
      ],
      "avoid_when": [
        "尚不知道可见字段时先用 contact user profile fields",
        "普通通讯录姓名搜索不要走花名册"
      ],
      "examples": [
        "dws contact user profile get --staff-id STAFF_ID --fields fieldCode1,fieldCode2"
      ],
      "reviewed": true,
      "review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.get_authorized_emp_rosterInfo",
        "cobra-help:dws contact user profile get",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.get_authorized_emp_rosterInfo",
        "internal/cli/schema_command_registry.json#contact.get_authorized_emp_rosterInfo",
        "skills/mono/references/products/contact.md",
        "live-dws-schema:contact.get_authorized_emp_rosterInfo#FAILED",
        "pinned-mcp:contact.get_authorized_emp_rosterInfo"
      ]
    },
    "contact.get_current_user_profile": {
      "agent_summary": "获取当前登录用户资料与 userId",
      "use_when": [
        "用户问我是谁/我的 userId/当前账号信息"
      ],
      "avoid_when": [
        "查他人详情用 contact user get 或先搜索"
      ],
      "examples": [
        "dws contact user get-self --format json"
      ],
      "reviewed": true,
      "review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.get_current_user_profile",
        "cobra-help:dws contact user get-self",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.get_current_user_profile",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#contact.get_current_user_profile",
        "internal/cli/schema_command_registry.json#contact.get_current_user_profile",
        "skills/mono/references/products/contact.md",
        "live-dws-schema:contact.get_current_user_profile"
      ]
    },
    "contact.get_dept_info_by_dept_id": {
      "agent_summary": "获取指定部门详情",
      "use_when": [
        "已知 deptId，需要部门名称、人数等详情时"
      ],
      "avoid_when": [
        "只知道部门名称时应先搜索部门；需要列出直属子部门时改用子部门查询。"
      ],
      "examples": [
        "dws contact dept get-info --dept 12345 --format json"
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.get_dept_info_by_dept_id",
        "cobra-help:dws contact dept get-info",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.get_dept_info_by_dept_id"
      ]
    },
    "contact.get_dept_members_by_deptId": {
      "agent_summary": "查看部门成员（逗号分隔 deptId）",
      "use_when": [
        "需要按一个或多个 deptId 查看部门成员名单时"
      ],
      "avoid_when": [
        "只需部门详情或人数时使用 contact dept get-info；需要直属子部门时使用 contact dept list-children"
      ],
      "examples": [
        "dws contact dept list-members --depts 12345,67890 --format json"
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.get_dept_members_by_deptId",
        "cobra-help:dws contact dept list-members",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.get_dept_members_by_deptId",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#contact.get_dept_members_by_deptId"
      ]
    },
    "contact.get_sub_depts_by_dept_id": {
      "agent_summary": "列出指定部门的直属子部门",
      "use_when": [
        "已知父部门 deptId，需要列出直属子部门时"
      ],
      "avoid_when": [
        "需要父部门自身详情或递归组织树时不要使用；该命令只列直属子部门。"
      ],
      "examples": [
        "dws contact dept list-children --dept 12345 --format json"
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.get_sub_depts_by_dept_id",
        "cobra-help:dws contact dept list-children",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.get_sub_depts_by_dept_id"
      ]
    },
    "contact.get_user_info_by_user_ids": {
      "agent_summary": "按 userId 批量获取员工详情（部门/主管等，受可见性限制）",
      "use_when": [
        "已有一个或多个 userId，需要部门、主管等详情"
      ],
      "avoid_when": [
        "还没有 userId 时先 search / aisearch person",
        "查自己不要传 me/self，用 contact user get-self"
      ],
      "examples": [
        "dws contact user get --ids userId1,userId2"
      ],
      "reviewed": true,
      "review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.get_user_info_by_user_ids",
        "cobra-help:dws contact user get",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.get_user_info_by_user_ids",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#contact.get_user_info_by_user_ids",
        "internal/cli/schema_command_registry.json#contact.get_user_info_by_user_ids",
        "skills/mono/references/products/contact.md",
        "live-dws-schema:contact.get_user_info_by_user_ids"
      ]
    },
    "contact.list_authorized_roster_fields": {
      "agent_summary": "查询当前用户有权查看的花名册字段",
      "use_when": [
        "查询花名册前，需要先确认当前用户可见的字段 code 时"
      ],
      "avoid_when": [
        "需要读取某位员工的具体花名册字段值时不要停在字段目录，应再调用员工花名册查询。"
      ],
      "examples": [
        "dws contact user profile fields --format json"
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.list_authorized_roster_fields",
        "cobra-help:dws contact user profile fields",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.list_authorized_roster_fields"
      ]
    },
    "contact.list_my_followings": {
      "agent_summary": "获取当前用户的特别关注列表",
      "use_when": [
        "需要查看当前用户特别关注或星标联系人时"
      ],
      "avoid_when": [
        "需要搜索企业通讯录或查询任意员工详情时不要使用；这里只返回当前用户的特别关注列表。"
      ],
      "examples": [
        "dws contact relation list-my-followings --format json"
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.list_my_followings",
        "cobra-help:dws contact relation list-my-followings",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.list_my_followings"
      ]
    },
    "contact.org_create": {
      "agent_summary": "创建一个新的钉钉企业组织",
      "use_when": [
        "用户明确要求创建、新建、开通或初始化企业组织，并已提供企业名称和创建者企业内名称"
      ],
      "avoid_when": [
        "请求中包含企业账号、专属账号或登录账号时改用 contact account create；邀请员工时改用 contact user invite"
      ],
      "examples": [
        "dws contact org create --org-name \"我的企业\" --creator-username \"张三\""
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、Wukong-compatible handler 与产品 Skill 审阅企业组织创建的意图边界和可执行示例；不改变命令身份、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.org_create",
        "cobra-help:dws contact org create",
        "Skill:skills/mono/references/products/contact.md",
        "live-dws-schema:contact.org_create#FAILED"
      ]
    },
    "contact.query_dismission_employee_list": {
      "agent_summary": "查询离职员工列表",
      "use_when": [
        "需要按姓名、离职时间或部门查询离职员工时"
      ],
      "avoid_when": [
        "需要查询在职员工或修改离职信息时不要使用；该命令只检索离职员工记录。"
      ],
      "examples": [
        "dws contact user dismission search --format json",
        "dws contact user dismission search --name \"张三\" --format json"
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.query_dismission_employee_list",
        "cobra-help:dws contact user dismission search",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.query_dismission_employee_list"
      ]
    },
    "contact.search_contact_by_key_word": {
      "agent_summary": "按关键词搜索好友和同事，提取 userId/openDingTalkId",
      "use_when": [
        "按姓名等关键词在通讯录里精确搜人，并需要 userId 或 openDingTalkId"
      ],
      "avoid_when": [
        "职责/上级/技能等语义找人优先 aisearch person",
        "已有 userId 查详情用 contact user get",
        "查自己用 contact user get-self"
      ],
      "examples": [
        "dws contact user search --query \"张三\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.search_contact_by_key_word",
        "cobra-help:dws contact user search",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.search_contact_by_key_word",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#contact.search_contact_by_key_word",
        "internal/cli/schema_command_registry.json#contact.search_contact_by_key_word",
        "skills/mono/references/products/contact.md",
        "live-dws-schema:contact.search_contact_by_key_word"
      ]
    },
    "contact.search_dept_by_keyword": {
      "agent_summary": "按关键词搜索部门",
      "use_when": [
        "只知道部门名称或关键词，需要定位 deptId 时"
      ],
      "avoid_when": [
        "已经有准确部门 ID 并需要详情时改用部门详情命令；该命令用于关键词定位部门。"
      ],
      "examples": [
        "dws contact dept search --query \"技术部\" --format json"
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.search_dept_by_keyword",
        "cobra-help:dws contact dept search",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.search_dept_by_keyword",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#contact.search_dept_by_keyword"
      ]
    },
    "contact.search_user_by_mobile": {
      "agent_summary": "按手机号搜索用户",
      "use_when": [
        "已知手机号，需要精确搜索用户时"
      ],
      "avoid_when": [
        "已有用户 ID 或需要批量用户详情时改用批量详情命令；该命令仅按手机号定位用户。"
      ],
      "examples": [
        "dws contact user search-mobile --mobile 13800138000 --format json"
      ],
      "reviewed": true,
      "review_reason": "依据真实 Cobra leaf、对应产品 Skill 与现有 structured hints 审阅选择语义和示例；不改变命令身份、参数、安全或接口事实。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.search_user_by_mobile",
        "cobra-help:dws contact user search-mobile",
        "Skill:skills/mono/references/products/contact.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#contact.search_user_by_mobile",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#contact.search_user_by_mobile"
      ]
    },
    "contact.department_create": {
      "agent_summary": "在当前企业的根部门或指定父部门下创建部门",
      "use_when": [
        "用户明确要求新建部门，且已确认部门名称、父部门及是否同步创建部门群"
      ],
      "avoid_when": [
        "修改已有部门名称或父级应使用 contact dept update；仅查找部门应使用 contact dept search"
      ],
      "examples": [
        "dws contact dept create --name \"新产品部\" --create-dept-group=true"
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf、确认门禁和 Wukong 对齐实现审阅创建部门的选择边界与无 --yes 合约示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.department_create",
        "cobra-help:dws contact dept create",
        "Wukong-parity:3306c3307",
        "live-dws-schema:contact.department_create#FAILED"
      ]
    },
    "contact.department_update": {
      "agent_summary": "更新指定部门的名称，并可调整父部门",
      "use_when": [
        "用户明确要求修改已有部门名称或迁移父部门，且已确认目标 deptId"
      ],
      "avoid_when": [
        "创建新部门应使用 contact dept create；仅查看部门信息应使用 contact dept get-info"
      ],
      "examples": [
        "dws contact dept update --dept 12345 --name \"研发中心\""
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf、确认门禁和 Wukong 对齐实现审阅部门更新的选择边界与无 --yes 合约示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.department_update",
        "cobra-help:dws contact dept update",
        "Wukong-parity:3306c3307",
        "live-dws-schema:contact.department_update#FAILED"
      ]
    },
    "contact.employee_update": {
      "agent_summary": "修改指定员工的企业内姓名、所属部门或直属主管",
      "use_when": [
        "用户明确要求更新已有员工的组织信息，且已确认目标 userId 和至少一个修改项"
      ],
      "avoid_when": [
        "修改当前用户自己的昵称或头像应使用 contact user update-self；创建企业专属账号应使用 contact account create"
      ],
      "examples": [
        "dws contact user update --user-id user001 --org-user-name \"张三三\""
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf、确认门禁和 Wukong 对齐实现审阅员工组织信息更新的选择边界与无 --yes 合约示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.employee_update",
        "cobra-help:dws contact user update",
        "Wukong-parity:3306c3307",
        "live-dws-schema:contact.employee_update#FAILED"
      ]
    },
    "contact.exclusive_account_user_update": {
      "agent_summary": "更新企业专属账号的组织信息或个人资料",
      "use_when": [
        "用户明确要求修改已有企业专属账号的姓名、部门、主管、昵称或头像"
      ],
      "avoid_when": [
        "创建新企业专属账号应使用 contact account create；修改普通员工组织信息应使用 contact user update"
      ],
      "examples": [
        "dws contact account update --user-id user001 --nick \"新昵称\""
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf、确认门禁和 Wukong 对齐实现审阅企业账号更新的选择边界与无 --yes 合约示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.exclusive_account_user_update",
        "cobra-help:dws contact account update",
        "Wukong-parity:3306c3307",
        "live-dws-schema:contact.exclusive_account_user_update#FAILED"
      ]
    },
    "contact.self_user_profile_update": {
      "agent_summary": "更新当前登录用户自己的昵称或头像",
      "use_when": [
        "用户明确要求修改自己的 profile 昵称或头像 fileId"
      ],
      "avoid_when": [
        "修改其他员工的组织信息应使用 contact user update；修改企业专属账号应使用 contact account update"
      ],
      "examples": [
        "dws contact user update-self --nick \"新昵称\""
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf、确认门禁和 Wukong 对齐实现审阅当前用户资料更新的选择边界与无 --yes 合约示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=contact.self_user_profile_update",
        "cobra-help:dws contact user update-self",
        "Wukong-parity:3306c3307",
        "live-dws-schema:contact.self_user_profile_update#FAILED"
      ]
    },
    "contact.shortcut_list_followings": {
      "agent_summary": "获取当前用户的特别关注列表",
      "use_when": [
        "当你想查看本人在通讯录里「特别关注」的联系人名单（例如常打交道的同事、上级）时使用；无需输入，返回关注对象的用户列表，可用于快速定位这些人的 userId 再发消息或排日程。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +list-followings"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_list_followings",
        "cobra-help:dws contact +list-followings",
        "ShortcutRegistry:contact +list-followings"
      ]
    },
    "contact.shortcut_search_user": {
      "agent_summary": "按关键词搜索通讯录用户",
      "use_when": [
        "当你只知道某人的姓名、花名或部分名字，需要把它解析成 userId 及部门等信息以便后续发消息、排日程或指派任务时使用；输入搜索关键词（--query），返回匹配的用户列表。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +search-user --query \"张三\""
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_search_user",
        "cobra-help:dws contact +search-user",
        "ShortcutRegistry:contact +search-user"
      ]
    },
    "contact.shortcut_search_mobile": {
      "agent_summary": "按手机号搜索通讯录用户",
      "use_when": [
        "当你手里只有某人的手机号、需要反查出对应的通讯录用户和 userId 时使用；输入手机号（--mobile），返回该手机号所属的用户信息，适合从电话或名片信息定位到具体员工。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +search-mobile --mobile 13800138000"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_search_mobile",
        "cobra-help:dws contact +search-mobile",
        "ShortcutRegistry:contact +search-mobile"
      ]
    },
    "contact.shortcut_list_roles": {
      "agent_summary": "获取企业所有角色（标签）列表",
      "use_when": [
        "当你想总览企业里都有哪些角色/员工标签（如「管理员」「财务」「销售」）及其角色 ID 时使用；无需输入，返回全量角色列表，常用于按角色圈定人群前先摸清有哪些角色可选。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +list-roles"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_list_roles",
        "cobra-help:dws contact +list-roles",
        "ShortcutRegistry:contact +list-roles"
      ]
    },
    "contact.shortcut_list_role_members": {
      "agent_summary": "查询角色下的成员列表",
      "use_when": [
        "当你已知某个角色 ID、想列出该角色（标签）下的全部成员以便群发通知或统计人群时使用；输入角色 ID（--id），返回该角色下的用户列表，通常先用 +search-role 拿到角色 ID 再调用。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +list-role-members --id 12345"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_list_role_members",
        "cobra-help:dws contact +list-role-members",
        "ShortcutRegistry:contact +list-role-members"
      ]
    },
    "contact.shortcut_list_sub_depts": {
      "agent_summary": "查看指定部门的子部门",
      "use_when": [
        "当你想逐层浏览组织架构、查看某个部门下一级的子部门时使用；输入父部门 ID（--dept，根部门为 1），返回其直属子部门列表，可用于自顶向下遍历部门树。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +list-sub-depts --dept 1"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_list_sub_depts",
        "cobra-help:dws contact +list-sub-depts",
        "ShortcutRegistry:contact +list-sub-depts"
      ]
    },
    "contact.shortcut_list_dept_members": {
      "agent_summary": "查看部门成员（仅本部门，不含下级）",
      "use_when": [
        "当你想列出一个或多个部门本级的员工（不含下级子部门）以便群发通知、统计或指派任务时使用；输入部门 ID 列表（--depts，逗号分隔），返回这些部门下的成员，如需含下级需自行遍历子部门。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +list-dept-members --depts 12345,67890"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_list_dept_members",
        "cobra-help:dws contact +list-dept-members",
        "ShortcutRegistry:contact +list-dept-members"
      ]
    },
    "contact.shortcut_by_mobile": {
      "agent_summary": "按手机号查询某人的完整资料（自动解析 userId 后取详情）",
      "use_when": [
        "当你只知道对方手机号、想一步拿到其完整资料（部门、职位、联系方式、是否管理员等）而不想先按手机号搜出 userId 再单独查详情时使用；内部先用手机号在通讯录里查出对应的 userId，若没有人绑定该手机号会明确报错，再用该 userId 取完整详情。这是纯只读操作，不会修改任何数据。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +by-mobile --mobile 13800138000"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_by_mobile",
        "cobra-help:dws contact +by-mobile",
        "ShortcutRegistry:contact +by-mobile"
      ]
    },
    "contact.shortcut_dept_members": {
      "agent_summary": "按部门名列出部门成员（自动解析 deptId）",
      "use_when": [
        "当你只知道某个部门的名称、想知道该部门里都有哪些成员时使用；内部先按部门名搜索出唯一的 deptId（匹配到 0 个或多个时不猜测，而是列出候选部门名与 deptId 让你选），再打印该部门的直接成员列表（仅本部门，不递归下级部门）。只读，不做任何修改。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +dept-members --dept 技术部"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_dept_members",
        "cobra-help:dws contact +dept-members",
        "ShortcutRegistry:contact +dept-members"
      ]
    },
    "contact.shortcut_lookup": {
      "agent_summary": "按姓名查询某人的完整资料（自动解析 userId 后取详情）",
      "use_when": [
        "当你只知道对方姓名、想一步拿到其完整资料（部门、职位、联系方式等）而不想先搜 userId 再查详情时使用；内部先按姓名搜通讯录解析出唯一 userId，再取详情，姓名匹配到多人时会列出候选让你区分。只读操作。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +lookup --name 张三"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_lookup",
        "cobra-help:dws contact +lookup",
        "ShortcutRegistry:contact +lookup"
      ]
    },
    "contact.shortcut_org": {
      "agent_summary": "按姓名查某人所在部门的详情（自动解析 userId 与 deptId）",
      "use_when": [
        "当你只知道某位同事的姓名、想知道 TA 所在部门（部门ID、名称、人数）时使用；内部先按姓名解析出唯一 userId，再取 TA 的组织信息拿到主部门 deptId，最后打印该部门的详情。只读，不做任何修改。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +org --name 张三"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_org",
        "cobra-help:dws contact +org",
        "ShortcutRegistry:contact +org"
      ]
    },
    "contact.shortcut_resolve_dept": {
      "agent_summary": "按名称搜索部门并解析出唯一 deptId（只读）",
      "use_when": [
        "当你只知道某个部门的名称（或名称里的关键词）、想把它解析成可直接用于后续工具的 deptId 时使用；内部按 --name 关键词调用 search_dept_by_keyword 搜索部门，再在本地投影出每个候选的 deptId 和 name。如果只命中一个部门就直接返回它的 deptId；如果命中多个则列出全部候选让你消歧，绝不替你瞎猜；如果一个都没命中则提示未找到。这是纯只读操作，只做搜索与本地投影，不会修改任何部门，也不会列出部门成员。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +resolve-dept --name 技术部"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_resolve_dept",
        "cobra-help:dws contact +resolve-dept",
        "ShortcutRegistry:contact +resolve-dept"
      ]
    },
    "contact.shortcut_team": {
      "agent_summary": "按姓名列出某人所在部门的成员（自动解析 userId 与 deptId）",
      "use_when": [
        "当你只知道某位同事的姓名、想知道 TA 所在部门里都有哪些成员时使用；内部先按姓名解析出唯一 userId，再取 TA 的组织信息拿到主部门 deptId，最后打印该部门的直接成员列表（仅本部门，不递归下级部门）。只读，不做任何修改。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +team --name 张三"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_team",
        "cobra-help:dws contact +team",
        "ShortcutRegistry:contact +team"
      ]
    },
    "contact.shortcut_me": {
      "agent_summary": "查看我自己的通讯录资料（姓名/userId/手机/部门/组织，干净投影）",
      "use_when": [
        "当你（或 AI agent）需要知道「我是谁」——我自己的 userId、姓名、所在部门、组织、手机号，用于后续按名解析他人前先确定自己身份、或填充发起人信息时使用；内部调用零参数的 get_current_user_profile（永远是「我」，无需传姓名），再把冗长的原始资料投影成 {name,userId,mobile,dept,org,email} 几个关键字段。这是纯只读操作，不修改任何资料。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws contact +me"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#contact.shortcut_me",
        "cobra-help:dws contact +me",
        "ShortcutRegistry:contact +me"
      ]
    }
  },
  "products": {
    "contact": {
      "agent_summary": "查询通讯录与花名册，并管理企业、部门、员工及企业账号",
      "use_when": [
        "按姓名/手机号/userId/部门条件做通讯录精确查询，或明确执行企业与员工入企管理"
      ],
      "avoid_when": [
        "职责/上级等语义找人优先 aisearch person；不要用 contact 发消息；写操作前确认当前企业和目标信息"
      ],
      "reviewed": true,
      "review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
      "source_refs": [
        "CommandRegistry:product=contact",
        "Skill:skills/mono/references/products/contact.md",
        "live-dws-schema:product-batch-2026-07-14"
      ]
    }
  }
}