metamask-agent-workflows

MetaMask Agent 工作流

针对 mm CLI 的可重复多步骤模式。当用户请求的是一种模式，而非单条命令时，加载工作流文件。

工作流路由

模式	工作流
首次设置和入门	onboarding.md
登录流程	login.md
故障排查决策树	troubleshooting.md
兑换报价审核执行流程	swap.md
跨链桥报价审核执行流程	bridge.md
开仓永续合约头寸流程	perps-open-position.md
平仓永续合约头寸流程	perps-close-position.md
调整永续合约头寸流程	perps-modify-position.md
Predict 首次设置和凭据	predict-setup.md
从 Predict 钱包存入或提取 pUSD	predict-funding.md
搜索和浏览预测市场	predict-markets.md
获取报价并下达预测订单	predict-place-order.md
查看或取消 Predict 订单和头寸	predict-manage-orders.md
查看 Predict 投资组合并兑领奖励	predict-portfolio.md
代币发现、价格和市场数据	market-data.md
向 Aave V3 供应资产	aave-supply.md
从 Aave V3 提取资产	aave-withdraw.md
从 Aave V3 借款	aave-borrow.md
偿还 Aave V3 债务	aave-repay.md
切换 Aave V3 抵押品	aave-collateral.md
检查 Aave V3 头寸和健康因子	aave-positions.md
发现 Aave V3 代币、利率和流动性	aave-markets.md

除非用户明确要求其他格式，否则始终对命令输出使用 --toon。

预检

在会话中执行首次 CLI 操作前，按顺序运行以下检查。

1. 版本兼容性

此技能针对 @metamask/agentic-cli v4.0.0 编写（参见 frontmatter 中的 cliVersion）。检查已安装的版本：

mm --version

已安装的版本是 @metamask/agentic-cli/ 后面的值（例如 @metamask/agentic-cli/2.0.0 darwin-arm64 node-v22.18.0）。将其 major.minor 与固定的 cliVersion 进行比较。也可以检查最新发布版本（尽力而为；网络故障时静默跳过）：

npm view @metamask/agentic-cli version

如果已安装版本的 major.minor 与固定的 cliVersion 不同，或已安装版本低于最新发布版本，则警告用户一次并继续：

版本不匹配：已安装的 CLI 为 <installed>，此技能固定使用 4.0.0，最新发布版本为 <latest>。在两者版本一致之前，此技能中的命令语法可能不准确。使用 npm install -g @metamask/agentic-cli@latest 更新 CLI，然后使用 npx skills add metaMask/agent-skills 重新安装技能。

每个会话只运行一次此检查。不要因此阻止操作。

2. 就绪检查（身份验证 + 初始化）

mm doctor 是唯一的就绪检查。在会话中执行首次 CLI 操作前，先运行：

mm doctor

它会报告一个 authenticated 布尔值、一个 initialized 布尔值，以及一个 hints 列表。**在 mm doctor 报告 authenticated: true 和 initialized: true 之前，不要运行任何其他命令。**身份验证和初始化是独立的检查项：会话可能已通过身份验证，但项目尚未选择钱包模式；此时，任何需要钱包的命令都会在运行前中止，并返回 NOT_INITIALIZED — “Project not initialized.”（提示：运行 mm init 来设置钱包和交易模式。）。

只有在设置了钱包模式时，项目才算完成初始化；对于 server-wallet，还必须设置交易模式（byok 只需要钱包模式）。不要用 mm init show 进行检查：它要求项目已初始化；对于未初始化的项目，它会抛出 NOT_INITIALIZED，而不是报告状态。

完成修复后，重新运行 mm doctor，并在继续操作前确认结果正常：

• authenticated: false → 按照 workflows/login.md（首次设置则按照 workflows/onboarding.md）运行 mm login。
• authenticated: true 且 initialized: false → 按照 workflows/onboarding.md 运行 mm init 并选择钱包模式（对于 server-wallet，还要选择交易模式）。

命令发现

构造任何命令前，先运行 mm <command> --help，确认准确的标志、语法和默认值。不要凭记忆猜测标志。

输出规则

• 静默路由。不要告知用户你正在加载哪个工作流。
• 原样呈现命令的错误。不要掩盖或改写错误。
• 如果命令失败，请检查 mm <command> --help 并据此提供指导。