蒲公英文档中心

蒲公英 Skill

PGYER Agent Skill 集成指南：让 Claude Code、Cursor、Windsurf 等 50+ AI agent 自动完成蒲公英上传、查询和 CI/CD 配置。

Agent Skill 是面向 AI 智能体的能力包，告诉 agent 在什么场景下、按什么流程调用蒲公英能力。PGYER Agent Skill 内置上传决策、短链与二维码回填、CI/CD 样板和故障排查清单，配合开放的 skills CLI 可一键装到 Claude Code、Cursor、Windsurf、Codex、OpenCode、Gemini 等 50+ 个 AI agent。

完整源码与最新版本以 GitHub 仓库为准：PGYER/pgyer-skill。

与 蒲公英 MCP 的分工：MCP 把上传与查询能力作为工具暴露给 AI 客户端；Skill 在此之上提供「何时调用、如何组合、CI/CD 如何接入」的方法论。两者可同时安装，Skill 在检测到 MCP 时会优先调用。

前置要求

安装

推荐方式：使用 skills CLI

# 安装到当前项目（随代码 commit，团队共用）
npx skills add PGYER/pgyer-skill

# 安装到全局（当前用户的所有项目可用）
npx skills add PGYER/pgyer-skill -g

# 指定目标 agent（不指定时会自动检测当前环境）
npx skills add PGYER/pgyer-skill -g -a claude-code
npx skills add PGYER/pgyer-skill -g -a cursor
npx skills add PGYER/pgyer-skill -g -a codex

skills CLI 会把 skill 文件拷贝到对应 agent 的 skills 目录，无需手动修改配置。

备选方式：手动安装

git clone https://github.com/PGYER/pgyer-skill.git
cd pgyer-skill
./install.sh

install.sh 仅适用于 Claude Code，安装路径为 ~/.claude/skills/pgyer/。其他 agent 请使用 skills CLI，或将整个目录复制到该 agent 的 skills 路径。

配置 API Key

任选一种方式：

适合 CI/CD，与 secrets 机制配合：

export PGYER_API_KEY=<您的 key>

适合个人电脑，避免每次 shell 启动重复设置：

mkdir -p ~/.pgyer && chmod 700 ~/.pgyer
echo 'api_key=<您的 key>' > ~/.pgyer/config
chmod 600 ~/.pgyer/config

与 MCP Server 配合使用

Skill 在检测到 pgyer-mcp-server 时会优先通过 MCP 调用，链路更短、错误返回更结构化。常用 agent 的一键配置：

# Claude Code
claude mcp add --transport stdio pgyer \
  --env PGYER_API_KEY=<您的 key> \
  -- npx -y pgyer-mcp-server

# Codex CLI
codex mcp add pgyer --env PGYER_API_KEY=<您的 key> -- npx -y pgyer-mcp-server

更多客户端的 MCP 配置见 蒲公英 MCP。即使未安装 MCP，Skill 也会自动 fallback 到蒲公英官方的 shell 上传脚本。

使用示例

配置完成后，直接用自然语言向 agent 描述任务：

示例提示词

把 build/release/app.apk 上传到蒲公英，安装方式为密码安装，密码 qa2026。

其他典型场景：

  • 查询当前账号下的应用列表，或根据短链查询某个应用的历史版本。
  • 给 Android、iOS、HarmonyOS 项目生成一份发布到蒲公英的 GitHub Actions 或 GitLab CI 工作流。
  • 上传失败时根据返回的错误码定位是签名、文件格式还是配额问题。

Agent 会自动判断走 MCP 还是 shell 脚本，并把短链、二维码、安装密码等关键信息整理回来。

反馈与问题

本页目录

前置要求安装推荐方式：使用 skills CLI备选方式：手动安装配置 API Key与 MCP Server 配合使用使用示例反馈与问题