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。