第26课 context.json——让每个 Skill 共享同一份品牌记忆

开场：一个文件如何让 22 个工具共享信息

上一课讲了系统协同的概念。这一课打开 context.json，看看它到底长什么样、怎么用、出了问题怎么修。

这是一门技术课，但你不需要会写代码。你只需要能读懂一个 JSON 文件，知道如何修改几个值，以及理解每个字段代表什么意思。

context.json 是什么

从文件本身来说，它就是你品牌文件夹里的一个普通文本文件，名字叫 context.json：

customers/
  hazumicrafts/
    context.json        ← 就是这个
    hero-photos/
    listings/

这个文件里存着你这个品牌的所有"已知信息"：做过什么调研、品牌叫什么名字、风格是什么、listing ID 是多少、广告 break-even ROAS 是几、客服常见问题是什么。

每个 skill 运行时，做两件事：读 context.json（了解前面步骤留下的信息）+ 写 context.json（把自己这次运行的结论存进去）。信息在整个系统里流通，不需要你手动搬运。

context.json 的 5 大段落

对应 Brand OS 的 5 个模块：

brand 段——品牌基础信息。 最基础的信息：品牌叫什么、Tagline、目标客户是谁。通常在运行第一个 skill 之前手动填入，或者跑 brand-story 时它会帮你填充。

hound 段——市场调研结果。 market-scout 跑完会写这里：需求信号（哪些关键词在涨）、价格带、竞争强度。competitor-spy 写竞品分析，trend-timer 写趋势时机。这段数据是后续所有 Parrot 和 Bee skill 的原料。

parrot 段——品牌叙事和内容。 品牌故事、主图风格、文案调性、每个 SKU 的产品描述。后续上架时，Rabbit 直接从这里取文案。

rabbit 段——上架信息。 平台、listing ID 列表、SEO 关键词、定价记录。每次成功上架，Rabbit 会把 listing ID 写回来。

bee 段——投流和广告。 受众画像、广告计划、break-even ROAS、每个平台的执行记录和监控数据。

elephant 段——复盘和客服。 销售数据、常见客服问题、改进行动项。这段内容越丰富，说明运营时间越长、数据越扎实。

一个完整的 context.json 示例

这是 HazumiCrafts（手工钩织女装）的真实结构（字段值已简化）：

json

{
  "brand": {
    "name": "HazumiCrafts",
    "tagline": "Handcrafted with love, worn with intention",
    "target_market": "Women 25-45 who value artisan fashion",
    "price_range": "$168-$260",
    "platform": "etsy + snipcart"
  },
  "hound": {
    "market": {
      "demand_signals": ["chunky knit sweater", "sustainable fashion", "handmade knitwear"],
      "price_range": "$80-$200",
      "competition_level": "medium",
      "top_keywords": ["cottagecore sweater", "crochet cardigan", "artisan knitwear"]
    },
    "competitors": {
      "gap": "most competitors don't have story-driven photography"
    },
    "trend": {
      "timing": "peak season Oct-Jan",
      "trending_up": ["muted earth tones", "oversized silhouettes"]
    }
  },
  "parrot": {
    "brand_story": "Sarah learned to crochet from her grandmother in rural Japan...",
    "hero_image_style": "flatlay on linen + warm natural light from window",
    "copy_tone": "warm, personal, story-driven",
    "skus": {
      "chunky-turtleneck-pink": {
        "title": "Pink Chunky Turtleneck Sweater | Handmade Crochet",
        "tags": ["chunky knit", "turtleneck", "crochet sweater", "handmade gift"]
      }
    }
  },
  "rabbit": {
    "platform": "etsy",
    "listing_ids": ["4562907926"],
    "seo_keywords": ["chunky turtleneck sweater", "handmade crochet sweater"],
    "pricing": { "S": 168, "M": 185, "L": 200 }
  },
  "bee": {
    "audience": {
      "primary": "Women 28-42, interests: sustainable fashion, handmade goods",
      "platforms": ["pinterest", "instagram"]
    },
    "campaign": {
      "break_even_roas": 1.75,
      "daily_budget": 5,
      "kill_threshold_roas": 1.2,
      "scale_threshold_roas": 2.5
    },
    "monitor": {
      "last_check": "2026-10-07",
      "roas_7d": 2.1,
      "recommendation": "ROAS above break-even, consider scale"
    }
  },
  "elephant": {
    "sales": {
      "total_orders": 23,
      "revenue_30d": 3864,
      "top_sku": "chunky-turtleneck-pink"
    },
    "common_questions": ["sizing", "washing instructions", "shipping time to EU"],
    "improvement_items": ["add size chart photo", "improve sleeve measurement table"]
  }
}

看着很长，但每个字段在课程里都见过。Hound 调研的结论在 hound.market，Bee 的 break-even ROAS 在 bee.campaign.break_even_roas，客服常见问题在 elephant.common_questions。

怎么初始化一个新品牌

最简单的方法：运行任何一个 skill，它会自动创建。

比如运行 hound/market-scout，它发现当前文件夹里没有 context.json，会自动建一个基础版本，把调研结果写进 hound 段，其他段留空。

你也可以手动创建——新建一个 context.json，填入最基础的 brand 信息：

json

{
  "brand": {
    "name": "你的品牌名",
    "tagline": "初步想法，之后可以改",
    "target_market": "你初步判断的目标客户"
  }
}

存好，开始跑第一个 skill。

Skill 读写对应关系

Skill	读取	写入
`market-scout`	`brand.name`, `brand.target_market`	`hound.market`, `hound.competitors`
`product-copy`	`hound.market`, `parrot.copy_tone`	`parrot.skus.<sku>.description`
`etsy-listing-manager`	`parrot.skus.*`, `rabbit.seo_keywords`	`rabbit.listing_ids`
`campaign-plan`	`hound.market`, `rabbit.pricing`	`bee.campaign`
`campaign-monitor`	`bee.campaign.*`	`bee.monitor`

你不需要记住每个 skill 读写哪些字段，用到时看 skill 文档就行。但理解这个机制，你就能明白为什么要按顺序跑：market-scout 得先跑，因为后面的 skill 要读它写入的 hound.market 数据。

常见问题

context.json 丢了怎么办？ 重新跑一遍 skill 链——调研重跑、文案重生成、listing ID 去平台后台查。比较麻烦但能恢复。建议定期备份 context.json，或者放在 Git 仓库里版本管理。

我手动改了某个值，skill 会覆盖掉吗？ 大多数 skill 在写入时，会保留你手动添加的字段，只更新自己负责的字段。如果想保留某个手动判断不被覆盖，放在 skill 不负责的自定义字段里，比如 brand.notes。

JSON 格式写错了怎么验证？ 用在线 JSON 验证器（搜"JSON Lint"）检查格式。注意两点：字符串用双引号，最后一个字段后面不要有多余的逗号。

可以加自己的字段吗？ 完全可以。Brand OS 的 skill 只读取它们认识的字段，不认识的字段会忽略，不会删除。

多品牌管理

每个品牌一个文件夹，每个文件夹里一个 context.json，互相完全隔离：

customers/
  hazumicrafts/
    context.json      ← HazumiCrafts 的品牌记忆
  emotions/
    context.json      ← about emotions 的品牌记忆
  fulu/
    context.json      ← Fulu is Coming 的品牌记忆

运行 skill 时，告诉它 context.json 的路径，它就知道在操作哪个品牌。不会串。同时跑 6 个品牌，靠的就是这个隔离机制。

本课作业

为你的品牌项目创建 context.json，填入：

brand 段：品牌名、初步 tagline、目标客户描述
hound.market：你目前已知的需求信号（哪怕只有 2-3 个关键词），价格带初步判断

截图发到学习群——不用完整，能看到文件结构和你填的内容就行。

第26课 context.json——让每个 Skill 共享同一份品牌记忆 ​

开场：一个文件如何让 22 个工具共享信息 ​

context.json 是什么 ​

context.json 的 5 大段落 ​

一个完整的 context.json 示例 ​

怎么初始化一个新品牌 ​

Skill 读写对应关系 ​

常见问题 ​

多品牌管理 ​

本课作业 ​