Agent Skills
› authgear/authgear-server
authgear/authgear-server
GitHub指导在Go仓库中编写或扩展单元测试。强调先检查现有测试风格（Convey BDD或标准testing.T）并严格匹配，避免混用。工作流程包括检查、匹配风格、添加最小测试文件及运行验证，确保代码质量与规范一致。
Install All Skills
npx skills add authgear/authgear-server --all -g -y
Skills in Collection (20)
指导在Go仓库中编写或扩展单元测试。强调先检查现有测试风格（Convey BDD或标准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 前端新增页面或组件的操作规范，涵盖参考现有代码、文件目录结构（含 Screens/Components/CSS Modules）及屏幕解剖结构，确保 UI 开发符合项目模式。
用户要求创建新的门户页面
用户要求添加新的 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
指导在修改GraphQL schema或前端类型时，通过make和npm命令自动重新生成后端schema及前端类型文件，禁止手动编辑。
需要更新GraphQL schema文件
需要重新生成前端TypeScript类型
npx skills add authgear/authgear-server --skill generate-schemas-and-gentype -g -y
用于通过OpenAPI规范到实现计划再到服务代码的完整流水线，为Site Admin API添加新端点或填充存根数据。
需要添加新的Site Admin API端点
为新创建的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
审计并修复 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
规范 FeatureConfig 的合并逻辑，强制要求字段级合并以防止配置覆盖丢失。指导新增或修改配置项时遵循特定 Merge 实现模式，并补充对应的测试用例以验证层级合并的正确性。
添加新的 feature config 字段
新增顶层配置节
修改现有节的 Merge 实现
npx skills add authgear/authgear-server --skill update-feature-config -g -y
用于在依赖检测工具报告过时模块时，更新指定的 Go 模块。通过执行 make 命令、使用 go get 和 tidy 更新受影响目录中的模块，并重复验证直至通过，确保重要依赖保持最新且范围受限。
make ensure-important-modules-up-to-date 报告过时模块
npx skills add authgear/authgear-server --skill update-important-modules -g -y
提供Portal前端React页面的开发、编辑与审查规范，涵盖i18n翻译、链接组件选型及表单配置陷阱，防止UI渲染错误。
修改Portal前端页面代码
审查Portal前端UI变更
添加或编辑前端组件
npx skills add authgear/authgear-server --skill update-portal-ui -g -y
处理 Go 代码分析工具因无害行号移动导致的检测结果漂移，更新 vettedpositions 文件以维持检查状态。
Go 代码重构导致行号变化
goanalysis 报告非语义性位置变更
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
用于将规格说明或设计变更转化为具体的工程实施计划。要求精确指定文件、方法、调用流程、兼容性要求及原子提交步骤，确保计划具备可执行性而非仅停留在设计层面。
需要将 spec 转化为具体实施计划
需要更新过时的实施计划
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
该技能为废弃的别名，用于添加门户管理API的GraphQL查询和变异。现已弃用，建议分别使用add-portal-admin-api-query和add-portal-admin-api-mutation替代。
需要添加门户管理API的GraphQL查询或变异时
npx skills add authgear/authgear-server --skill portal-admin-api-graphql -g -y
