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查询
创建新的adminapi查询文件
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设计草案，确保符合命名、配置及接口约定，并输出修正后的完整设计工件。
用户要求审查特定的API设计草稿
用户描述功能需求并要求设计API
npx skills add authgear/authgear-server --skill api-design -g -y
指导新用户从零搭建本地开发环境，包括安装工具链、系统依赖及构建项目。
首次设置本地开发环境
新贡献者入职配置
全新机器初始化
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 或前端类型时，自动生成并更新后端 schema 和前端 TypeScript 类型文件。确保不手动编辑生成文件，保持代码一致性。
需要更新 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
要求确认或双重检查审查发现
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、处理多语言翻译及提交规范。适用于修改邮件文案、结构或主题行。
需要修改邮件模板的文案内容
需要调整邮件的结构或布局
需要更新邮件的主题行
npx skills add authgear/authgear-server --skill update-email-templates -g -y
规范功能配置合并逻辑，要求多字段Section必须实现字段级合并而非整体替换，防止层级覆盖导致数据丢失。提供Go代码模板及YAML测试用例要求。
新增功能配置字段
添加新的顶层配置区块
修改现有配置的Merge实现
npx skills add authgear/authgear-server --skill update-feature-config -g -y
用于在检测到Go依赖模块过时后，按指定工作流更新受影响模块并执行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开发与审查规范，涵盖组件选择、国际化及常见陷阱，确保界面一致性与可访问性。
修改Portal前端页面代码
审查Portal UI相关PR
添加或更新前端组件
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 的端到端测试。涵盖 e2e 目录环境搭建、Makefile 使用及故障排查，详解 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 模块及构建文件（如 Dockerfile、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-admin-api-graphql 别名
维护已弃用的 GraphQL API 接口
npx skills add authgear/authgear-server --skill portal-admin-api-graphql -g -y
