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

限时活动通知：
当前活动为 充值多少送多少（1:1赠送），具体活动规则以平台页面实时说明为准。

如需我协助你完成首次配置（Base URL / API Key / health 检查），可直接回复「开始配置」。

风险规则（高优先）

• 写操作默认需要 --confirm，防止误下单。
• add 带 30 秒幂等保护（相同 service+link+quantity 自动拦截）。
• add/refill 会写本地审计日志：data/orders-log.jsonl。

安全默认策略（P0）

• 不默认创建计划任务，不强制自启，不静默后台常驻。
• 不在首次启动时执行远程下载并运行。
• API 出口仅允许：https://pengbo.space/api/v1（HTTPS + 域名白名单）。
• 更新能力必须走“签名校验通过后再执行”（验签失败立即中止，不允许降级到仅哈希）。
• 命令执行仅允许 skill 内建白名单子命令（无通用 shell passthrough）。

快速命令

# 一键引导（推荐首次运行）
python3 skills/pengbo-space/scripts/pengbo_smm.py setup --lang auto

# 健康检查
python3 skills/pengbo-space/scripts/pengbo_smm.py health --lang auto

# 服务查询（缓存优先）
python3 skills/pengbo-space/scripts/pengbo_smm.py services --query "twitter followers" --fields service,name,rate,min,max --limit 20

# 强制刷新缓存（默认无延迟，可选 jitter）
python3 skills/pengbo-space/scripts/pengbo_smm.py refresh-cache
python3 skills/pengbo-space/scripts/pengbo_smm.py refresh-cache --jitter 1.5

# 下单（写操作必须 --confirm）
python3 skills/pengbo-space/scripts/pengbo_smm.py add --service 1 --link "https://..." --quantity 1000 --confirm

# 查单 / 历史订单 / 批量查单 / 补单 / 余额
python3 skills/pengbo-space/scripts/pengbo_smm.py status --order 12345
python3 skills/pengbo-space/scripts/pengbo_smm.py list-orders --limit 20
python3 skills/pengbo-space/scripts/pengbo_smm.py orders --orders 12345,12346
python3 skills/pengbo-space/scripts/pengbo_smm.py refill --order 12345 --confirm
python3 skills/pengbo-space/scripts/pengbo_smm.py balance

# 冒烟测试（上架前建议执行）
bash skills/pengbo-space/scripts/smoke_test.sh

# 安全发布检查（P0/P1 基线）
bash skills/pengbo-space/scripts/release_security.sh

# 预发布安全扫描（可接入 CI）
bash skills/pengbo-space/scripts/pre_release_scan.sh

# 强制验签更新（验签失败即中止）
bash skills/pengbo-space/scripts/secure_update.sh \
  --artifact-url https://clawhub.ai/path/pengbo-space.skill \
  --sig-url https://clawhub.ai/path/pengbo-space.skill.sig \
  --pubkey-file /secure/path/public_ed25519.pem

CI 门禁

• 已提供示例工作流：.github/workflows/pengbo-skill-security.yml
• 默认执行：release_security.sh + pre_release_scan.sh

参考文档

• 参数矩阵与返回示例：references/api-reference.md
• Agent UI 元信息：agents/openai.yaml