oauth-ops
- Repo stars 0
- Author repo skills-registry
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 결과를 함께 확인한다.
빠른 점검
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를 모델 교체만으로 숨기지 않는다. 인증/쿼터/네트워크 원인을 별도로 기록한다.
<!-- tomevault:4.0:skill_md:2026-05-23 -->Source: AlexLee00/ai-agent-system — distributed by TomeVault.
- Fluxly category
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Author / version / license
- @tomevault-io · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Guided setup
- External API key
- Required · Vendor-specific
- Detected OS requirements
- macOS · Linux · Windows
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Shell exec
- Detected network behavior
- External requests
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. 원문 토큰, 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 control tool로 조회할 수 있으면 먼저 read-only tool을 쓴다. oauth.ops.status: provider별 expiry/healthy 상태 조회 oauth.ops.events: agent.eventlake의 huboauthmonitor 표준 이벤트 조회
healthy=false: provider 인증 자체가 깨진 상태다. refresh/reimport 결과와 error를 확인하고 브라우저 재인증 또는 CLI login을 진행한다. needsrefresh=true: 만료 임박이다. monitor가 refresh/reimport를 시도했는지 먼저 본다. refreshok=true: Hub token-store refresh는 성공했다. local sync 실패 여부만 별도로 본다.
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는 옵션이며 기본 경로가 아니다.
스킬 절차 안에서 토큰 값을 수집하거나 문서화하지 않는다. refresh 자동화를 shell hook이나 스킬로 옮기지 않는다. monitor job을 끄고 수동 재인증 중심으로 운영하지 않는다.
# 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 만료 이슈를 혼동하지 않는다.
… Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> 기본 원칙 → 빠른 점검 → 장애 대응 기준 → Provider별 재인증 메모 → 금지
terms -> 이 스킬은 Hub LLM OAuth 운영 절차를 표준화한다. · - 원문 토큰, refresh token, authorization header, client secret, API key를 출력하지 않는다. · Hub control tool로 조회할 수 있으면 먼저 read-only tool을 쓴다. · - healthy=false: provider 인증 자체가 깨진 상태다. · - Claude Code OAuth: Claude CLI login/keychain 상태와 Hub token-store를 분리해서 본다. · - 스킬 절차 안에서 토큰 값을 수집하거나 문서화하지 않는다. · --- > Source: [AlexLee00/ai-agent-system](https://github.com/AlexLee00/ai-agent-system) — distributed by [TomeVault](https://tomevault.io).
files/cmd -> ai.hub.llm-oauth-monitor · llm-oauth4-master-review · oauth.ops.status · oauth.ops.events · agent.eventlake · huboauthmonitor · oauth.ops.lockjanitorplan · healthy=false
body sha256 -> 20d217cbc18a
Decide Fit First
Design Intent
How To Use It
Boundaries And Review