用途：为 glab 命令行工具提供参考与工作流，覆盖仓库、合并请求、议题、CI/CD、发布与 API 操作，适用于 GitLab.com 及自管理/专属实例。
主要能力：仓库与项目操作（repo view、repo clone）；合并请求（mr create/list/view/diff/checkout/note/update/merge）；议题（issue list/view/create/note/update）；CI/CD（ci list/status/view/trace/run）；发布（release create/view）；API（glab api，支持 REST 与 graphql 及 :fullpath、:branch 等占位符）。
使用方式：默认让 glab 使用当前上下文，在 Git 仓库中优先直接运行 glab <command>。仅当目标为其他仓库或实例、或上下文解析错误时，才添加 GITLAB_HOST、--hostname 或 -R。检测平台时检查 git remote -v，优先 GitLab 远程；gitlab.com 视为 gitlab.com，其他主机视为自管理或专属；多主机存在时视为歧义，写操作前需确认。复用显式上下文的模式包括 glab <command>、GITLAB_HOST="$host" glab <command>、glab <command> -R "$repo" 及其组合。选择上下文后检查认证：glab auth status、glab auth status --hostname "$host"、glab auth status --all；登录用 glab auth login（可加 --hostname、--stdin、--token）。随后执行任务命令。GITLAB_TOKEN、GITLAB_ACCESS_TOKEN、OAUTH_TOKEN 会覆盖已存凭据。
适用场景：跨 GitLab 实例的日常开发与运维自动化，需处理同一实例其他仓库或其他实例时使用 -R 与 GITLAB_HOST；glab api 跨实例时优先 --hostname。
限制：Git 远程同时指向 GitHub 与 GitLab 且目标不明、检测主机与认证主机不一致、私有主机却用 gitlab.com URL、主机与仓库路径混用不同实例时，应停止并重新评估。若 git remote -v 无 GitLab 远程，应确认是否在目标仓库，必要时询问主机或仓库 URL，避免猜测私有安装为 gitlab.com。多 GitLab 主机时不得静默选择其一用于写操作。具体命令语法与文档链接见 references/verified-commands.md。