用于列出指定角色的所有权限（capabilities），支持按字母顺序排序或显示权限的授予状态。
适合在需要查看角色具体权限、调试权限分配或检查用户角色时使用。
| 参数 | 说明 |
|---|---|
<role> |
角色键名或角色名称。 |
[--format=<format>] |
以特定格式渲染输出。默认值：list。选项：list、table、csv、json、count、yaml。 |
[--show-grant] |
显示角色定义的所有权限，包括授予状态。默认值：false。 |
$ wp cap list 'contributor' | sort