Pengbo Space 技能

何时使用

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

何时不使用

• - 需要取消订单时（上游不支持取消）。
• 需要批量补单创建/批量补单状态时（上游不支持批量补单）。

触发策略（仅修改触发逻辑，不修改功能）

• - 优先识别业务动作 + 对象句式：

- 例如：查我的订单、给这个链接下单、查余额、补单 12345。

• - 当用户语句包含平台词 + 增长词时，默认映射到此技能：

- 平台词：Twitter/X、Instagram、YouTube、TikTok、Telegram、Facebook - 增长词：粉丝、点赞、评论、浏览量、增长

• - 模糊请求先通过 services --query 进行服务筛选，再建议用户确认 service_id。
• 写操作保持强约束：未明确确认不执行 add/refill。

推荐示例语句（用于提高触发率）

• - 使用 pengbo-space 查我的订单
• 调用 pengbo-space，查询余额
• 用 pengbo-space 搜索 twitter followers 服务
• 使用 pengbo-space 给这个链接下单： 数量 1000
• 调用 pengbo-space，查询订单 12345 状态
• 用 pengbo-space 对订单 12345 发起补单

默认工作流（推荐）

1. 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 技能
为确保您能立即开始使用，请先完成两步：
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 + 域名白名单）。
• 更新能力必须经过签名校验通过后再执行（验签失败立即中止，不允许降级到仅哈希）。
• 命令执行仅允许技能内建白名单子命令（无通用 shell passthrough）。

快速命令

bash

一键引导（推荐首次运行）

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/prereleasescan.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
• 默认执行：releasesecurity.sh + prerelease_scan.sh

参考文档

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