145 lines
4.4 KiB
Markdown
145 lines
4.4 KiB
Markdown
|
# AI Agent 技能集合
|
|||
|
|
|
|||
|
|
`AI Agent` `技能插件` `开发规范` `SEO` `移动端` `Web开发` `Cloudflare` `Vercel`
|
|||
|
|
|
|||
|
|
# Adynato 技能集
|
|||
|
|
|
|||
|
|
为 Adynato 项目准备的 AI Agent 技能集合，遵循 [Agent Skills](https://agentskills.io/) 规范。
|
|||
|
|
|
|||
|
|
## 安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 安装所有技能
|
|||
|
|
npx add-skill adynato/skills
|
|||
|
|
|
|||
|
|
# 安装特定技能
|
|||
|
|
npx add-skill adynato/skills --skill adynato-seo --skill adynato-web
|
|||
|
|
|
|||
|
|
# 全局安装（在所有项目中可用）
|
|||
|
|
npx add-skill adynato/skills -g
|
|||
|
|
|
|||
|
|
# 安装到指定 Agent
|
|||
|
|
npx add-skill adynato/skills -a claude-code -a cursor
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 可用技能
|
|||
|
|
|
|||
|
|
| 技能 | 描述 |
|
|||
|
|
|------|------|
|
|||
|
|
| **adynato-seo** | SEO 要求，包括 LD+JSON schema.org、反向链接、延伸阅读章节、meta 标签和 Open Graph |
|
|||
|
|
| **adynato-web** | Web 开发规范、使用 img4web 进行图片优化、组件模式与样式 |
|
|||
|
|
| **adynato-mobile** | 基于 React Native 和 Expo 的移动应用开发——导航、原生 API、性能优化 |
|
|||
|
|
| **adynato-web-api** | Next.js Web API 模式——路由处理、参数校验、鉴权、错误处理 |
|
|||
|
|
| **adynato-mobile-api** | 移动端 API 集成——TanStack Query、鉴权流程、离线支持 |
|
|||
|
|
| **adynato-github** | 使用 gh CLI 的 GitHub 工作流——详尽的 PR 描述、大型交付物的堆叠 PR |
|
|||
|
|
| **adynato-vercel** | Vercel 部署与配置——环境变量、vercel.json、常见错误、CI/CD 配置 |
|
|||
|
|
| **adynato-cloudflare** | Cloudflare Workers/Pages 部署——wrangler CLI、日志查看、KV/D1/R2、调试 |
|
|||
|
|
| **adynato-aimake** | AI 驱动的交付流水线——MCP 集成、卡片 AI、敏捷看板、工具使用 |
|
|||
|
|
|
|||
|
|
## 使用方式
|
|||
|
|
|
|||
|
|
技能会在 AI Agent 检测到相关任务时自动激活，无需显式调用。
|
|||
|
|
|
|||
|
|
**触发短语示例：**
|
|||
|
|
- "在首屏添加一张图片" → 激活 **adynato-web** 技能（img4web 指引）
|
|||
|
|
- "创建一篇博客文章" → 激活 **adynato-seo** 技能（LD+JSON、反向链接、延伸阅读）
|
|||
|
|
- "新建一个 API 端点" → 激活 **adynato-web-api** 技能
|
|||
|
|
- "从 API 获取数据" → 激活 **adynato-mobile-api** 技能
|
|||
|
|
- "在应用中添加新页面" → 激活 **adynato-mobile** 技能
|
|||
|
|
- "为此功能创建 PR" → 激活 **adynato-github** 技能（堆叠 PR、PR 描述）
|
|||
|
|
- "部署到 Vercel" → 激活 **adynato-vercel** 技能（环境变量、错误、CI/CD）
|
|||
|
|
- "调试这个 Cloudflare Worker" → 激活 **adynato-cloudflare** 技能（wrangler tail、日志）
|
|||
|
|
- "通过 MCP 连接到 aimake" → 激活 **adynato-aimake** 技能（MCP 工具、卡片、看板）
|
|||
|
|
|
|||
|
|
## 技能目录结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
skills/
|
|||
|
|
├── adynato-seo/
|
|||
|
|
│ ├── SKILL.md
|
|||
|
|
│ └── references/
|
|||
|
|
│ └── SCHEMAS.md # LD+JSON 模板
|
|||
|
|
├── adynato-web/
|
|||
|
|
│ └── SKILL.md
|
|||
|
|
├── adynato-mobile/
|
|||
|
|
│ └── SKILL.md
|
|||
|
|
├── adynato-web-api/
|
|||
|
|
│ └── SKILL.md
|
|||
|
|
├── adynato-mobile-api/
|
|||
|
|
│ └── SKILL.md
|
|||
|
|
├── adynato-github/
|
|||
|
|
│ └── SKILL.md
|
|||
|
|
├── adynato-vercel/
|
|||
|
|
│ └── SKILL.md
|
|||
|
|
├── adynato-cloudflare/
|
|||
|
|
│ └── SKILL.md
|
|||
|
|
└── adynato-aimake/
|
|||
|
|
└── SKILL.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 推荐第三方技能
|
|||
|
|
|
|||
|
|
我们同时推荐安装以下来自社区的技能：
|
|||
|
|
|
|||
|
|
### Vercel
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npx add-skill vercel-labs/agent-skills
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
| 技能 | 描述 |
|
|||
|
|
|------|------|
|
|||
|
|
| **react-best-practices** | 40+ 条针对 React 和 Next.js 的性能优化规则 |
|
|||
|
|
| **frontend-design** | 100+ 条 UI 代码审查规则，涵盖无障碍访问、性能与用户体验 |
|
|||
|
|
|
|||
|
|
[在 GitHub 上查看](https://github.com/vercel-labs/agent-skills)
|
|||
|
|
|
|||
|
|
### Expo
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npx add-skill expo/skills
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
用于构建、部署和调试 Expo 应用的技能集，针对 Claude 精调，同时兼容任意 AI Agent。
|
|||
|
|
|
|||
|
|
[在 GitHub 上查看](https://github.com/expo/skills)
|
|||
|
|
|
|||
|
|
### Anthropic（官方示例）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npx add-skill anthropics/skills
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
来自 Agent Skills 规范创建者的官方示例技能。
|
|||
|
|
|
|||
|
|
[在 GitHub 上查看](https://github.com/anthropics/skills)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 支持的 Agent
|
|||
|
|
|
|||
|
|
以下 Agent 均可使用本技能集：
|
|||
|
|
|
|||
|
|
- Claude Code
|
|||
|
|
- Cursor
|
|||
|
|
- Codex
|
|||
|
|
- OpenCode
|
|||
|
|
- Windsurf
|
|||
|
|
- Gemini CLI
|
|||
|
|
- GitHub Copilot
|
|||
|
|
- 以及更多……
|
|||
|
|
|
|||
|
|
## 贡献指南
|
|||
|
|
|
|||
|
|
1. 在 `skills/` 目录下创建以 `adynato-` 为前缀的新目录
|
|||
|
|
2. 添加包含必要 frontmatter（`name`、`description`）的 `SKILL.md`
|
|||
|
|
3. 可选添加 `scripts/`、`references/` 或 `assets/` 目录
|
|||
|
|
4. 提交 Pull Request
|
|||
|
|
|
|||
|
|
完整格式说明请参阅 [Agent Skills 规范](https://agentskills.io/specification)。
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
MIT
|