# 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