pengbo-space

# Pengbo Space Skill

## 什么时候用
- 需要在 `pengbo.space/api/v1` 上做服务查询、下单、查单、补单、余额检查。
- 需要 agent 自动化执行海外社交媒体增长相关动作（粉丝/点赞/评论/浏览量等）。
- 用户出现以下意图词时优先触发：`下单`、`查订单`、`订单状态`、`补单`、`余额`、`服务ID`、`粉丝增长`、`点赞`、`评论`、`浏览量`、`twitter followers`、`instagram likes`、`youtube views`。

## 什么时候不要用
- 需要取消订单（上游不支持 cancel）。
- 需要批量补单创建/批量补单状态（上游不支持 bulk refill）。

## 触发策略（仅改触发，不改功能）
- 优先识别“业务动作 + 对象”句式：
  - 例如：`查我的订单`、`给这个链接下单`、`查余额`、`补单 12345`。
- 当用户语句含“平台词 + 增长词”时，默认映射到本 skill：
  - 平台词：Twitter/X、Instagram、YouTube、TikTok、Telegram、Facebook
  - 增长词：粉丝、点赞、评论、浏览量、增长
- 模糊请求先走 `services --query` 做服务筛选，再建议用户确认 service_id。
- 写操作保持强约束：未明确确认不执行 `add/refill`。

## 推荐示例语句（用于提高触发率）
- `使用 pengbo-space 查我的订单`
- `调用 pengbo-space，查询余额`
- `用 pengbo-space 搜索 twitter followers 服务`
- `使用 pengbo-space 给这个链接下单：<url> 数量 1000`
- `调用 pengbo-space，查询订单 12345 状态`
- `用 pengbo-space 对订单 12345 发起补单`

## 默认工作流（推荐）
1. 首次建议执行 `setup`（一键检查 key + health + 下一步命令）。
2. 再执行 `health` 检查 key 与 API 可用性。
3. 用 `services --query --fields --limit` 本地筛选服务。
4. 写操作（`add` / `refill`）必须显式 `--confirm`。
5. 下单后用 `status` / `orders` 跟踪。

## 语言策略（已固化）
- 支持参数：`--lang auto|zh|en|es|mixed`（默认 `auto`）。
- `auto` 会按“会话历史偏好 + 本轮输入文本”自动判断语言。
- 首次欢迎（onboarding）与错误提示会跟随当前语言输出。
- 可传 `--input-text "用户原话"` 提高自动识别准确度。

## 安装后主动推送文案（给最终用户）
> 🎉 欢迎使用 Pengbo Space Skill
>
> 为确保你能立即开始使用，请先完成两步：
>
> 1) 登录账号  
> 官方地址：`https://pengbo.space`
>
> 2) 获取 API Key  
> 获取地址：`https://pengbo.space/user/api/docs`
>
> 限时活动通知：  
> 当前活动...