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
在 adminapi/mutations 目录下创建 .graphql 文件
npx skills add authgear/authgear-server --skill add-portal-admin-api-mutation -g -y
指导在 Portal Admin 中添加 GraphQL 查询的标准流程，包括读取 Schema、创建文件、处理分页字段及运行类型生成脚本。
需要添加新的 Portal Admin GraphQL 查询
修改或扩展 Portal Admin API 数据获取逻辑
npx skills add authgear/authgear-server --skill add-portal-admin-api-query -g -y
指导在 Portal 前端新增页面或组件的规范，涵盖文件结构、命名约定及屏幕解剖结构，确保代码一致性。
创建新的 Portal 页面
添加 UI 组件
新建 Tab 界面
npx skills add authgear/authgear-server --skill add-portal-screen -g -y
Authgear API设计专家，支持审查与设计两种模式。审查模式下依据规范清单评估草案并输出修订方案；构思模式下根据需求生成包含配置、GraphQL或HTTP端点的完整设计提案，确保符合命名、约定及代码模式。
用户提供API设计草案请求审查
用户描述功能需求请求设计API
npx skills add authgear/authgear-server --skill api-design -g -y
引导新用户从零配置authgear-server本地开发环境，涵盖macOS下asdf、Homebrew依赖安装及项目构建初始化，适用于首次搭建或新机器部署场景。
首次设置本地开发环境
新用户入职配置
全新机器搭建
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
指导在修改 GraphQL schema 或前端类型时，通过执行 make export-schemas 和 npm run gentype 命令重新生成后端 schema 和前端类型文件，禁止手动编辑生成的代码。
修改了 GraphQL schema 文件
需要更新前端生成的 TypeScript 类型
npx skills add authgear/authgear-server --skill generate-schemas-and-gentype -g -y
用于新增 Site Admin API 功能的完整流水线，涵盖从 OpenAPI 规范设计、模型生成到 Handler 创建与接线的全流程。适用于添加新接口或填充现有存根数据的场景。
需要新增 Site Admin API 端点
为现有的 API 存根填充真实实现数据
npx skills add authgear/authgear-server --skill new-siteadmin-api -g -y
针对PR分支生成结构化代码审查报告，涵盖目的、API变更、质量、Bug、安全及性能。包含范围界定与强制二次验证阶段，确保客观检查，适用于用户请求审查或确认PR内容时。
询问PR做了什么
要求审查分支/PR
要求确认或双重检查审查发现
npx skills add authgear/authgear-server --skill review-pr -g -y
审计并修复 Go 和 Node.js 项目的依赖漏洞。自动运行安全检测工具，处理版本升级，对重大变更生成报告并请求确认，最后提交修复结果。
项目依赖存在安全漏洞
需要批量更新第三方包版本
npx skills add authgear/authgear-server --skill update-deps -g -y
指导如何更新Authgear邮件模板，包括编辑源文件、生成MJML及多语言翻译，并严格规定分步提交规范。
修改邮件文案或结构
更新邮件主题行
调整邮件模板内容
npx skills add authgear/authgear-server --skill update-email-templates -g -y
指导在 pkg/lib/config 中添加或修改 feature config 字段，强制实现 field-level merge 防止配置覆盖，并提供测试用例规范。
添加新的 feature config 字段
新增顶层配置区块
修改现有配置的 Merge 逻辑
npx skills add authgear/authgear-server --skill update-feature-config -g -y
用于更新仓库中重要的 Go 模块，解决依赖过时问题。通过运行检查命令定位陈旧模块，并在指定目录执行 go get 和 go mod tidy 进行更新，确保依赖状态一致且仅更新相关模块。
make ensure-important-modules-up-to-date 报告模块过时
需要刷新 Go 依赖版本
npx skills add authgear/authgear-server --skill update-important-modules -g -y
指导 Portal React 前端 UI 的更新与设计，重点规范国际化文本处理、静态消息 ID 使用及组件约定，防止翻译遗漏和死键残留。
修改 portal/src 下的 UI 组件
添加或编辑前端页面文本
审查前端国际化代码
npx skills add authgear/authgear-server --skill update-portal-ui -g -y
处理goanalysis输出中行号漂移导致的vetted positions更新。自动识别无害的行号移动，更新配置文件并重新运行分析，确保文件排序正确，不添加新警告项。
goanalysis报告行号变化
需要更新vettedpositions以反映代码位置移动
npx skills add authgear/authgear-server --skill update-vettedpositions -g -y
指导编写 authgear-server 的端到端测试，涵盖基于 YAML 的测试用例结构、环境搭建及运行流程。
用户请求编写或创建 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 工具链版本，涉及修改多个 go.mod、Dockerfile 及 Nix 配置文件，确保版本一致性并重新构建验证。
需要升级或降级 Go 语言版本
同步多模块项目的 Go 版本
npx skills add authgear/authgear-server --skill update-go-version -g -y
已废弃的别名，指向添加门户管理API查询和变异的旧技能。建议直接使用add-portal-admin-api-query和add-portal-admin-api-mutation替代。
使用已弃用的别名添加API
维护遗留代码中的旧技能引用
npx skills add authgear/authgear-server --skill portal-admin-api-graphql -g -y
