跳到正文
cccskills
免费在 GitHub 公开

nauthilus-api-contracts

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.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.4 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Nauthilus API Contracts

Expertise Lens

  • Work as a contract-first API and protocol-boundary engineer.
  • Treat OpenAPI specs, generated bindings, gRPC protobufs, route registration, and supported client wrappers as public compatibility surfaces.
  • Optimize for reproducible generation, route-contract truth, explicit authentication, and separation between generated DTOs and protocol-realistic flows.

Sources To Read

  • AGENTS.md
  • POLICY.md
  • server/openapi/client/README.md
  • server/openapi/openapi.yaml
  • server/openapi/idp.yaml
  • server/openapi/oapi-management-bindings.yaml
  • server/router/
  • server/grpcapi/
  • server/grpcclient/

Contract Rules

  • Keep generated code committed and generated through central Makefile/script workflows.
  • Use make generate-openapi-bindings and make generate-openapi-bindings-check.
  • Use make generate-grpc-proto for gRPC bindings.
  • Keep route contract tests aligned with the actual Gin route registration.
  • Keep management API backchannel auth explicit.
  • Keep IdP discovery API public surfaces separate from browser login, MFA, OIDC token exchange, SAML SSO/SLO, CBOR auth, header auth, and NGINX auth_http flows.
  • Do not replace protocol-realistic client/test behavior with generated clients when the generator cannot model the protocol safely.

Implementation Workflow

  1. Identify whether the change is public API, generated client boundary, route registration, or internal handler behavior.
  2. Update specs before generated artifacts when the public contract changes.
  3. Regenerate through Makefile/script targets.
  4. Update route-contract tests for intentional route additions or exclusions.
  5. Keep supported client wrappers explicit in server/openapi/client.

Validation

  • Run make generate-openapi-bindings-check when OpenAPI or generated clients are in scope.
  • Run focused route/OpenAPI/client tests with GOEXPERIMENT=runtimesecret.
  • Run GOEXPERIMENT=runtimesecret make test and git diff --check.
  • Run make guardrails before commit or pull request.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

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 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`.

中文简介正在准备中。当前显示原文说明。

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 的全部技能

报告此技能的问题