用途：这是 Glean CLI 的共享参考文档，所有其他 glean 技能都假定使用者已了解此处描述的认证、参数与输出格式，因此应先阅读本技能。
安装：brew install gleanwork/tap/glean-cli
认证：交互式浏览器 OAuth 使用 glean auth login，验证凭据使用 glean auth status；CI/脚本场景可设置环境变量 export GLEAN_API_TOKEN=your-token 与 export GLEAN_HOST=your-company-be.glean.com。凭据解析顺序为环境变量 → 系统密钥环 → ~/.glean/config.json。
语法与全局参数：glean <command> [subcommand] [flags]。全局参数包括 --output（json 默认、ndjson 每行一条结果、text）、--fields（点路径字段投影，如 results.document.title,results.document.url）、--json（完整 JSON 请求体，覆盖其他参数）、--dry-run（打印请求体但不发送）。
模式自省：使用未用过的命令前应先调用 glean schema，例如 glean schema | jq '.commands' 列出全部命令，glean schema search | jq '.flags' 查看 search 的参数。
安全规则：不要直接输出 API 令牌或密钥；自动化流水线中执行写入/删除操作前先用 --dry-run；CI/CD 优先使用环境变量而非配置文件。
错误处理：所有错误写入 stderr，stdout 只包含结构化输出；退出码 0 表示成功，非零表示错误。
可用命令：activity（report、feedback）、agents（list、get、schemas、run）、announcements（create、update、delete）、answers（list、get、create、update、delete）、api（对任意 Glean REST 端点发起已认证的原始 HTTP 请求）、chat（与 Glean AI 对话，流式输出到 stdout）、collections（create、delete、update、add-items、delete-item）、documents（get、get-by-facets、get-permissions、summarize）、entities（list、read-people）、insights（get）、messages（get）、pins（list、get、create、update、remove）、search（搜索实例内容，结果为 JSON）、shortcuts（go-links 的 list、get、create、update、delete）、tools（list、run）、verification（list、verify、remind）。
限制：资料未提供具体收费、平台支持范围与效果说明。