用途：为 Stream Activity Feeds 应用的 v2→v3 同步配置生成 mapping 对象。同一 mapping 同时服务实时 syncer 与批量 exporter；写错会同时影响两条迁移路径。
必要用法：先导出凭据到环境变量，切勿把 secret 贴入对话或读取 .env： ! export STREAM_API_KEY=<v2 app key> STREAM_API_SECRET=<v2 app secret> 确认存在但不打印值：test -n "$STREAM_API_SECRET" && echo SECRET_SET || echo SECRET_MISSING 默认目标为生产环境 https://api.stream-io-api.com，如需其他环境用 --base-url。 抓取样本：python3 <skill-dir>/scripts/fetch_sample.py --out v3sync-sample.json <skill-dir> 为 SKILL.md 所在目录，需解析为绝对路径，常见位置为 .agents/skills/stream-feeds-migration（Cursor、Codex）或 .claude/skills/stream-feeds-migration（Claude Code）。脚本仅用标准库，从 STREAM_API_KEY/STREAM_API_SECRET 读取，无 --secret 参数；调用两个服务端接口，取最近 100 条 activities 与每种 kind 5 条 reactions，返回未扁平化的原始存储数据。401/403 表示密钥错误或误用用户 token；404 表示该部署尚未提供接口。
主要能力：分析 extra_context 自定义字段、activity id/foreign_id、shared_origin_post 等 SA: 引用、text、附件路径、actor 前缀格式、reactions 的 kind 分类（comment/bookmark/comment-bookmark/普通反应）、评论文本字段、父评论与评论上反应的字段路径等，按需输出最小化 mapping。每个键都有适用于常规 v2 应用的默认值，只有样本显示偏离默认时才输出；空 mapping（{}）是合法答案，不要用默认值凑数。仅输出 mapping 对象本身，不含 enabled、base_url、api_key、secret、sample_rates 等部署项；每个键需指出样本依据，并列出刻意省略的键及原因。建议首轮验证加 "debug": true，确认后移除。
适用场景：v2 Feeds 应用数据字段与 v3 约定不一致、需要迁移配置依据时。
限制：activities 仅最近 100 条，旧 schema 字段可能缺失；reactions 取自有限近期窗口，kind 词表可能不全；不抽样 users，name/image 映射需另行确认；稀有形状可能不在样本中；样本会轮换，可重复运行佐证。资料未提供具体收费与支持方式，仅给出联系地址 getstream.io/contact。