菜单
踩坑经验库 - 遇到问题时自动查阅 GitHub 上的历史踩坑记录(Capsule)，解决后自动提交新经验回 GitHub Issue。激活条件：(1) 遇到报错/异常/失败时 (2) 配置不生效或行为异常时 (3) 成功解决一个非显而易见的问题后 (4) 用户要求查阅或记录经验时。关键词：踩坑、经验、报错、failed、error、不生效、为什么、pitfall、experience
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
美工全流程 - 从参考店铺到成品设计，自动分析风格并生成同风格电商素材（主图、海报、Banner）。激活条件：(1) 用户需要分析店铺/竞品视觉风格 (2) 用户需要生成电商产品主图 (3) 用户需要制作活动Banner/海报 (4) 用户需要批量生成同风格产品图 (5) 用户需要从参考URL提取设计语言并复用。关键词：美工、设计、主图、海报、Banner、批量生成、风格分析、店铺拆解、电商素材、详情页、小红书、产品图、视觉风格
电商美工助手 - 做详情页、海报、Banner、社媒封面、套模版、AI生图、批量适配。支持淘宝/京东/拼多多/小红书/抖音/公众号全平台尺寸。发送"做详情页"、"做海报"、"做主图"、"做封面"开始。关键词：电商设计、产品图、详情页、海报设计、Banner、美工
Nano Banana2 多模态 AI - 支持文生图、图生图、Vision 分析。发送"生图 柴犬"生成图片，发送图片+描述做风格化重绘。底层调用 Gemini，支持 10 种宽高比。关键词：生图、画图、AI画图、文生图、图生图、generate image、Gemini、重绘
美股/港股盘前分析框架。抓取五大观测指标（VIX/IGV/MAGS/MEME/布油）、 个股实时价格、期权隐含波动率，生成结构化盘前简报。 包含量化模块：粒子滤波概率追踪、期权蒙卡定价、Copula VaR。 支持持仓 JSON 格式管理，实时浮盈亏计算。
店铺视觉风格拆解 - 自动分析电商店铺/竞品的配色方案、排版布局、摄影风格、设计语言。支持淘宝/天猫/京东/拼多多店铺。激活条件：需要竞品分析、风格提取、视觉对标、店铺拆解、配色分析时使用。关键词：竞品、风格分析、配色、视觉DNA、设计语言、store teardown、visual analysis
获取商品在淘宝(Taobao)、天猫(TMall)、京东(JD.com)、拼多多(PinDuoDuo)、抖音(Douyin)、快手(KaiShou)的最优价格、优惠券的技能，商品价格全网对比，当用户想购物或者获取优惠信息时使用。Get the best price, coupons for goods on Chinese e-commerce platforms, compare product prices, and use when users want to shop or get discount information.
| name | pitfall-experience |
| description | 踩坑经验库 - 遇到问题时自动查阅 GitHub 上的历史踩坑记录(Capsule)，解决后自动提交新经验回 GitHub Issue。激活条件：(1) 遇到报错/异常/失败时 (2) 配置不生效或行为异常时 (3) 成功解决一个非显而易见的问题后 (4) 用户要求查阅或记录经验时。关键词：踩坑、经验、报错、failed、error、不生效、为什么、pitfall、experience |
| metadata | {"openclaw":{"version":"1.0.0","userInvocable":true,"emoji":"📝"},"requires":{"bins":["curl","python3"]}} |
遇到问题时查阅 GitHub 上的历史经验，解决问题后将新经验提交回去。
当遭遇错误/异常/配置不生效时，立即执行：
步骤 1 — 获取 Capsule 索引
curl -s https://api.github.com/repos/BENZEMA216/openclaw-pitfalls/contents/capsules | python3 -c "import sys,json; [print(f['name'], f['download_url']) for f in sorted(json.load(sys.stdin), key=lambda x: x['name'])]"
步骤 2 — 读取相关 Capsule
curl -s https://raw.githubusercontent.com/BENZEMA216/openclaw-pitfalls/main/capsules/PIT-XXX.yaml
步骤 3 — 批量搜索关键词
GITHUB_TOKEN=$(cat /root/.openclaw-claw2/credentials/github_token)
curl -s -H "Authorization: token $GITHUB_TOKEN" "https://api.github.com/search/code?q=关键词+repo:BENZEMA216/openclaw-pitfalls+path:capsules"
步骤 4 — 读取 README 索引表
curl -s https://raw.githubusercontent.com/BENZEMA216/openclaw-pitfalls/main/README.md
当成功解决了一个非显而易见的问题后，必须将经验提交回 GitHub。
步骤 1 — 确定新 Capsule 编号
LAST_ID=$(curl -s https://api.github.com/repos/BENZEMA216/openclaw-pitfalls/contents/capsules | python3 -c "import sys,json; files=json.load(sys.stdin); ids=[int(f['name'].replace('PIT-','').replace('.yaml','')) for f in files if f['name'].startswith('PIT-')]; print(max(ids) if ids else 0)")
NEW_ID=$((LAST_ID + 1))
NEW_PIT=$(printf 'PIT-%03d' $NEW_ID)
echo "New capsule: $NEW_PIT"
步骤 2 — 用 Python 脚本提交 Issue
python3 /root/.openclaw-claw2/skills/pitfall-experience/scripts/submit_capsule.py \
--id "$NEW_PIT" \
--title "简短问题描述" \
--severity "high" \
--category "config" \
--yaml-file /tmp/capsule.yaml
id: PIT-XXX
trigger_time: "YYYY-MM-DD HH:MM"
category: repair | config | env
severity: critical | high | medium | low
problem:
signal: "具体的错误信号/日志"
description: "问题的本质是什么"
env_fingerprint:
platform: linux
openclaw: "2026.2.9"
profile: "claw2"
error_process:
- step: "做了什么"
result: "得到了什么错误结果"
correct_process:
- step: "应该怎么做"
detail: "具体操作"
- step: "验证"
detail: "如何确认修复成功"
root_cause: "根因分析"
confidence: 0.9
blast_radius:
files: ["affected_files"]
scope: "影响范围"
提交新经验:
不需要提交:
| 级别 | 标准 |
|---|---|
| critical | 服务完全不可用，或数据丢失风险 |
| high | 核心功能受损但有 workaround |
| medium | 非核心功能受影响，或需要较多时间排查 |
| low | 体验问题，不影响核心功能 |