Aptos Agent Skills

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

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

安装

使用 Skills CLI（推荐）

npx skills add aptos-labs/aptos-agent-skills

这会将技能安装到您的项目中，以便 AI 编程助手自动使用它们。

Claude Code 插件

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

手动安装

克隆仓库并将技能复制到项目的 .claude/skills/ 目录中：

git clone https://github.com/aptos-labs/aptos-agent-skills.git
mkdir -p .claude/skills
cp -r aptos-agent-skills/skills/* .claude/skills/

可用技能

Move 技能

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

| 技能 | 描述 | | ---------------------------- | ------------------------------------------- | | write-contracts | 按照 Aptos 最佳实践编写 Move 智能合约 | | generate-tests | 为 Move 模块生成全面的单元测试和集成测试 | | security-audit | 审计 Move 合约中的常见漏洞和安全问题 | | deploy-contracts | 将 Move 模块部署到 Aptos devnet、testnet 或 mainnet | | search-aptos-examples | 搜索官方 Aptos 示例合约以获取参考实现 | | analyze-gas-optimization | 分析和优化 Move 代码的 gas 效率 | | modernize-move | 将 Move 代码升级为使用最新的 Aptos Move 功能 |

TypeScript SDK 技能

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

| 技能 | 描述 | | ------------------------- | ----------------------------- | | use-ts-sdk | 使用 Aptos TypeScript SDK 的通用指导 | | ts-sdk-client | 配置和使用 Aptos 客户端进行网络交互 | | ts-sdk-account | 创建和管理 Aptos 账户和密钥对 | | ts-sdk-address | 处理 Aptos 地址和地址格式 | | ts-sdk-transactions | 构建、模拟、签名和提交交易 | | ts-sdk-view-and-query | 查询链上数据和调用 view 函数 | | ts-sdk-types | 正确使用 SDK 中的 TypeScript 类型 | | ts-sdk-wallet-adapter | 在前端应用中集成钱包连接 |

项目技能

| 技能 | 描述 | | ------------------------ | ------------------------------------------ | | create-aptos-project | 搭建包含 Move 合约、TypeScript SDK 和前端的新 Aptos 项目 |

推荐工作流

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

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

社区技能

仓库包含一个 community-skills/ 目录，任何人都可以贡献额外的技能。要添加您自己的技能：

1. 按照现有格式创建新的技能文件
2. 向 aptos-agent-skills 仓库提交 pull request

详细的贡献流程请参阅 CONTRIBUTING.md。