用途:该技能用于在 Examples 功能中新增示例用例,面向贡献者提供样例文件(PDF、PNG、TXT 等)的场景,流程涵盖信息收集、文件放置、元数据登记、缩略图生成与链接校验。
主要能力:收集用例名称(英文或日文)、描述、分类标签、语言以及文件类型(checklist、review、knowledge);按语言创建目录并复制文件;必要时参考 references/PDF-DESIGN.md 进行 PDF 设计;生成 raw GitHub URL(日文须用 encodeURIComponent() 编码);更新 examples-metadata.json;新增分类标签时同步修改 types/index.ts、TagFilter.tsx、OnboardingModal.tsx 与 en.json、ja.json 翻译;生成 800x1200 JPEG 缩略图并写入 imagePath;校验所有 URL 返回 HTTP 200。
使用方式:需安装 uv 包管理器。首次安装依赖:cd .claude/skills/add-example && uv venv && uv pip install -e .;在项目根目录运行缩略图脚本:cd .claude/skills/add-example && source .venv/bin/activate 后执行 python scripts/generate_thumbnails.py;本地测试用 cd frontend && npm run dev,访问 http://localhost:5173/examples。
限制:标签命名遵循 kebab-case 与翻译键映射规则;用例 ID 形如 use_case_NNN 或 use_case_NNN_ja;仅当包含知识文件时设 hasKnowledgeBase 为 true;常见问题包括日文 URL 404(需编码)、示例不显示(检查 JSON 语法与语言、重启服务与清缓存)、图片不显示(确认 imagePath 与文件路径)。