Agent Skills
› mastra-ai/mastra
mastra-ai/mastra
GitHub自动审查 GitHub 仓库中的开放 Issue，通过代码溯源判断是否为 @mastra/core 的直接 Bug，并精准添加对应标签。用于核心组件缺陷审计与标签清洗，排除非核心或功能需求。
Install All Skills
npx skills add mastra-ai/mastra --all -g -y
Skills in Collection (36)
自动审查 GitHub 仓库中的开放 Issue，通过代码溯源判断是否为 @mastra/core 的直接 Bug，并精准添加对应标签。用于核心组件缺陷审计与标签清洗，排除非核心或功能需求。
需要审计 GitHub Issue 归属权
识别并标记直接属于 core 的 Bug
定期清理和同步 @mastra/core 标签
npx skills add mastra-ai/mastra --skill label-core-bugs -g -y
针对中复杂或难以复现的 Bug，通过添加临时日志记录实际运行时路径，分析 JSONL 日志以定位根因，避免仅依赖测试迭代。
测试无法完全覆盖真实运行时状态
涉及并发、持久化或外部服务的问题
用户可手动复现但测试未捕获
npx skills add mastra-ai/mastra --skill debugging-difficult-bugs -g -y
用于 Mastra 文档的交互式质量审计，包括源码比对、示例/API覆盖验证、风格检查及读者/Agent可完成性评估。
审计文档与源码的一致性
验证文档示例或 API 覆盖度
检查文档风格和确定性 lint
评估文档是否支持读者或 Agent 完成任务
npx skills add mastra-ai/mastra --skill docs-audit -g -y
针对前端修改生成Playwright E2E测试，验证产品行为而非UI状态。遵循BDD结构，确保功能正确性。
React组件创建/修改/重构
UI变更
新特性开发
影响工作室UI的Bug修复
npx skills add mastra-ai/mastra --skill e2e-tests-studio -g -y
审核 mastra-ai/mastra GitHub Issue，识别并标记属于 @mastra/core 的直接 Bug。通过验证代码归属和缺陷性质，确保仅对核心包问题添加标签，排除其他模块或文档类问题。
审计 GitHub Issues 以确认核心所有权
定期整理 @mastra/core 标签
识别直接的核心 Bug
npx skills add mastra-ai/mastra --skill label-core-bugs -g -y
Mastra文档编写规范，涵盖写作、架构、组件及图表标准，用于创建、编辑和审查文档内容。
创建或编辑Mastra文档
审查文档准确性与格式
更新侧边栏或重定向配置
npx skills add mastra-ai/mastra --skill mastra-docs -g -y
指导如何基于 @mastra/playground-ui 设计系统构建前端界面，规范组件复用、布局与样式隔离，明确 Look 与 Layout 边界，禁止随意修改主题令牌。
创建或修改应用 UI 页面和组件
使用 Tailwind 进行布局调整
查询设计系统组件或主题令牌
npx skills add mastra-ai/mastra --skill mastra-frontend -g -y
用于 Mastra 项目的全面冒烟测试，支持本地运行或部署至预发/生产环境。涵盖 Studio UI、智能体、工具、工作流及内存等组件，并针对 Alpha 和稳定版发布流程提供分支化的测试策略与检查清单。
执行 Mastra 项目发布前的冒烟测试
验证本地开发环境的稳定性
检查特定功能变更对系统的影响
npx skills add mastra-ai/mastra --skill mastra-smoke-test -g -y
生成自包含HTML页面，清晰解释PR的变更内容、原因及系统上下文，辅助代码审查。
需要快速理解PR变更
为PR创建可视化审查文档
npx skills add mastra-ai/mastra --skill pr-explainer -g -y
将大型复杂PR拆分为多个独立小PR，支持堆叠或并行结构。通过快照备份、变更分类、精准提取及验证确保可审查性，并管理代码漂移与冲突。
大型PR拆分
堆叠PR规划
混合变更分离
npx skills add mastra-ai/mastra --skill pr-splitter -g -y
交互式规划助手，通过对话引导用户明确目标、背景、任务及测试步骤，生成结构化的ralph-loop命令。
需要制定开发计划
构建ralph命令
梳理任务清单
npx skills add mastra-ai/mastra --skill ralph-plan -g -y
提供React性能优化指南，涵盖消除数据瀑布流、Bundle体积优化及渲染性能等26条规则。适用于编写、审查或重构React组件时的性能提升与代码规范制定。
编写新的React组件
实现数据获取逻辑
审查代码以发现性能问题
重构现有React代码
优化Bundle大小或加载时间
npx skills add mastra-ai/mastra --skill react-best-practices -g -y
使用 create-mastra 创建项目，并通过 Chrome MCP 服务器在 Chrome 浏览器中对 Mastra Studio 进行冒烟测试。
用户请求对新建的 Mastra 项目进行快速功能验证
需要自动化检查 Mastra Studio 在浏览器中的基本可用性
npx skills add mastra-ai/mastra --skill smoke-test -g -y
提供Tailwind CSS v4的使用指南及v3到v4的迁移差异，涵盖CSS优先配置、自定义工具类及版本重命名规范。
编写或审查Tailwind CSS代码
清理v3时代语法
处理@theme块或CSS-first配置
npx skills add mastra-ai/mastra --skill tailwind-v4 -g -y
提供核心错误处理器的集成测试指南，涵盖MockLanguageModelV2模拟API错误、重试行为验证及Vitest运行前置条件。
编写错误处理器测试
调试AI SDK重试逻辑
配置Mock语言模型
npx skills add mastra-ai/mastra --skill testing-core-processors -g -y
提供 mastracode TUI 的交互式测试指南，涵盖构建、OpenRouter 配置、启动及命令使用，辅助验证终端 UI 功能。
需要测试 mastracode 终端界面功能
排查 TUI 渲染或交互问题
配置自定义 LLM 提供商以进行测试
npx skills add mastra-ai/mastra --skill testing-mastracode-tui -g -y
通过并行启动多个Mastra Code无头实例，协同调试和修复多个GitHub Issue。自动创建工作树、监控进度、审查代码并创建PR，提升批量Issue处理效率。
需要同时修复多个GitHub Issue
批量处理代码缺陷
npx skills add mastra-ai/mastra --skill gh-bulk-issues -g -y
管理 Herdr Kit 插件的安装配置、仓库范围同步、工作区打开及 worktree 生命周期操作，提供安全规范的 CLI 交互流程。
安装或配置 Herdr Kit
修改快捷键或启动器设置
在 Herdr 中正确打开仓库
保持关闭的仓库同步
同步 Review 或 Work Manager 记录
执行 materialize/dematerialize 工作树
npx skills add mastra-ai/mastra --skill herdr-kit-workflows -g -y
通过herdr-kit插件查询全局代码审查与工作管理数据，推荐PR任务，并在用户确认后执行远程Review Manager的记录物化。仅读为主，严格遵循权威源与协议版本。
请求代码审查建议
查询已 authored 的 PR 状态
获取工作区或管理器活动/新鲜度数据
确认并物化远程 Review Manager 记录
npx skills add mastra-ai/mastra --skill herdr-manager-query -g -y
审核 mastra-ai/mastra GitHub 开源仓库的未解决 Issue，通过代码溯源验证缺陷是否属于 @mastra/core 核心包。若确认为直接核心 Bug，则添加对应标签以明确归属，排除非核心模块问题，支持干运行模式。
审计 Issue 归属权
识别并标记核心包 Bug
定期清理或核对 Issue 标签
npx skills add mastra-ai/mastra --skill label-core-bugs -g -y
用于协作调查 GitHub Issue 或 Bug，通过追踪代码历史、理解架构及分析评论来诊断根本原因。包含识别问题、相关人员分析及内部总结等阶段，旨在与用户共同确认问题有效性及成因。
用户报告 Bug 或异常行为
提供 GitHub Issue 编号或 URL
分支名包含 Issue 编号需关联调查
npx skills add mastra-ai/mastra --skill understand-issue -g -y
引导维护者逐步理解PR的目标、质量及上下文历史，通过交互式选项辅助审查。支持解析PR元数据、分析贡献者背景及关联Issue，确保在形成观点前充分掌握变更细节，避免盲目评论。
需要深入理解Pull Request上下文时
进行代码审查前需梳理变更历史和作者背景时
npx skills add mastra-ai/mastra --skill understand-pr -g -y
指导在部署代码中配置 Mastra Factory 的 typed 规则及精确叶覆盖。涵盖查找配置、保持公共结构、应用覆盖、版本管理及安全验证，确保策略代码的正确性与安全性。
修改工厂规则配置
添加或更新 Factory 规则测试
npx skills add mastra-ai/mastra --skill configure-factory-rules -g -y
解析GitHub Issue链接或编号，移除特定状态标签，若Issue为打开状态则添加pending-close标签并留言标记完成。
用户请求关闭已完成的工厂工作项对应的GitHub Issue
需要更新Issue状态标签以反映完成状态
npx skills add mastra-ai/mastra --skill factory-complete-issue -g -y
为工厂工作项生成分阶段实施计划并推进至执行阶段。通过验证理解、设计实现方案及编写结构化计划，确保基于代码历史做出决策，最终通过工具调用完成交接。
需要制定代码修改的分阶段实施计划
将工作项从规划状态推进到执行状态
npx skills add mastra-ai/mastra --skill factory-plan -g -y
在PR推送新提交后执行重新审查，对比历史变更与新增缺陷，进行整体评估并给出最终裁决。
PR有新代码推送
需要重新评估之前审查的结论
npx skills add mastra-ai/mastra --skill factory-rereview -g -y
用于审查 Factory 工作项的 Pull Request。先构建上下文，评估代码正确性、测试及规范一致性，识别安全注入风险，发布评审结论并标记完成。
需要审查 Factory 工作项对应的 PR
执行代码评审流程
npx skills add mastra-ai/mastra --skill factory-review -g -y
自动化诊断Factory工单问题，追溯代码历史与架构，定位根因并生成摘要，最终推动工单状态流转。
需要分析GitHub或Linear工单的根因
需要自动化处理工单调查与阶段转换
npx skills add mastra-ai/mastra --skill factory-triage -g -y
处理涉及文件、Shell或Web的开放式任务的默认流程，强调先规划后执行，逐步操作并记录结果，最后总结变更与验证情况。
需要执行多步骤的文件修改任务
涉及Shell命令或网页交互的复杂操作
未明确具体技术栈的通用型开发任务
npx skills add mastra-ai/mastra --skill general-tasks -g -y
用于通过网页搜索和浏览器工具回答研究问题，并将来源和笔记保存至工作区。要求引用真实链接，禁止虚构来源，最终输出答案、来源列表及笔记文件路径。
用户提出需要基于网络信息的研究性问题
需要收集特定主题的网络资料并整理成文档
npx skills add mastra-ai/mastra --skill research-tasks -g -y
提供结构化代码审查流程，涵盖关键缺陷、代码质量、风格规范及Linting检查，输出包含摘要、问题、建议和肯定反馈的PR评审报告。
需要审查Pull Request
评估代码质量和规范性
检查潜在逻辑错误或风格违规
npx skills add mastra-ai/mastra --skill code-standards -g -y
专注于代码性能审查的技能，通过检查数据库、内存、渲染、网络及算法复杂度等维度，识别瓶颈并提供优化建议。
请求进行代码性能审查
分析代码中的性能瓶颈
寻找代码优化机会
npx skills add mastra-ai/mastra --skill performance-review -g -y
提供安全代码审查清单，涵盖注入、认证、密钥等风险点，辅助识别漏洞并评估严重程度。
进行代码安全审计
检查潜在的安全漏洞
npx skills add mastra-ai/mastra --skill security-review -g -y
对 Agent Builder 功能分支进行端到端冒烟测试，覆盖工作区、CRUD、RBAC、注册表等核心流程。适用于验证相关 PR 或特性分支的质量。
验证 agent-builder 特性分支
PR 修改 packages/server 或 playground-ui 中的 builder 路由
涉及 builder EE 代码路径的变更
npx skills add mastra-ai/mastra --skill builder-smoke-test -g -y
为 playground 包提供基于 MSW 和 Vitest 的核心测试策略，通过真实 SDK 驱动并模拟网络层，确保类型安全与契约一致性。
编写或重构 packages/playground 相关测试
涉及 hooks、页面组件或数据获取逻辑的测试
npx skills add mastra-ai/mastra --skill playground-msw-tests -g -y
用于GitHub Issue的首次接触分类与路由。自动收集上下文，依据标签策略进行分类、定级并更新Issue评论，确定后续处理路径，实现Issue的高效分流与管理。
需要对新提交的GitHub Issue进行初步分类和优先级评估
需要将Issue分配给正确的后续处理流程（如调查、审批或关闭）
npx skills add mastra-ai/mastra --skill triage-issue -g -y
