Release v1.0.106: document optional OEM brands metadata

development/DEVELOPMENT.md

@@ -335,7 +335,7 @@ git remote -v
 
 应该重点写：
 
-- YAML frontmatter：`name`、`description`、`version`、`metadata.openclaw`（含 `slug`、`platform_kit_min_version`、`developer_ids` 等）
+- YAML frontmatter：`name`、`description`、`version`、`metadata.openclaw`（含 `slug`、`platform_kit_min_version`、`developer_ids`、可选 `brands` 等）
 - 何时触发本技能、CLI 入口摘要、运行契约要点
 - 指向 `references/`（Agent 调用）与 `development/`（开发规范）的分工说明
 
@@ -407,6 +407,51 @@ metadata:
 - 一期只做“补授权”，不会因为你 later 修改数组而自动撤销旧授权
 - **首次正式 release 前**就应配好；配错或漏配时，CI 可能成功，但你在技能市场仍找不到技能
 
+### 关于 `metadata.openclaw.brands`（OEM 市场，按需）
+
+#### 目的
+
+匠厂与华商、Lili、GDCM 等 OEM 客户端共用同一技能库，但技能市场目录按 **`market_code`** 过滤（客户端 Header `X-Market-Code`；缺省为 `jiangchang`）。
+
+发布接口 `POST /api/skill/update` 会把 `metadata.openclaw.brands` 幂等写入 `skill_market_relations`（**只补不删**）。**未声明 `brands` 时仅补默认 `jiangchang`**，因此只写在 Gitea 的 `client-huashang` 组织下、却不写 `brands: [huashang]`，华商市场仍然搜不到该技能。
+
+`brands` 与 `developer_ids` 正交：
+
+| 字段 | 管什么 |
+|------|--------|
+| `brands` | 技能出现在哪些 OEM 市场目录 |
+| `developer_ids` | 技能不公开（`access_scope = 0`）时，哪些用户仍可见并可安装 |
+
+#### 何时填写
+
+- **仅匠厂验收 / 通用技能**：可省略（默认匠厂）。
+- **须在华商或其他 OEM 客户端出现**：必须显式列出对应编码（通常同时保留 `jiangchang` 以便主站也能看到）。
+
+常见编码（小写机器码，非中文展示名）：`jiangchang`、`huashang`、`lili`、`gdcm` 等。非法编码会导致发布接口 400，CI 失败。
+
+#### 在 `SKILL.md` 中声明
+
+```yaml
+metadata:
+  openclaw:
+    slug: your-skill-slug
+    category: 通用
+    developer_ids:
+      - 12345
+    brands:
+      - jiangchang
+      - huashang
+```
+
+兼容别名（平台按优先级取第一个出现的键）：`brands` → `oem_clients` → `client_keys`。模板与文档统一推荐写 **`brands`**。
+
+约定：
+
+- **可选字段**：未写或空列表 → 行为与历史一致，只挂 `jiangchang`
+- **一期只补不删**：从 `brands` 去掉某市场后，不会自动删除库中已有关联；若需下架请走运营/后台或后续平台能力
+- **不要**指望 Gitea 组织名、目录名 `client-*` 自动映射市场
+- 发布后在对应 OEM 客户端（须带正确 `X-Market-Code`）搜索验收；也可查库 `skill_market_relations`
+
 ## 7. 文档目录分工
 
 当前规范 skill 的文档按读者拆分：
@@ -884,6 +929,7 @@ uses: client-jiangchang/jiangchang-platform-kit/.github/workflows/reusable-relea
 - [ ] 目录名、`SKILL.md` slug、`constants.SKILL_SLUG` 三者一致
 - [ ] `SKILL.md` 中 slug、名称、描述都已替换
 - [ ] `SKILL.md` 的 `developer_ids` 已换成**本人**匠厂用户 ID（设置 → 用户信息 → 复制），不是模板示例 ID
+- [ ] 若须在华商等 OEM 市场出现：`SKILL.md` 的 `brands` 已声明（如 `jiangchang` + `huashang`）；未写则仅匠厂；不要用 Gitea 组织名代替
 - [ ] `scripts/util/constants.py` 已修改
 - [ ] `../references/CLI.md` 示例命令已改成真实命令
 - [ ] `service` 下的核心业务文件（如 `task_service.py`）已按领域改名并实现