授权操作
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 需要 · Vendor-specific
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 命令执行
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# OAuth Ops
이 스킬은 Hub LLM OAuth 운영 절차를 표준화한다. Refresh 자동화 자체는 `ai.hub.llm-oauth-monitor` launchd와 Hub 런타임이 담당한다. 스킬은 장애 대응, 재인증 판단, 리포트 해석, 운영자 액션 정리에만 사용한다.
## 기본 원칙
- 원문 토큰, refresh token, authorization header, client secret, API key를 출력하지 않는다.
- `ai.hub.llm-oauth-monitor`는 유지한다. 이 job은 15분 polling과 refresh/reimport를 담당한다.
- `llm-oauth4-master-review`는 daily 또는 on-demand 리포트로 취급한다. 실시간 refresh 책임을 주지 않는다.
- 장애 판단은 Hub selector/provider 상태, token-store expiry, live probe, local reimport 결과를 분리해서 본다.
- Gemini CLI OAuth는 짧은 수명 토큰 특성이 있으므로 live refresh probe와 reimport 결과를 함께 확인한다.
## 빠른 점검
```bash
npm --prefix bots/hub run -s oauth:monitor
npm --prefix bots/hub run -s oauth:runtime-refresh-gate
npm --prefix bots/hub run -s oauth:ops-readiness
```
Hub control tool로 조회할 수 있으면 먼저 read-only tool을 쓴다.
- `oauth.ops.status`: provider별 expiry/healthy 상태 조회
- `oauth.ops.events`: `agent.event_lake`의 `hub_oauth_monitor` 표준 이벤트 조회
- `oauth.ops.lock_janitor_plan`: OAuth refresh lock dry-run janitor 계획 조회
## 장애 대응 기준
- `healthy=false`: provider 인증 자체가 깨진 상태다. refresh/reimport 결과와 error를 확인하고 브라우저 재인증 또는 CLI login을 진행한다.
- `needs_refresh=true`: 만료 임박이다. monitor가 refresh/reimport를 시도했는지 먼저 본다.
- `refresh_ok=true`: Hub token-store refresh는 성공했다. local sync 실패 여부만 별도로 본다.
- `reimport_ok=true` 또는 `post_probe_reimport_ok=true`: 로컬 credential을 token-store에 재반영했다.
- `live_probe_ok=false`: token-store가 있어도 실제 호출 경로가 실패한다. provider cooldown, 권한, 네트워크, CLI 상태를 분리해서 본다.
- `lock_timeout`: refresh lock이 오래 남은 상태일 수 있다. `oauth.ops.lock_janitor_plan` 후 필요 시 별도 승인으로 janitor apply를 진행한다.
## Provider별 재인증 메모
- Claude Code OAuth: Claude CLI login/keychain 상태와 Hub token-store를 분리해서 본다. Sonnet quota 이슈와 OAuth 만료 이슈를 혼동하지 않는다.
- OpenAI Codex OAuth: Codex local auth와 Hub token-store sync를 확인한다. OpenAI public API key는 옵션이며 기본 경로가 아니다.
- Gemini CLI OAuth: CLI가 live refresh를 수행할 수 있으면 만료 임박 local token이어도 즉시 장애로 보지 않는다.
- Gemini OAuth: quota project와 Code Assist service 활성 상태를 함께 본다.
- Groq: 여러 키 pool 상태를 확인하되 OAuth refresh 범위와 분리한다.
## 금지
- 스킬 절차 안에서 토큰 값을 수집하거나 문서화하지 않는다.
- refresh 자동화를 shell hook이나 스킬로 옮기지 않는다.
- monitor job을 끄고 수동 재인증 중심으로 운영하지 않는다.
- provider failure를 모델 교체만으로 숨기지 않는다. 인증/쿼터/네트워크 원인을 별도로 기록한다.
---
> Source: [AlexLee00/ai-agent-system](https://github.com/AlexLee00/ai-agent-system) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
章节与文件索引
按说明文件中的顺序排列。
基本原则
快速检查
故障响应标准
提供商重新验证注释
禁止
文件/命令 -> ai.hub.llm-oauth-monitor · llm-oauth4-master-review · oauth.ops.status · oauth.ops.events · agent.event_lake · hub_oauth_monitor · oauth.ops.lock_janitor_plan · healthy=false
内容校验值 -> 20d217cbc18a
当前原文的自动摘译,尚未人工审校。
基本原则
不输出原始令牌、刷新令牌、授权标头、客户端密钥和 API 密钥。
ai.hub.llm-oauth-monitor被维持。该作业负责 15 分钟的轮询和刷新/重新导入。llm-oauth4-master-review被视为每日报告或按需报告。没有实时刷新的责任。为了确定失败,需要单独查看集线器选择器/提供者状态、令牌存储到期、实时探测和本地重新导入结果。 Gemini CLI OAuth 具有短暂的令牌特征,因此请检查实时刷新探测并一起重新导入结果。快速检查
如果可以使用集线器控制工具进行搜索,请先使用只读工具。
oauth.ops.status:检查提供商的过期/健康状态oauth.ops.events:检查agent.event_lake的hub_oauth_monitor标准事件oauth.ops.lock_janitor_plan:检查OAuth刷新锁定干运行看门人计划故障响应标准
healthy=false:提供商身份验证本身已损坏。检查刷新/重新导入结果和错误,然后继续浏览器重新身份验证或 CLI 登录。needs_refresh=true:即将到期。首先,检查监视器是否尝试刷新/重新导入。refresh_ok=true:Hub 令牌存储刷新成功。仅单独检查本地同步失败。reimport_ok=true或post_probe_reimport_ok=true:本地凭证已反映回令牌存储区。live_probe_ok=false:即使有令牌存储,实际的调用路径也会失败。分别查看提供商的冷却时间、权限、网络和 CLI 状态。提供商重新验证注释
Claude Code OAuth:分别查看 Claude CLI 登录/钥匙串状态和 Hub 令牌存储。不要将 Sonnet 配额问题与 OAuth 过期问题混淆。 OpenAI Codex OAuth:检查 Codex 本地身份验证和 Hub 令牌存储同步。 OpenAI 公共 API 密钥是可选的,不是默认路径。 Gemini CLI OAuth:如果 CLI 可以执行实时刷新,即使本地令牌即将过期,也不会立即被视为失败。 Gemini OAuth:一起查看配额项目和 Code Assist 服务激活状态。 Groq:检查多个密钥池的状态,但将它们与 OAuth 刷新范围分开。
禁止
不要在技能程序中收集或记录令牌值。不要将刷新自动化移至 shell 挂钩或技能。关闭监控作业,不要专注于手动重新验证。模型替换不会隐藏提供者故障。分别记录认证/配额/网络原因。资料来源:AlexLee00/ai-agent-system — 由 TomeVault 分发。