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 (37)
自动审查 GitHub 仓库 Issue，识别并标记属于 @mastra/core 的直接 Bug。通过验证代码归属排除非核心问题，支持批量处理、干运行及标签创建，确保 Issue 分类准确。
需要审计 GitHub Issue 以识别核心 Bug
执行 @mastra/core 标签的定期整理与核对
npx skills add mastra-ai/mastra --skill label-core-bugs -g -y
针对中等或复杂Bug的调试技能，当测试无法复现真实运行时问题时使用。核心方法是添加无条件JSONL日志以追踪实际执行路径，分析日志定位根因后再修复并清理临时代码。
测试通过但无法证明Bug已修复
涉及并发、状态或外部服务的复杂Bug
需要手动复现的UI或运行时问题
准备进行第二次推测性修复前
npx skills add mastra-ai/mastra --skill debugging-difficult-bugs -g -y
用于对 Mastra 文档进行自主审查，依据规范检查变更内容并生成报告。仅输出审计结果，不直接编辑文档或提交修复计划，确保文档合规性与准确性。
需要审计文档变更是否符合规范
验证代码示例或 API 覆盖度
npx skills add mastra-ai/mastra --skill docs-audit -g -y
将文档中的图表图片转换为 Mermaid 代码，或为 Mastra 文档编写新图表。遵循样式指南，通过查找引用、分析节点边、编写代码及双模式验证等步骤，实现文档图表的标准化与可维护性。
转换 Excalidraw 或 PNG/JPG/SVG 图片为 Mermaid
为文档页面创建新图表
修复图表在亮/暗模式下的渲染问题
审计并替换文档中的图片图表
npx skills add mastra-ai/mastra --skill docs-diagrams -g -y
指导为前端修改生成基于行为验证的 Playwright E2E 测试，强调测试产品功能而非 UI 状态，强制使用 BDD 结构。
修改 packages/playground-ui 或 packages/playground 下的文件
创建、修改或重构 React 组件
添加新的 Playground 功能
修复影响 Studio UI 的 Bug
npx skills add mastra-ai/mastra --skill e2e-tests-studio -g -y
审查 GitHub 议题，识别并标记属于 @mastra/core 的直接 Bug。通过代码追溯确认所有权，仅对核心缺陷添加标签，支持批量或指定议题处理及干跑模式。
审计 mastra-ai/mastra 仓库议题
识别直接属于 core 的 Bug
定期 reconciling @mastra/core 议题标签
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页面
开发前端组件
调整样式或Token
npx skills add mastra-ai/mastra --skill mastra-frontend -g -y
用于对 Mastra 项目进行本地或部署环境的冒烟测试，覆盖 Studio UI、Agent、工具及工作流等。支持 Alpha 和 Stable 版本发布流程，通过渐进式指引执行全面测试检查清单，确保发布质量。
Mastra 项目发布前验证
Alpha 或 Stable 版本冒烟测试
检查 Agent 和工具功能是否正常
npx skills add mastra-ai/mastra --skill mastra-smoke-test -g -y
为Pull Request生成自包含的HTML审查辅助页面，通过解释变更内容、背景及验证方式，帮助审阅者快速理解复杂代码改动。
需要生成PR变更摘要
协助代码审查
解释复杂代码改动
npx skills add mastra-ai/mastra --skill pr-explainer -g -y
指导如何将大型或复杂的PR拆分为多个小型、可独立审查的PR。涵盖快照备份、变更分类、安全提取、独立验证及处理合并冲突导致的漂移，确保代码增量交付且易于Review。
将大型复杂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性能优化指南，涵盖组件编写、代码审查与重构。包含消除数据瀑布流、减少包体积、客户端数据获取及重渲染优化等26条规则，旨在提升前端应用性能与质量。
编写新的React组件
实施数据获取逻辑
审查代码以发现性能问题
重构现有React代码
优化包体积或加载时间
npx skills add mastra-ai/mastra --skill react-best-practices -g -y
基于 create-mastra 创建项目，并利用 Chrome MCP 自动化执行 Mastra Studio 的冒烟测试。
需要验证新创建的 Mastra 项目能否正常启动和运行
对 Mastra Studio 进行快速的功能连通性检查
npx skills add mastra-ai/mastra --skill smoke-test -g -y
提供 Tailwind CSS v4 使用指南及 v3 迁移差异，指导编写、审查或重构相关代码，涵盖 CSS-first 配置、新工具类及旧语法清理。
编写 Tailwind CSS 代码
审查前端样式代码
重构 Tailwind 配置或类名
npx skills add mastra-ai/mastra --skill tailwind-v4 -g -y
提供核心错误处理器的集成测试指南，涵盖MockLanguageModelV2模拟API错误、重试行为验证及流式响应构造细节，指导编写Happy path等用例。
编写错误处理器测试
调试AI SDK重试逻辑
配置MockLanguageModelV2
npx skills add mastra-ai/mastra --skill testing-core-processors -g -y
提供 mastracode TUI 的交互式测试指南，涵盖构建配置、OpenRouter 自定义提供商设置及关键命令操作。
需要测试终端 UI 功能
配置 OpenRouter 作为 LLM 提供商
排查 TUI 渲染或线程状态问题
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 的安全配置、仓库范围管理、同步及工作树生命周期操作指南，强调环境验证与权限控制。
安装或配置 Herdr Kit
更改快捷键或启动器设置
在 Herdr 中打开仓库
同步 Review 或 Work Manager 记录
物化/去物化管理的工作树
npx skills add mastra-ai/mastra --skill herdr-kit-workflows -g -y
通过 herdr-kit 插件查询权威的全局代码审查与工作管理数据，支持推荐 PR 任务、查看审查状态及在用户确认后执行远程审查记录的材料化操作。
请求代码审查
查询已提交 PR
获取工作区状态
获取工作推荐
确认材料化审查记录
npx skills add mastra-ai/mastra --skill herdr-manager-query -g -y
自动审查 GitHub Issues，通过代码溯源确认是否属于 @mastra/core 核心缺陷。仅对直接修复需位于 core 包的 Broken Behavior 添加标签，支持全量或指定 Issue 的批量审计与 Dry-run 模式。
需要审计 GitHub Issues 以识别核心组件 Bug
为 Issues 应用或核对 @mastra/core 标签
执行核心包归属权的定期清理与复核
npx skills add mastra-ai/mastra --skill label-core-bugs -g -y
该技能用于协作调查GitHub Issue或Bug，通过追踪代码历史、理解架构来诊断根本原因。支持解析Issue元数据、识别相关人员背景，并分阶段进行深入研究，最终给出验证过的诊断结论，避免猜测。
用户报告GitHub Issue或Bug
需要排查代码缺陷或异常行为
npx skills add mastra-ai/mastra --skill understand-issue -g -y
引导维护者深入理解PR的目标、质量及上下文历史，通过交互式步骤分析作者背景、关联Issue和代码变更，辅助形成准确评审意见。
需要审查Pull Request时
请求理解PR背景和上下文时
npx skills add mastra-ai/mastra --skill understand-pr -g -y
指导用户配置 Mastra Factory 的部署规则，包括查找配置、应用精确覆盖及版本管理。强调安全规范与测试验证，确保策略变更符合类型约束且不影响现有行为。
需要修改 MastraFactory 的规则配置
实现精确叶子节点覆盖逻辑
调整工厂策略的版本控制
npx skills add mastra-ai/mastra --skill configure-factory-rules -g -y
解析GitHub Issue URL或编号，读取当前状态与标签。移除待处理相关标签；若Issue未关闭，则添加pending-close标签并留言标记完成；已关闭则无操作。仅修改指定标签，不改变Issue其他状态。
需要标记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有新提交需要重新审查
Factory工作项触发重审流程
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 工作项，追溯代码历史与架构，诊断根本原因并验证问题有效性。通过假设驱动决策完成调查，生成摘要并请求阶段转换，实现 Issue 分诊自动化。
需要分析 GitHub 或 Linear Issue 的根本原因
执行 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
提供结构化的代码审查流程，涵盖关键缺陷、代码质量、风格规范及Linting检查，输出包含总结、问题、建议和正面反馈的PR评审报告。
用户请求对代码进行审查或评估
提交Pull Request后需要自动或手动代码审核
npx skills add mastra-ai/mastra --skill code-standards -g -y
专注于代码性能审查的 Skill，用于识别 N+1 查询、内存泄漏、冗余渲染及算法复杂度等瓶颈，并提供优化建议。
需要检查代码性能问题
寻找优化机会
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 或分支验证。
验证 agent-builder 功能分支
PR 修改了 packages/server 或 playground 中的 builder 路由
npx skills add mastra-ai/mastra --skill builder-smoke-test -g -y
针对 playground 包的 MSW 测试规范，通过 Vitest 驱动真实 SDK 和 React Query，仅模拟网络层。用于生成类型安全的 fixtures 测试，优于 E2E，确保前后端契约一致性。
为 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
