Agent Skills
› authgear/authgear-server
authgear/authgear-server
GitHub指导在Go仓库中编写或扩展单元测试。强调先检查现有测试风格（Convey或标准testing.T）并严格保持一致，遵循最小化测试文件原则，运行相关测试验证安全性，优先使用表格驱动测试和So()断言。
Install All Skills
npx skills add authgear/authgear-server --all -g -y
Skills in Collection (21)
指导在Go仓库中编写或扩展单元测试。强调先检查现有测试风格（Convey或标准testing.T）并严格保持一致，遵循最小化测试文件原则，运行相关测试验证安全性，优先使用表格驱动测试和So()断言。
用户请求添加Go单元测试
用户请求更新Go测试用例
npx skills add authgear/authgear-server --skill add-go-test -g -y
指导在 Portal Admin 中添加 GraphQL mutation 的标准流程，包括读取现有 schema、创建文件、遵循命名规范及运行类型生成脚本。
需要添加新的 Portal Admin GraphQL mutation
修改前端 GraphQL 查询结构
npx skills add authgear/authgear-server --skill add-portal-admin-api-mutation -g -y
指导在 Portal Admin 中添加 GraphQL 查询的标准流程，包括读取 schema、创建文件、处理分页及类型生成。
需要添加 Portal Admin GraphQL 查询
前端页面需要特定数据且需服务端过滤
npx skills add authgear/authgear-server --skill add-portal-admin-api-query -g -y
指导在门户前端添加新屏幕或组件，包括定位参考模式、规范文件目录结构及CSS模块命名，以及定义包含数据壳和内部内容的屏幕解剖结构。
创建新的门户页面
添加UI组件
开发新功能屏幕
npx skills add authgear/authgear-server --skill add-portal-screen -g -y
Authgear API设计专家，支持审查、构思和规范编辑三种模式。遵循规范编写约定，确保文档简洁准确，无实现细节，用于设计和审核API及规格说明。
Review mode: User provides a specific design draft (e.g., 'Review this config struct:', 'Here is my proposed GraphQL mutation:'). Evaluate it against the checklist.
Ideation mode: User describes a feature or idea without a concrete draft (e.g., 'Design an API for X', 'How should we add Y?'). Develop a design first, then self-review it.
Spec editing mode: User asks to write or update a document under `docs/specs/` (e.g., 'update the spec', 'document this design').
npx skills add authgear/authgear-server --skill api-design -g -y
指导新用户从零开始配置本地开发环境，包括安装 asdf、Homebrew 依赖及构建工具链。适用于首次设置或新机器初始化场景。
首次设置本地开发环境
新贡献者入职引导
用户说 'set up local dev from scratch'
用户说 'first-time setup'
npx skills add authgear/authgear-server --skill bootstrap-local-dev -g -y
审计并修复 Go 和 Node.js 项目的依赖漏洞。依次检查各模块，自动修补补丁级漏洞，对重大版本升级生成变更报告并等待确认，处理构建失败及不可修复问题，确保项目安全与稳定。
需要审计 Go 或 Node.js 依赖安全漏洞
请求修复项目中的已知依赖风险
npx skills add authgear/authgear-server --skill dep-audit -g -y
指导在authgear-server中更新GraphQL schema及前端类型时，通过make和npm命令自动重新生成文件，禁止手动编辑。
修改了GraphQL schema文件
需要更新前端生成的TypeScript类型
npx skills add authgear/authgear-server --skill generate-schemas-and-gentype -g -y
用于新增或完善 Site Admin API 功能的完整流水线，涵盖从 OpenAPI 规范设计、模型生成到 Handler 代码创建与路由配置的全流程。
需要添加新的 Site Admin API 端点
为现有的存根填充真实业务逻辑
npx skills add authgear/authgear-server --skill new-siteadmin-api -g -y
针对当前分支PR生成结构化代码审查报告，涵盖目的、API变更、质量、Bug、行为、安全及性能。包含范围界定、初稿撰写及强制二次验证阶段，确保发现客观准确。
用户询问PR做了什么
要求审查分支或PR
要求确认或双重检查审查结果
npx skills add authgear/authgear-server --skill review-pr -g -y
指导在pkg/lib/config中添加或修改项目配置、特性配置及密钥字段。涵盖Go类型定义、JSON Schema更新及对应的testdata测试用例补充，确保配置解析与验证逻辑正确。
添加新的配置字段
新增顶层配置区块
增加新的密钥键值
修改现有特性配置的合并实现
npx skills add authgear/authgear-server --skill update-configs -g -y
审计并修复Go和Node.js依赖的安全漏洞。自动运行govulncheck和npm audit，识别漏洞后执行版本升级或生成破坏性变更报告，处理构建验证及不可修复问题通知。
需要扫描项目依赖安全漏洞
需要升级存在漏洞的第三方包
npx skills add authgear/authgear-server --skill update-deps -g -y
规范 Authgear 邮件模板的编辑流程，涵盖源文件修改、MJML 生成、多语言翻译更新及 HTML 构建。确保提交顺序正确，避免直接编辑生成文件，保障模板与翻译的一致性。
需要修改邮件文案或结构
需要更新邮件主题行
涉及邮件模板源文件变更
npx skills add authgear/authgear-server --skill update-email-templates -g -y
指导在 pkg/lib/config 中添加或修改功能配置字段，强调 Merge 实现必须采用字段级合并而非整节替换，以防止配置覆盖 Bug，并规定相应的测试用例要求。
添加新功能配置字段
新增顶层配置区块
修改现有配置的 Merge 逻辑
npx skills add authgear/authgear-server --skill update-feature-config -g -y
用于在检测到 Go 模块过时后，更新仓库中重要依赖模块。通过运行构建命令定位问题，分别在根目录、custombuild 和 e2e 子目录执行 go get 和 go mod tidy，并验证修复结果。
make ensure-important-modules-up-to-date 报告模块过时
需要更新项目依赖以解决漂移
npx skills add authgear/authgear-server --skill update-important-modules -g -y
提供 Portal React 前端页面更新与设计的规范，涵盖组件约定、链接渲染、i18n 模式及常见陷阱。强调所有用户可见文本必须翻译，优先使用静态消息 ID 而非动态拼接，确保可维护性与正确性。
在 portal/src 中添加新 UI 页面
编辑现有前端组件
审查前端代码变更
npx skills add authgear/authgear-server --skill update-portal-ui -g -y
用于处理 Go 代码分析输出中因无害行号移动导致的已验证位置漂移，自动更新 .vettedpositions 文件以维持正确性。
Go 静态分析报告行号漂移
需要维护 vetted positions 文件
npx skills add authgear/authgear-server --skill update-vettedpositions -g -y
指导编写 authgear-server 的端到端测试。涵盖 e2e 目录下的环境搭建、Makefile 命令使用、YAML 驱动测试用例结构及步骤动作规范，确保测试正确运行。
用户要求编写或添加 E2E 测试
用户询问如何设置 E2E 测试环境
用户需要运行特定 E2E 测试用例
npx skills add authgear/authgear-server --skill write-e2e-test -g -y
将规范或旧计划转化为包含精确文件、方法、调用流程、兼容性及测试覆盖的具体实施工程计划。遇到不确定项需主动询问，严禁猜测。
需要为 authgear-server 特性变更起草详细实施计划
需要将现有规范转换为包含原子提交步骤的可执行方案
npx skills add authgear/authgear-server --skill write-implementation-plan -g -y
统一更新仓库中所有Go模块及构建文件的工具链版本，确保一致性并刷新Nix哈希。
需要升级或降级Go语言版本时
维护多模块仓库的Go依赖一致性时
npx skills add authgear/authgear-server --skill update-go-version -g -y
已废弃的别名，用于 Portal 管理 API 的 GraphQL 查询和变更。建议分别使用 add-portal-admin-api-query 和 add-portal-admin-api-mutation。
需要添加 Portal 管理 API 的 GraphQL 查询
需要添加 Portal 管理 API 的 GraphQL 变更
npx skills add authgear/authgear-server --skill portal-admin-api-graphql -g -y
