# agent-ai-skill

**Repository Path**: feng-chenhao/agent-ai-skill

## Basic Information

- **Project Name**: agent-ai-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agnes AI Skill

用于 Claude Code 的 Agnes AI 图像与视频生成 Skill。

支持文生图、图生图、文生视频、图生视频、多图视频和关键帧动画，并内置提示词智能优化与自动翻译流程。

## 功能特性

- **文生图**：输入文本描述，生成高质量图像
- **图生图**：基于已有图片进行再创作
- **文生视频**：输入文本描述，生成动态视频
- **图生视频**：基于单张图片生成视频
- **多图视频 / 关键帧动画**：基于多张图片生成关键帧动画
- **提示词智能优化**：为每个提示词生成 3 个不同侧重点的优化版本
- **自动翻译**：将中文提示词自动翻译为高质量英文提示词

## 快速开始

### 1. 安装 Skill

将本仓库克隆到 Claude Code 的 skills 目录下：

```bash
# Windows 默认路径示例，请根据你的实际安装路径调整
git clone https://gitee.com/feng-chenhao/agent-ai-skill.git "%USERPROFILE%\.agents\skills\agnes-ai"
```

### 2. 配置 API Key

**本 Skill 需要 Agnes AI API Key 才能正常工作。**

 Agnes AI API Key 获取方式：

1. 访问 [Agnes AI 官网](https://agnes-ai.com) 并注册 / 登录账号。
2. 进入控制台（Console / Dashboard）。
3. 找到 **API Keys** 或 **开发者中心** 页面。
4. 点击 **创建 API Key**，复制生成的密钥。
5. 复制本项目的 `config.example.json` 为 `config.json`，并将密钥填入其中：

   ```bash
   cp config.example.json config.json
   ```

   然后编辑 `config.json`，把占位 key 替换为你的真实 API Key。

配置示例（`config.json`）：

```json
{
  "agnes_api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "llm_provider": {
    "name": "Agnes AI",
    "model": "agnes-2.0-flash",
    "base_url": "https://apihub.agnes-ai.com/v1",
    "api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}
```

> ⚠️ **注意**：
> - 不要把你的真实 API Key 提交到公开仓库。
> - 本仓库只保留 `config.example.json` 作为配置模板，其中 key 为占位符。
> - `config.json` 已被 `.gitignore` 忽略，不会进入版本控制。
> - 如意外泄露 API Key，请立即到 Agnes AI 控制台撤销并重新生成。

## 使用流程

所有生成任务都遵循以下标准流程：

1. **优化提示词**：调用 `optimize_prompt` 生成 3 个优化版本
2. **用户选择**：展示 4 个选项（3 个优化版 + 原始提示词）
3. **补充确认**：询问用户是否需要补充或修改
4. **翻译为英文**：调用 `translate_prompt` 翻译最终提示词
5. **生成图像/视频**：调用 `generate_image` 或 `generate_video`

### 示例命令

```bash
# 优化提示词
node agnes_ai_helper.js optimize_prompt --prompt "钢铁侠在天空中飞行"

# 翻译提示词
node agnes_ai_helper.js translate_prompt --prompt "钢铁侠在天空中飞行"

# 文生图
node agnes_ai_helper.js generate_image --prompt "Iron Man flying in the sky" --size "1024x1024"

# 图生图
node agnes_ai_helper.js generate_image --prompt "Add an Ultraman in the lower left corner" --image "https://example.com/image.png" --size "1024x1024"

# 文生视频
node agnes_ai_helper.js generate_video --prompt "Iron Man flying in the sky" --num-frames 121 --frame-rate 24

# 图生视频
node agnes_ai_helper.js generate_video --prompt "A dynamic video based on this image" --image "https://example.com/image.png" --num-frames 121 --frame-rate 24

# 关键帧动画
node agnes_ai_helper.js generate_video --prompt "Keyframe animation" --image "url1,url2" --mode keyframes --num-frames 121 --frame-rate 24

# 查询视频任务状态
node agnes_ai_helper.js get_video_status --video_id "video_xxx"
```

详细参数说明请查看 [`SKILL.md`](./SKILL.md)。

## 项目结构

```
.
├── SKILL.md              # Skill 完整使用文档（Claude Code 读取）
├── agnes_ai_helper.js    # 核心工具脚本
├── config.example.json   # 配置模板（脱敏，需复制为 config.json 使用）
├── config.json           # 本地配置文件（已从 Git 移除跟踪，按需创建）
├── .gitignore            # 忽略 config.json
├── LICENSE               # MIT 许可证
└── README.md             # 本文件
```

## 许可证

本项目基于 [MIT License](./LICENSE) 开源。

## 相关链接

- Agnes AI 官方文档：https://agnes-ai.com/zh-Hans/docs/overview
- Agnes AI 文档索引：https://wiki.agnes-ai.com/llms.txt