본문으로 건너뛰기
cccskills
무료GitHub에 공개

nauthilus-plugin-api

Use for Nauthilus native Go plugin API design or implementation, `pluginapi/v1`, plugin loader, plugin registry, plugin runtime, reload integration, plugin config, extension-point parity with Lua, capability-based host services, lifecycle semantics, and the working draft under `server/docs/go_plugin_api_working_draft.md`.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md2.5 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Nauthilus Plugin API

Expertise Lens

  • Work as a language-runtime boundary and extension-platform architect.
  • Optimize for stable public API contracts, trusted-code assumptions, explicit lifecycle, capability-based host services, Lua/Go extension parity, and isolation from server internals.
  • Treat accidental exports of core.AuthState, raw Gin contexts, raw Viper, Redis internals, LDAP queues, Prometheus registerers, or OpenTelemetry providers as API boundary defects.

Sources To Read

  • AGENTS.md
  • POLICY.md
  • server/docs/go_plugin_api_working_draft.md
  • pluginapi/v1/
  • server/pluginloader/
  • server/pluginregistry/
  • server/pluginruntime/
  • Lua extension references under server/lua-plugins.d/ and server/lualib/

Design Rules

  • Keep native Go plugins conceptually aligned with Lua extension points: init, environment sources, subject sources, backends, actions, hooks, policy facts, and shared services.
  • Keep policy as decision authority; plugins emit facts/results/obligations/status, policy decides.
  • Expose stable API-level value objects from pluginapi/v1; do not expose server internals.
  • Use context-first, cancelable, deadline-aware request APIs.
  • Treat loaded Go plugins as trusted in-process code.
  • Make lifecycle explicit: register, start, stop, and reconfigure where supported.
  • Remember Go .so plugins cannot be unloaded; removal or binary replacement normally requires restart.
  • Validate module and component names strictly; do not normalize surprising names into collisions.

Implementation Workflow

  1. Start from the working draft and decide whether the task is design-only or implementation.
  2. Keep public API changes in pluginapi/v1 narrow and documented.
  3. Keep host services capability-based and minimal.
  4. Keep reload behavior explicit and testable.
  5. Add import-boundary and contract tests when public API or server boundary rules change.

Validation

  • Run focused plugin API tests with GOEXPERIMENT=runtimesecret.
  • Run reload/config tests when plugin config or lifecycle changes.
  • Run GOEXPERIMENT=runtimesecret make test and git diff --check.
  • Run make guardrails before commit or pull request.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Use for Nauthilus OpenAPI, generated management or IdP clients, route contract tests, gRPC protobuf generation, HTTP route registration, management API authentication, public discovery API, `server/openapi`, `server/router`, `server/grpcapi`, `server/grpcclient`, and API-boundary client work.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

croessner/nauthilus62026년 10월 12일 업데이트

Use for Nauthilus authentication and identity-provider work touching OIDC, OAuth2, SAML, MFA, TOTP, WebAuthn, recovery codes, LDAP-backed identity, browser login and consent flows, token/session/flow state, `private_key_jwt`, introspection, discovery metadata, endpoint-specific client authentication, and security-sensitive auth tests.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

croessner/nauthilus62026년 10월 12일 업데이트

Use for Nauthilus configuration loading, config schema and defaults, Viper-backed config formats, config dump behavior, vim syntax generation, template validation, prompt guideline sync, documentation under README/IDP/server docs, config converters, and generated documentation or syntax artifacts.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

croessner/nauthilus62026년 10월 12일 업데이트

Use for Nauthilus Lua plugins, Lua callback tests, policy compiler and registry work, Lua environment and subject sources, Lua actions, hooks, backend scripts, policy facts, obligation targets, `server/lualib`, `server/lua-plugins.d`, `server/policy`, and JSON fixtures under `testdata/lua`.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

croessner/nauthilus62026년 10월 12일 업데이트

Use for Nauthilus Redis client, Redis Cluster/Sentinel/topology behavior, Redis-backed token/session/flow/cache/bruteforce state, Lua Redis scripts, `NOSCRIPT` recovery, script upload/retry behavior, redismock tests, local cache coordination, and fail-closed runtime state changes.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

croessner/nauthilus62026년 10월 12일 업데이트

Use for Nauthilus validation, guardrails, dependency patch refreshes, vendoring, generated-output checks, `make release-guardrails`, govulncheck-sensitive publishing, structured commits, branch/tag choreography, website-doc side effects, and final clean-state reporting.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

croessner/nauthilus62026년 10월 12일 업데이트

croessner의 스킬 모두 보기

이 스킬의 문제 신고