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
前端需要新增后台管理接口的查询定义
npx skills add authgear/authgear-server --skill add-portal-admin-api-mutation -g -y
指导添加 Portal Admin GraphQL 查询的规范，包括读取 Schema、创建文件、处理分页字段及生成类型。
需要新增 Portal 管理端 GraphQL 查询接口
在 adminapi/query 目录下创建 .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设计专家，支持审查、构思和规范编辑模式。遵循规范写作约定，确保文档简洁、无实现细节且准确，用于生成或审核docs/specs/下的API规格说明。
审查API设计草稿
构思新功能API
编写或更新规范文档
npx skills add authgear/authgear-server --skill api-design -g -y
指导用户从零配置authgear-server本地开发环境，涵盖macOS下的asdf版本管理、Homebrew依赖安装及构建流程，适用于新贡献者入职或首次搭建场景。
首次设置本地开发环境
新用户入职配置
说"set up local dev from scratch"
说"first-time setup"
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文件
需要重新生成前端类型
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进行结构化代码审查，涵盖质量、Bug、安全等维度。通过Git命令精准定位上游基线，生成带ID和严重等级的报告，并执行强制二次验证以确保客观性。
用户询问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 实现必须采用字段级合并而非整节替换，以防止配置覆盖 Bug，并规定相应的测试用例要求。
添加新功能配置字段
新增顶层配置区块
修改现有配置的 Merge 逻辑
npx skills add authgear/authgear-server --skill update-feature-config -g -y
当检测到Go模块过时，通过运行脚本定位并更新受影响模块，执行go get和tidy以同步依赖。
make ensure-important-modules-up-to-date报告模块过时
需要刷新仓库中的关键Go模块
npx skills add authgear/authgear-server --skill update-important-modules -g -y
提供 Portal React 前端页面更新与设计的规范，涵盖组件约定、链接渲染、国际化模式及常见陷阱，确保用户可见文本正确翻译且 ID 可检索。
添加或编辑 portal/src 下的 UI 页面
审查前端代码中的国际化实现
检查图表配置中的文本翻译
npx skills add authgear/authgear-server --skill update-portal-ui -g -y
用于处理 Go 代码分析输出中无害的行号漂移，自动更新 .vettedpositions 文件以消除误报。
Go 静态分析报告行号变化但语义未变
需要维护 vetted positions 文件
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
生成或更新 authgear-server 的具体实施计划，将规范转化为包含精确文件、方法、调用流、兼容性及测试覆盖的原子化开发步骤。
需要将规范或旧计划转化为具体实施计划
需要明确实现细节如文件路径、方法签名和调用流程
npx skills add authgear/authgear-server --skill write-implementation-plan -g -y
用于统一更新仓库中所有 Go 模块及构建文件中的工具链版本，确保一致性并重新生成 Nix 哈希，防止版本漂移。
需要升级或降级项目使用的 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 别名
维护已弃用的门户管理 API 接口
npx skills add authgear/authgear-server --skill portal-admin-api-graphql -g -y
