技能 mastra

📦

mastra

Name: mastra
Author: mastra-ai

v2.0.0 內容修訂 r1 高風險 ⚙️ 外部命令🌐 網路存取🔑 環境變數📁 檔案系統存取

使用最新文件建置 Mastra Agents

Mastra API 變動很快，因此較舊的範例可能會建立出無法運作的 agents 和 workflows。此技能會引導 Claude、Codex 和 Claude Code 在撰寫程式碼前先驗證最新文件。

支援: Claude Codex Code(CC)

⚠️ 38 差

Maintain this Skill? Claim it ⚠️ 38 差

安裝前請停止並請求確認。

請審查安裝計畫，並在變更檔案前取得使用者明確同意。

使用我的智慧代理安裝

將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。

智能體請求

Review the Skillstore skill "mastra" from https://skillstore.io/skills/mastra-ai-mastra.md and its manifest at https://skillstore.io/api/skills/mastra-ai-mastra/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。

Agent 可讀資源

當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。

Markdown 詳情 GET /skills/mastra-ai-mastra.md 已簽名 manifest GET /api/skills/mastra-ai-mastra/manifest 已簽名 lockfile GET /api/skills/mastra-ai-mastra/lockfile

測試它

正在使用「mastra」。幫我為支援 agent 啟動一個 Mastra 專案。

預期結果:

此技能會檢查是否已安裝 Mastra 套件。
它會建議 CLI 或手動設定路徑。
它會將 provider keys 保留為本機佔位符。

正在使用「mastra」。我的 workflow 在第一個步驟後失敗。

預期結果:

此技能會將錯誤與常見 workflow 問題進行比較。
它會從已安裝文件驗證最新 workflow APIs。
它會建議聚焦的修正方式與測試步驟。

正在使用「mastra」。將我的 Mastra 專案升級到最新版本。

預期結果:

此技能會從官方遷移指引開始。
它會檢查已安裝套件文件以取得精確 signatures。
它會產生包含驗證步驟的遷移計畫。

安全審計

高風險

v4 • 2026/7/5 開啟版本化報告

Static findings are almost entirely documentation examples, Markdown formatting, official documentation URLs, localhost references, or placeholder environment variable usage. I found no prompt injection or hidden execution logic, but the setup guide does encourage users to provide an API key to the AI agent, which is a real secret-handling risk.

已掃描檔案

1,416

分析行數

複核項目

已忽略的誤報

已確認的安全問題 (1)

高

references/create-mastra.md:13-15 references/create-mastra.md:107-115

API Key Disclosure Encouraged During Automatic Setup

The setup guide offers an automatic setup option where the user gives the AI agent an API key. This can encourage users to paste real provider credentials into chat instead of storing them locally.

The wording explicitly asks for an API key for automatic setup, and later instructs creating a .env file with provider keys. This is a clear secret-handling risk, although there is no evidence of exfiltration code.

風險因素

⚙️ 外部命令 (35)

🌐 網路存取 (17)

references/common-errors.md:511 references/common-errors.md:373 references/migration-guide.md:51 references/remote-docs.md:56 references/remote-docs.md:62 references/remote-docs.md:79 references/remote-docs.md:96 references/remote-docs.md:97 references/remote-docs.md:105 references/remote-docs.md:154 references/remote-docs.md:164 references/remote-docs.md:171 SKILL.md:8 SKILL.md:40 SKILL.md:66 SKILL.md:149 SKILL.md:159

🔑 環境變數 (18)

📁 檔案系統存取 (1)

references/create-mastra.md:146

審計單位: codex 檢視審計紀錄 →

分享與引用此報告

分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。

開啟版本化報告

複製報告連結

https://skillstore.io/skills/mastra-ai-mastra/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/mastra-ai-mastra/security.svg)](https://skillstore.io/skills/mastra-ai-mastra?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/mastra-ai-mastra?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/mastra-ai-mastra/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/mastra-ai-mastra.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

學術引用 (APA · BibTeX · CFF)

APA 引用

mastra-ai. (2026). mastra security audit report (audit version 4) [Author version 2.0.0]. Skillstore. https://skillstore.io/skills/mastra-ai-mastra/audits/4

BibTeX 引用

@techreport{mastra-ai-mastra-ai-mastra-2026,
  author = {mastra-ai},
  title = {mastra security audit report (audit version 4)},
  institution = {Skillstore},
  year = {2026},
  number = {4},
  url = {https://skillstore.io/skills/mastra-ai-mastra/audits/4},
  note = {Author version 2.0.0}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "mastra security audit report (audit version 4)"
version: "2.0.0"
type: report
authors:
  - name: "mastra-ai"
date-released: "2026-07-05"
url: "https://skillstore.io/skills/mastra-ai-mastra/audits/4"
identifiers:
  - type: other
    value: "skillstore:mastra-ai-mastra:audit:4"
    description: "Skillstore immutable audit report identifier"

Skillstore 評分

評分依據證據置信度: 高

架構

100

可維護性

內容

社群

規範符合度

你可以打造什麼

建立 Mastra 專案

使用正確的相依套件、TypeScript 設定和 provider model 格式設定新的 agent 專案。

修正 framework 錯誤

透過檢查本機文件、最新型別定義和已知疑難排解模式，診斷常見 Mastra 錯誤。

規劃版本升級

比較目前與目標 API、尋找遷移指引，並在變更程式碼前建立驗證檢查清單。

試試這些提示

建立第一個 agent

使用 Mastra skill 幫我建立新的 Mastra 專案。執行命令前先詢問，並使用佔位符表示 secrets。

驗證 API

使用嵌入式 Mastra 文件，在變更我的程式碼前驗證我已安裝版本的 Agent constructor。

疑難排解錯誤

使用常見錯誤參考與最新文件來診斷這個 Mastra 錯誤：[paste error]。說明可能原因與修正方式。

規劃遷移

使用 migration guide、嵌入式文件和遠端文件來規劃 Mastra 版本升級。列出 breaking changes 和驗證步驟。

最佳實務

已安裝 Mastra 套件時，先檢查嵌入式文件。
將 provider keys 保存在本機環境檔案或 secret manager 中。
在除錯 APIs 前，先驗證 TypeScript 設定與套件版本。

避免

不要依賴模型記憶來取得 Mastra API signatures。
不要為了專案設定而將真實 API keys 貼到聊天中。
不要在未檢查版本的情況下，將遠端文件與較舊的已安裝套件混用。

常見問題

這個技能能提供哪些協助？

它幫助 AI 助理使用最新文件建置、除錯和遷移 Mastra TypeScript agent 專案。

為什麼它偏好嵌入式文件？

嵌入式文件會符合已安裝的套件版本，因此能減少過時範例造成的錯誤。

它可以建立完整的 Mastra 專案嗎？

它可以引導專案建立與檔案結構，但命令執行應維持由使用者核准。

它支援 Claude、Codex 和 Claude Code 嗎？

是。技能 metadata 列出 Claude、Codex 和 Claude Code 為支援的工具。

我應該提供真實 API keys 給助理嗎？

不應該。請在產生的檔案中使用佔位符，然後在本機或透過 secret manager 加入真實 keys。

什麼時候應該使用遠端文件？

當本機套件缺失，或需要最新概念性指引時，使用遠端文件。

開發者詳細資訊

作者

mastra-ai

授權

Apache-2.0

作者版本

v2.0.0

Skillstore 修訂

儲存庫

https://github.com/mastra-ai/skills/tree/main/skills/mastra/

引用

62e2a730c5cd74eab4c7164309d810de660fcea3

維護新鮮度

2026/7/18

使用量

7 次下載 · 115 次瀏覽

檔案結構

📁 references/

📄 common-errors.md

📄 create-mastra.md

📄 embedded-docs.md

📄 migration-guide.md

📄 remote-docs.md

📄 SKILL.md