跳转到内容
Aptos 文档

Aptos Agent Skills

Aptos Agent Skills 是一组预构建 AI 技能，为 Claude Code、Cursor 和 GitHub Copilot 等编程助手提供深度 Aptos 开发专业知识。这些技能涵盖 Move 智能合约、TypeScript SDK 和全栈 dApp 脚手架。

GitHub 上的 Aptos Agent Skills 浏览源代码、技能定义和贡献指南

安装

Section titled “安装”

使用 Skills CLI（推荐）

Section titled “使用 Skills CLI（推荐）”
Terminal window
npx skills add aptos-labs/aptos-agent-skills

这会安装技能，以便 AI 编程助手自动使用它们。可以用 -a 指定目标代理：

Terminal window
npx skills add aptos-labs/aptos-agent-skills -a claude-code
npx skills add aptos-labs/aptos-agent-skills -a cursor
npx skills add aptos-labs/aptos-agent-skills -a copilot

按技能选择性安装见上游 INSTALL.md。

Claude Code 插件

Section titled “Claude Code 插件”

在 Claude Code 会话中，将该仓库添加为插件市场：

/plugin marketplace add aptos-labs/aptos-agent-skills

手动安装

Section titled “手动安装”

克隆仓库，并将技能复制到代理的 skills 目录：

Terminal window
git clone https://github.com/aptos-labs/aptos-agent-skills.git
cp -r aptos-agent-skills/skills/* ~/.claude/skills/
cp -r aptos-agent-skills/patterns/* ~/.claude/patterns/

把克隆仓库中的 CLAUDE.md 加入工作区上下文，以便助手路由到正确的技能。

可用技能

Section titled “可用技能”

Move 技能

Section titled “Move 技能”

这些技能帮助 AI 助手编写、测试、审计和部署 Move 智能合约：

技能描述
write-contracts生成安全的 Aptos Move V2 智能合约
generate-tests生成面向 100% 代码覆盖率的 Move 单元测试
security-audit在部署前对 Move 智能合约进行安全审计
deploy-contracts将 Move 模块部署到 Aptos devnet、testnet 或 mainnet
search-aptos-examples在 aptos-core 中搜索参考实现与模式
analyze-gas-optimization分析并降低 Move 智能合约的 gas 成本
modernize-move将 Move V1 资源账户迁移到 V2 object 模型

TypeScript SDK 技能

Section titled “TypeScript SDK 技能”

这些技能帮助 AI 助手正确使用 Aptos TypeScript SDK：

技能描述
use-ts-sdkAptos TypeScript SDK 前端集成编排器
ts-sdk-client使用 AptosConfig 配置 Aptos 客户端并选择网络
ts-sdk-account从私钥或派生路径创建 Aptos 账户和签名器
ts-sdk-address解析和派生 Aptos 账户地址（AIP-40）
ts-sdk-transactions构建、签名并提交交易，包括赞助交易和多代理交易
ts-sdk-view-and-query调用 Move view 函数并查询链上 Aptos 数据
ts-sdk-types将 Move 类型映射到 TypeScript（u64、u128、address、vector）
ts-sdk-wallet-adapter使用 useWallet 在 React 应用中集成 Aptos 钱包

项目技能

Section titled “项目技能”
技能描述
create-aptos-project使用 create-aptos-dapp 搭建新的 Aptos dApp

推荐工作流

Section titled “推荐工作流”

对于典型的 Aptos dApp，建议按以下顺序使用技能：

  1. 搭建项目 — 使用 create-aptos-project 设置项目结构
  2. 编写合约 — 使用 write-contracts 创建 Move 智能合约
  3. 测试 — 使用 generate-tests 创建全面的测试覆盖
  4. 审计 — 使用 security-audit 检查漏洞
  5. 部署 — 使用 deploy-contracts 发布到 devnet 或 testnet
  6. 前端 — 使用 use-ts-sdk 和其他 TypeScript SDK 技能构建 UI

社区技能

Section titled “社区技能”

仓库包含一个 community-skills/ 目录。社区技能由贡献者独立维护，未经 Aptos Labs 审核。

技能作者描述
smoothsend-gaslessivedmohan使用 SmoothSend 为 Aptos 交易赞助 gas 费

要添加你自己的技能：

  1. 按现有格式在 community-skills/ 下创建新技能
  2. 向 aptos-agent-skills 仓库 提交 pull request

详细贡献流程见 CONTRIBUTING.md。