Agent Skills
› authgear/authgear-server
authgear/authgear-server
GitHub指导在Go仓库中编写或扩展单元测试。强调先检查现有测试风格（Convey或标准testing.T）并保持一致，随后添加最小化测试用例并执行验证。
Install All Skills
npx skills add authgear/authgear-server --all -g -y
Skills in Collection (20)
指导在Go仓库中编写或扩展单元测试。强调先检查现有测试风格（Convey或标准testing.T）并保持一致，随后添加最小化测试用例并执行验证。
用户要求添加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
指导在Portal前端添加新屏幕或组件，包括查找参考模式、规范文件目录结构及命名约定。
创建新的Portal页面
新增UI组件
npx skills add authgear/authgear-server --skill add-portal-screen -g -y
Authgear API设计专家，支持审查现有草案或从零构思新API。通过并行加载规范与代码上下文，依据检查表评估设计合规性并生成修复方案，适用于配置、HTTP及GraphQL接口的标准化设计。
审查API设计草案
构思新功能API
npx skills add authgear/authgear-server --skill api-design -g -y
指导新用户从零开始搭建authgear-server本地开发环境，包括安装工具链、系统依赖及构建前置条件。
首次设置本地开发环境
新贡献者入职配置
全新机器初始化
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 export-schemas和npm run gentype重新生成文件，禁止手动编辑。
修改了GraphQL schema源文件
需要更新生成的前端TypeScript类型
npx skills add authgear/authgear-server --skill generate-schemas-and-gentype -g -y
用于从零开始构建 Site Admin API 功能的完整流水线，涵盖 OpenAPI 规范设计、模型生成到 Handler 代码实现，确保符合项目约定并支持 CORS 和参数校验。
添加新的 Site Admin API 端点
为现有存根填充真实数据
npx skills add authgear/authgear-server --skill new-siteadmin-api -g -y
用于对当前分支的PR进行结构化代码审查，涵盖目的、API变更、质量、安全及性能分析。包含范围界定、初始报告生成及强制二次验证阶段，确保审查结果客观准确。
用户询问PR做了什么
要求审查分支或PR
要求确认或双重检查审查发现
npx skills add authgear/authgear-server --skill review-pr -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 实现必须采用字段级合并，禁止整节替换，以防部分覆盖导致数据丢失，并规定了对应的测试用例要求。
新增功能配置字段
添加新的顶层配置区块
修改现有配置的 Merge 逻辑
npx skills add authgear/authgear-server --skill update-feature-config -g -y
用于在检测到Go模块过时后，更新指定目录下的依赖并执行清理操作。
make ensure-important-modules-up-to-date 报告模块过时
需要刷新仓库重要Go模块
npx skills add authgear/authgear-server --skill update-important-modules -g -y
提供Portal React前端页面更新与设计指南，规范组件使用、链接渲染规则及国际化模式，避免常见陷阱。
需要添加或编辑Portal前端UI页面
审查Portal前端代码中的链接和文本翻译合规性
npx skills add authgear/authgear-server --skill update-portal-ui -g -y
用于处理 Go 静态分析中因代码移动导致的行号漂移。自动更新 vetted positions 文件以反映非语义变更，避免误报新警告。
Go 代码重构导致行号变化
goanalysis 报告行号漂移
npx skills add authgear/authgear-server --skill update-vettedpositions -g -y
指导为 authgear-server 编写 YAML 驱动的端到端测试，涵盖环境搭建、测试运行及故障排查流程。
用户要求编写或添加 e2e 测试
涉及 E2E 测试环境的配置与启动
npx skills add authgear/authgear-server --skill write-e2e-test -g -y
用于将需求规格或旧计划转化为具体的工程实施计划，明确文件、方法、调用流程及测试覆盖。
生成详细实现计划
更新现有实施计划
npx skills add authgear/authgear-server --skill write-implementation-plan -g -y
用于在仓库中统一更新 Go 工具链版本，涉及多个模块和 Dockerfile 的同步修改及构建验证。
需要升级或降级项目中的 Go 语言版本
发现项目中不同模块的 Go 版本不一致需要统一
npx skills add authgear/authgear-server --skill update-go-version -g -y
已废弃的 GraphQL API 别名，用于门户管理后台。建议改用 add-portal-admin-api-query 处理查询，add-portal-admin-api-mutation 处理变更操作。
用户尝试使用 portal-admin-api-graphql 别名
npx skills add authgear/authgear-server --skill portal-admin-api-graphql -g -y
