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
修改 portal 目录下的 graphql 文件
npx skills add authgear/authgear-server --skill add-portal-admin-api-mutation -g -y
指导在Portal Admin中新增GraphQL查询的标准流程，包括读取Schema、创建文件、处理分页及生成类型。
需要添加Portal Admin GraphQL查询
修改或扩展Admin API查询接口
npx skills add authgear/authgear-server --skill add-portal-admin-api-query -g -y
指导在门户前端添加新屏幕或组件的规范，包括定位现有模式、文件结构命名及屏幕解剖结构。
创建新的门户页面
添加新的 UI 组件
npx skills add authgear/authgear-server --skill add-portal-screen -g -y
Authgear API设计专家，支持审查模式与构思模式。审查模式下依据规范清单评估设计草案；构思模式下生成完整API设计方案并自审。通过并行加载上下文、代码及规范文件，确保设计符合命名、配置及接口约定。
用户提供具体的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 创建与路由配置的全流程。
添加新的 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
指导在 authgear.features.yaml 中添加或修改特性配置字段。强调必须实现字段级合并逻辑以防止配置覆盖，并规定需编写测试用例验证多层配置的独立保留。
添加新的特性配置字段
新增顶层配置区块
修改现有区块的 Merge 实现
npx skills add authgear/authgear-server --skill update-feature-config -g -y
用于在检测到Go依赖模块过时后，自动更新指定目录下的关键模块版本并执行tidy，确保依赖一致性。
make ensure-important-modules-up-to-date 报告模块过时
需要刷新仓库中重要的 Go 模块
npx skills add authgear/authgear-server --skill update-important-modules -g -y
提供 Portal React 前端页面更新与设计指南，涵盖组件规范、链接渲染规则及国际化模式。确保用户可见文本正确翻译与格式化，并指导正确使用内部/外部链接组件以避免样式丢失问题。
在 portal/src 中添加或编辑 UI 组件
审查前端代码中的国际化与链接使用
配置图表库的本地化显示
npx skills add authgear/authgear-server --skill update-portal-ui -g -y
用于处理Go代码分析输出中无害的行号漂移，更新vettedpositions文件以消除误报，同时确保不掩盖新警告。
Go静态分析工具报告行号漂移
需要维护vettedpositions文件以同步代码位置变化
npx skills add authgear/authgear-server --skill update-vettedpositions -g -y
指导为 authgear-server 编写 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 工具链版本，确保所有模块和构建文件保持一致。
需要升级项目 Go 版本时
同步多模块 Go 版本以消除漂移时
npx skills add authgear/authgear-server --skill update-go-version -g -y
这是一个已弃用的别名技能，指向 add-portal-admin-api-query 和 add-portal-admin-api-mutation。建议用户直接使用这两个新技能分别处理 GraphQL 查询和变更操作，不再维护此旧版别名。
用户尝试使用 portal-admin-api-graphql 别名
需要管理已弃用的 API 别名
npx skills add authgear/authgear-server --skill portal-admin-api-graphql -g -y
