Agent Skills
› mastra-ai/mastra
mastra-ai/mastra
GitHub用于审查 GitHub 仓库中的开放 Issue，识别并标记属于 @mastra/core 核心包直接缺陷的问题。通过验证代码归属和缺陷性质，仅对确认为核心 bug 的 Issue 添加标签，支持批量处理和干跑模式。
Install All Skills
npx skills add mastra-ai/mastra --all -g -y
Skills in Collection (42)
用于审查 GitHub 仓库中的开放 Issue，识别并标记属于 @mastra/core 核心包直接缺陷的问题。通过验证代码归属和缺陷性质，仅对确认为核心 bug 的 Issue 添加标签，支持批量处理和干跑模式。
需要审计 GitHub Issue 的核心归属
定期清理或同步 @mastra/core 标签
识别报告了现有行为损坏且修复需在 core 包的 Issue
npx skills add mastra-ai/mastra --skill label-core-bugs -g -y
用于编写和调试核心包中错误处理器的集成测试，涵盖模拟API错误、验证重试逻辑及Vitest运行前置条件。
编写错误处理器集成测试
调试AI SDK重试行为
配置MockLanguageModelV2模拟API异常
npx skills add mastra-ai/mastra --skill testing-core-processors -g -y
用于调试中等或复杂Bug，特别是测试无法覆盖真实运行时状态的场景。通过添加无条件JSONL日志、复现问题并分析日志来定位根因，避免盲目修改代码。
测试失败但可能未反映真实Bug
涉及并发、持久化或外部服务的复杂问题
仅凭堆栈跟踪无法确定根因
npx skills add mastra-ai/mastra --skill debugging-difficult-bugs -g -y
用于自动审计Mastra文档变更，依据规范检查代码示例、API覆盖及内容合规性，仅输出报告不修改文档。
需要审查文档变更是否符合规范
验证代码示例或API覆盖情况
npx skills add mastra-ai/mastra --skill docs-audit -g -y
将文档中的图片转换为 Mermaid 图表或编写新图表，遵循样式指南，确保节点布局合理、多模式可读，并清理无用资产。
转换 Excalidraw 或图片为 Mermaid
创建新的文档流程图
修复图表在明暗模式下的渲染问题
npx skills add mastra-ai/mastra --skill docs-diagrams -g -y
用于前端修改时生成 Playwright E2E 测试，强调验证产品行为而非 UI 状态。要求遵循 BDD 结构，通过前置条件分组和单一断言测试功能正确性，需配置 Playwright MCP。
React 组件创建或重构
UI 变更
新特性开发
影响 Studio UI 的 Bug 修复
npx skills add mastra-ai/mastra --skill e2e-tests-studio -g -y
用于审查 GitHub Issue，识别并标记属于 @mastra/core 核心包的直接 Bug。通过验证代码归属和缺陷性质，精准添加标签，辅助维护 issue 分类与核心责任划分。
审计 mastra-ai/mastra 仓库的开放 Issue
识别并标记直接属于 core 的 Bug
定期核对 @mastra/core 的 Issue 标签
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 设计系统构建前端界面，规范组件组合、布局与样式分离原则。禁止手动重写外观，强调复用现有组件和主题变量，确保 UI 一致性。
创建或修改应用 UI 页面
开发前端组件
调整样式或令牌
npx skills add mastra-ai/mastra --skill mastra-frontend -g -y
用于对 Mastra 项目进行本地或部署环境的冒烟测试，覆盖 Studio UI、智能体、工具及工作流等组件。支持 Alpha 和 Stable 版本发布流程，通过渐进式引导执行全面测试清单并追踪进度。
Mastra 项目本地冒烟测试
Alpha/Stable 版本发布后自动化测试
npx skills add mastra-ai/mastra --skill mastra-smoke-test -g -y
为PR生成自包含HTML审查辅助页，梳理变更背景、系统上下文、核心代码逻辑及验证方式，帮助审阅者快速理解复杂改动。
需要解释PR变更内容和影响
创建PR本地HTML审查助手
npx skills add mastra-ai/mastra --skill pr-explainer -g -y
用于将大型复杂PR拆分为多个独立小PR的技能。涵盖快照备份、变更盘点、提取策略选择、安全抽取、独立验证及漂移管理，确保代码可审查性与构建稳定性。
拆分大型或复杂的Pull Request
计划堆叠PR或提取独立变更
混合重构与行为变更的分离
处理Review反馈后的分支漂移
npx skills add mastra-ai/mastra --skill pr-splitter -g -y
交互式规划助手，通过对话引导用户创建结构化的ralph-loop命令。协助定义背景、环境准备、具体任务和测试步骤，确保计划清晰可执行。
需要制定开发计划或任务分解
构建复杂的ralph-loop命令
npx skills add mastra-ai/mastra --skill ralph-plan -g -y
提供React性能优化指南，涵盖消除数据瀑布流、打包体积优化、客户端数据获取及重渲染优化等26条规则。适用于编写、审查或重构React组件时的性能调优与代码规范遵循。
编写新的React组件
实现数据获取逻辑
审查代码以发现性能问题
重构现有React代码
优化打包体积或加载时间
npx skills add mastra-ai/mastra --skill react-best-practices -g -y
该技能用于创建 Mastra 项目并使用 Chrome MCP 服务器对 Studio 进行冒烟测试，涵盖参数校验、项目生成及浏览器自动化验证。
需要验证新创建的 Mastra 项目是否正常工作
对 Mastra Studio 进行跨版本或配置的快速功能检查
npx skills add mastra-ai/mastra --skill smoke-test -g -y
提供 Tailwind CSS v4 的使用指南及与 v3 的差异对比，指导编写、审查或重构 Tailwind 代码，涵盖 CSS-first 配置、v3 到 v4 的语法迁移及版本特性验证。
使用 Tailwind CSS 编写前端样式
审查或重构 Tailwind 类名和配置
处理 Tailwind v3 到 v4 的迁移清理
npx skills add mastra-ai/mastra --skill tailwind-v4 -g -y
提供核心包错误处理器的集成测试指南，涵盖前置构建、MockLanguageModelV2模拟API错误及重试逻辑、流式响应陷阱，以及Happy path等测试结构规范。
编写或调试核心模块的错误处理器测试
需要模拟AI API调用失败以验证重试机制
npx skills add mastra-ai/mastra --skill testing-core-processors -g -y
提供 mastracode TUI 的交互式测试指南，涵盖构建配置、OpenRouter 自定义提供商设置及关键命令使用。
需要测试 mastracode 终端 UI 功能
配置 OpenRouter 作为 LLM 提供商
npx skills add mastra-ai/mastra --skill testing-mastracode-tui -g -y
该技能用于并行调度多个 Mastra Code 实例，同时调试和修复多个 GitHub Issue。作为主管，它创建工作树、监控进度、审查输出并自动创建 PR，提升批量问题处理效率。
需要同时修复多个 GitHub Issue
提供一组 Issue 编号进行批量处理
npx skills add mastra-ai/mastra --skill gh-bulk-issues -g -y
用于生成直接、无保留的 GitHub PR 审查和 Issue 评论。强制所有要求均为必填项，禁止使用可选或后续跟进标记。以发布账户身份撰写，提供精确的代码指针、变更要求和理由，语气直接且基于证据，旨在推动代码质量提升。
需要起草 GitHub PR 审查意见时
需要发布 Issue 评论进行代码诊断时
npx skills add mastra-ai/mastra --skill gh-review -g -y
用于安全安装、配置和运维 Herdr Kit，管理仓库范围、同步管理器记录及工作树生命周期，支持设置快捷键与打开工作区。
安装或配置 Herdr Kit
修改快捷键或启动器设置
在 Herdr 中打开仓库
同步 Review 或 Work Manager 记录
物质化或去物质化管理员工作树
npx skills add mastra-ai/mastra --skill herdr-kit-workflows -g -y
通过 herdr-kit 插件查询权威全局 Review/Work Manager 库存，推荐 PR 工作并执行远程 Review Manager 的显式物化。提供发现接口、能力协商及查询工作流的完整 CLI 操作指南与错误处理规范。
查询代码审查状态或建议
获取已管理的 PR 或工作区信息
执行远程 Review Manager 记录物化
npx skills add mastra-ai/mastra --skill herdr-manager-query -g -y
用于审查 GitHub Issues，识别并标记属于 @mastra/core 核心包的直接 Bug。通过验证代码归属和缺陷性质，仅对符合标准的 Issue 添加标签，支持 dry-run 模式。
审计 mastra-ai/mastra 仓库的开放 Issue
需要为直接的核心 Bug 添加 @mastra/core 标签
定期核对 Issue 标签与核心包归属的一致性
npx skills add mastra-ai/mastra --skill label-core-bugs -g -y
指导维护者从PR或分支发布npm快照，执行预检、确认并发布到npm。
发布npm快照
创建PR快照
构建canary包
npx skills add mastra-ai/mastra --skill pr-snapshot-release -g -y
模拟资深维护者独立调查GitHub Issue或Bug，先构建假设再验证，提供根因分析与修复建议。适用于问题分诊、根因分析及重新调查场景。
需要深入分析GitHub Issue或报告Bug的根因
进行问题分诊（Triage）或重新调查已讨论的问题
npx skills add mastra-ai/mastra --skill understand-issue -g -y
模拟资深维护者视角审查PR，通过建立独立设计模型、验证声明和风险评估，提供简洁且基于证据的审查简报，支持自审或他人复审。
需要代码审查时
自我审查PR时
重新审查已有PR时
npx skills add mastra-ai/mastra --skill understand-pr -g -y
指导用户配置 Factory 部署中的生命周期、策略及集成事件规则。通过修改 MastraFactory 和 Board 定义，实现工作流自动化与 GitHub/Linear 集成控制，替代旧版全局规则配置。
需要自定义 Factory 部署的策略或生命周期行为
配置 GitHub 或 Linear 集成的事件响应规则
调整 Board 的工具结果处理逻辑
npx skills add mastra-ai/mastra --skill configure-factory-rules -g -y
自动将完成的 Factory 工作项关联的 GitHub Issue 标记为完成，移除相关状态标签，并根据 Issue 当前状态添加 pending-close 标签或发布通知评论。
需要更新已完成任务的 GitHub Issue 状态
清理 Issue 上的临时状态标签
npx skills add mastra-ai/mastra --skill factory-complete-issue -g -y
对GitLab合并请求进行重新审查，结合新提交内容与历史评审结果，确保变更符合设计并解决遗留问题。
收到新的MR提交
需要复核之前的代码评审意见
npx skills add mastra-ai/mastra --skill factory-gitlab-rereview -g -y
基于工厂仓库审查GitLab合并请求，验证代码安全与设计一致性，生成证据判决并请求工作项状态流转。
需要审查GitLab合并请求时
执行Factory工作项的代码评审流程时
npx skills add mastra-ai/mastra --skill factory-gitlab-review -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工作项对应的PR，构建上下文后评估代码正确性、测试覆盖及规范一致性，发布评审结论并请求阶段转换。
收到需要审查的Pull Request
触发Factory工作项的自动评审流程
npx skills add mastra-ai/mastra --skill factory-review -g -y
自动化分析GitHub或Linear工单，追溯代码历史与架构，诊断根因并判断问题有效性。根据变更落地领域自动打标（如Agents、Workflows等），最终输出摘要并请求阶段流转，无需人工干预。
需要分析GitHub Issue根因
需要分析Linear工单状态
工单进入Factory流程需自动分类
npx skills add mastra-ai/mastra --skill factory-triage -g -y
处理涉及文件、Shell或Web的开放式任务的默认流程，强调先复述目标、规划步骤、逐步执行并记录结果，最后总结变更与验证情况。
用户提出需要多步执行的开放式任务
任务涉及文件系统操作或命令行执行
需要协调多个动作的综合型工作
npx skills add mastra-ai/mastra --skill general-tasks -g -y
通过网页搜索和浏览器工具回答研究问题，将有用链接和引文保存至工作区笔记文件，确保来源真实不捏造，并输出答案、来源及笔记路径。
用户提出需要联网调研的研究性问题
需要收集特定主题的公开信息并整理
npx skills add mastra-ai/mastra --skill research-tasks -g -y
提供结构化代码审查流程，涵盖关键缺陷、质量评估、风格规范及Lint检查，并定义标准化反馈输出格式，用于指导Pull Request的代码审核工作。
需要审查Pull Request时
进行代码合并前质量检查时
npx skills add mastra-ai/mastra --skill code-standards -g -y
提供性能导向的代码审查技能，涵盖数据库、内存、渲染、API及算法复杂度检查。用于识别代码瓶颈与优化机会，按严重性分级反馈，提升系统运行效率。
请求审查代码的性能问题
寻找代码中的性能瓶颈
获取优化建议
npx skills add mastra-ai/mastra --skill performance-review -g -y
提供安全代码审查清单，涵盖注入、认证授权、密钥管理、输入验证及数据暴露等风险点，辅助识别漏洞并评估严重等级。
进行安全相关的代码审查
检查潜在的安全漏洞
评估代码的认证与授权逻辑
npx skills add mastra-ai/mastra --skill security-review -g -y
对Agent Builder功能分支进行端到端冒烟测试，通过隔离脚手架验证工作区、RBAC、注册表等核心流程，适用于PR或分支QA阶段。
验证agent-builder功能分支
涉及packages/server或playground的PR
npx skills add mastra-ai/mastra --skill builder-smoke-test -g -y
Playground包的核心测试策略，使用Vitest结合MSW和typed fixtures验证真实SDK与React Query交互，优先于E2E测试。
为playground添加或修改hooks、页面组件
涉及数据获取或React Query的测试工作
npx skills add mastra-ai/mastra --skill playground-msw-tests -g -y
用于GitHub Issue的首次接触分流，收集上下文以分类问题、选择处理路径、发布评论并应用最小化标签，完成即止。
需要对单个GitHub Issue进行分类和路由
需要自动化Issue的初步审核与状态更新
npx skills add mastra-ai/mastra --skill triage-issue -g -y
