# Adobe AI编码技能库

`Adobe` `AEM` `AI编码助手` `技能插件` `Edge Delivery`

# Adobe AI 编码代理技能库

面向 AI 编码代理的 Adobe 技能仓库。

## 安装

### Claude Code 插件

```bash
# 添加 Adobe Skills 市场
/plugin marketplace add adobe/skills

# 安装 AEM Edge Delivery Services 插件（共 17 个技能）
/plugin install aem-edge-delivery-services@adobe-skills

# 安装 AEM 项目管理插件（共 6 个技能）
/plugin install aem-project-management@adobe-skills
```

### Vercel Skills（npx skills）

```bash
# 安装所有 AEM Edge Delivery Services 技能
npx skills add https://github.com/adobe/skills/tree/main/skills/aem/edge-delivery-services --all

# 安装指定技能
npx skills add adobe/skills -s content-driven-development
npx skills add adobe/skills -s content-driven-development building-blocks testing-blocks

# 安装所有 Adobe 技能（全产品）
npx skills add adobe/skills --all

# 列出可用技能
npx skills add adobe/skills --list
```

### upskill（GitHub CLI 扩展）

```bash
gh extension install trieloff/gh-upskill

# 从本仓库安装所有技能
gh upskill adobe/skills --all

# 仅安装 AEM Edge Delivery Services 技能
gh upskill adobe/skills --path skills/aem/edge-delivery-services --all

# 安装指定技能
gh upskill adobe/skills --path skills/aem/edge-delivery-services --skill content-driven-development

# 列出子目录中的可用技能
gh upskill adobe/skills --path skills/aem/edge-delivery-services --list
```

## 可用技能

### AEM Edge Delivery Services

#### 核心开发

| 技能 | 描述 |
|------|------|
| `content-driven-development` | 编排所有代码变更的内容驱动开发（CDD）工作流 |
| `analyze-and-plan` | 分析需求并定义验收标准 |
| `building-blocks` | 实现区块及核心功能 |
| `testing-blocks` | 浏览器测试与验证 |
| `content-modeling` | 设计对作者友好的内容模型 |
| `code-review` | 自审及 PR 审查 |

#### 发现

| 技能 | 描述 |
|------|------|
| `block-inventory` | 盘点项目及区块集合中的可用区块 |
| `block-collection-and-party` | 搜索参考实现 |
| `docs-search` | 搜索 aem.live 文档 |
| `find-test-content` | 查找现有测试内容 |

#### 迁移

| 技能 | 描述 |
|------|------|
| `page-import` | 导入网页（编排器） |
| `scrape-webpage` | 抓取并分析网页内容 |
| `identify-page-structure` | 分析页面区块结构 |
| `page-decomposition` | 分析内容序列 |
| `authoring-analysis` | 确定创作方式 |
| `generate-import-html` | 生成结构化 HTML |
| `preview-import` | 预览导入内容 |

### AEM 项目管理

用于 AEM Edge Delivery Services 的项目全生命周期管理，包括交接文档、PDF 生成及身份验证。

> **要求：** 本插件专为 AEM Edge Delivery Services 项目设计，通过检查 `scripts/aem.js` 来验证项目类型。非 Edge Delivery 项目将提前退出——请改用标准文档方式。

**快速开始：**
```bash
cd your-edge-delivery-project   # 或项目内任意子目录
# 说：「为本项目创建交接文档」
```

**配置：** 系统将提示您输入 Config Service 组织名称（即 `https://main--site--{org}.aem.page` 中的 `{org}`）。浏览器窗口将打开用于身份验证——登录后**关闭浏览器窗口**以继续。

**权限：** 需要对项目组织的管理员访问权限。插件将查询 Config Service API 以获取项目配置、站点设置及访问控制信息，用于生成完整文档。

**输出：** 专业 PDF 文件生成至 `project-guides/` 目录：
- `project-guides/AUTHOR-GUIDE.pdf` - 面向内容作者
- `project-guides/DEVELOPER-GUIDE.pdf` - 面向开发者
- `project-guides/ADMIN-GUIDE.pdf` - 面向管理员

| 技能 | 描述 |
|------|------|
| `handover` | 编排项目文档生成流程 |
| `authoring` | 为内容作者生成完整创作指南 |
| `development` | 为开发者生成技术文档 |
| `admin` | 为站点管理员生成管理员指南 |
| `whitepaper` | 将 Markdown 转换为专业 PDF 白皮书 |
| `auth` | 与 AEM Config Service API 进行身份验证 |

## 仓库结构

```
skills/
└── aem/
    ├── edge-delivery-services/
    │   ├── .claude-plugin/
    │   │   └── plugin.json
    │   └── skills/
    │       ├── content-driven-development/
    │       ├── building-blocks/
    │       └── ...
    └── project-management/
        ├── .claude-plugin/
        │   └── plugin.json
        ├── fonts/
        ├── hooks/
        │   └── pdf-lifecycle.js
        ├── templates/
        │   └── whitepaper.typ
        └── skills/
            ├── handover/
            ├── authoring/
            ├── development/
            ├── admin/
            ├── whitepaper/
            └── auth/
```

## 贡献

请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解添加或更新技能的指南。如有问题和讨论，欢迎加入 Adobe Slack 的 [#agentskills](https://adobe.enterprise.slack.com/archives/C0APTKDNPEY) 频道。

## 相关资源

- [agentskills.io 规范](https://agentskills.io)
- [Claude Code 插件](https://code.claude.com/docs/en/discover-plugins)
- [Vercel Skills](https://github.com/vercel-labs/skills)
- [upskill GitHub 扩展](https://github.com/trieloff/gh-upskill)
- [#agentskills Slack 频道](https://adobe.enterprise.slack.com/archives/C0APTKDNPEY)

## 许可证

Apache 2.0 - 详情请参阅 [LICENSE](LICENSE)。