Agent Skill

Picva Skill 安装与使用指南

把 Picva 的提示词、模板、推荐和发布流程交给 Codex agent 使用。Skill 源码随 Picva 仓库管理，安装后可用 $picva 直接触发。

安装

在 Picva 仓库根目录运行安装脚本，把 repo 里的 skill 同步到本机 Codex skill 目录。

scripts/install-picva-skill.sh

验证

test -f ${CODEX_HOME:-$HOME/.codex}/skills/picva/SKILL.md && echo "Picva skill installed"

Picva CLI

CLI 可通过 npm 安装，支持搜索目录、打开 Web 登录、复用提示词或模板生成图片，并在服务端扣除登录账号积分。

npm install -g picvapicva search "小红书护肤品海报" --type both --locale zhpicva loginpicva use template <slug> --generate image --input subject=护肤精华 --quality mediumpicva skill pack --skill-dir /path/to/picva/skills/picva

SkillHub 打包

当前仓库未接入 SkillHub API。可先用 CLI 本地打包 skills/picva；实时发布需要后续配置 SKILLHUB_API_URL 和令牌。

1. 打开仓库

进入包含 skills/picva 和 scripts/install-picva-skill.sh 的 Picva 仓库。

2. 安装到 Codex

运行脚本后，本机副本会写入 ${CODEX_HOME:-$HOME/.codex}/skills/picva。

3. 调用技能

在 Codex 中使用 $picva，让 agent 搜索、推荐、复用或发布 Picva 平台资产。

搜索 Picva 目录: 优先读取公开 prompts/templates catalog API。

推荐已有资产: 按标题、描述、分类、标签和 prompt 文本匹配。

登录生成扣分: 通过 Web 登录获取用户态，生成时在服务端扣除积分。