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 (21)
指导在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/src/graphql/adminapi/mutations 目录下创建 .graphql 文件
npx skills add authgear/authgear-server --skill add-portal-admin-api-mutation -g -y
指导在 Portal Admin 中添加 GraphQL 查询的技能。包括读取现有 Schema、创建查询文件、遵循分页和字段规范，并运行类型生成脚本，确保 API 设计与前端需求一致。
需要添加新的 Portal Admin GraphQL 查询
修改或扩展管理后台数据获取接口
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设计专家，支持审查、构思和规范编辑三种模式。遵循规范编写约定，确保文档简洁、无实现细节且职责单一，辅助创建或编辑docs/specs/下的API规范文件。
审查API设计草稿
构思新功能API架构
编写或更新specs目录下的文档
npx skills add authgear/authgear-server --skill api-design -g -y
引导新用户从零搭建 authgear-server 本地开发环境，涵盖 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
用于在authgear-server中更新GraphQL schema或前端类型时，通过make和npm命令自动重新生成schema及类型工件，禁止手动编辑。
修改了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代码审查报告，涵盖目的、API变更、质量、Bug及安全等维度。通过精确界定上游基线确保范围准确，强制二次验证以客观复核发现，提升审查严谨性。
用户要求审查当前分支或PR
询问PR具体改动内容
请求对已有审查结果进行二次确认或查漏补缺
npx skills add authgear/authgear-server --skill review-pr -g -y
指导在 pkg/lib/config 中修改项目配置、功能配置或密钥。强调必须更新对应的 schema、Go 类型及必需的 testdata 测试用例，确保解析和验证逻辑覆盖新行为。
添加新的配置字段
新增顶层配置节
添加新的密钥
修改现有功能配置的合并实现
npx skills add authgear/authgear-server --skill update-configs -g -y
审计并修复 Go 和 Node.js 项目的依赖漏洞。通过 govulncheck 和 npm audit 扫描，自动处理补丁升级，对重大版本变更生成破坏性报告并请求用户确认，最终提交修复。
需要检查项目依赖安全漏洞
需要升级存在漏洞的 Go 或 Node.js 包
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 依赖模块过时后，自动更新指定目录下的关键模块并执行 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前端页面
审查Portal UI代码中的国际化合规性
配置图表库的显示文本
npx skills add authgear/authgear-server --skill update-portal-ui -g -y
用于处理 Go 代码分析中因无害行号移动导致的 vetted positions 漂移。通过比对新旧位置，更新配置文件以消除误报，确保静态分析结果准确。
Go 代码重构导致行号变化
静态分析报告出现非语义性行号漂移
npx skills add authgear/authgear-server --skill update-vettedpositions -g -y
指导编写 authgear-server 的端到端测试。涵盖 E2E 环境搭建、Makefile 命令使用、YAML 驱动测试用例结构定义及运行方法，确保测试流程标准化。
用户要求编写或添加 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 模块及构建文件的工具链版本。通过批量修改配置文件、刷新 Nix 哈希、执行依赖整理和构建验证，确保版本一致性并防止漂移。
需要升级或降级项目中的 Go 语言版本
发现仓库中存在不一致的 Go 版本引用
npx skills add authgear/authgear-server --skill update-go-version -g -y
该 Skill 为废弃别名，用于引导用户使用 add-portal-admin-api-query 处理查询及 add-portal-admin-api-mutation 处理变更操作。
用户尝试使用 portal-admin-api-graphql
npx skills add authgear/authgear-server --skill portal-admin-api-graphql -g -y
