@geoly-ai/social-hub-cli 0.1.4 → 0.1.5

package/skills/social-hub-shared/SKILL.md

@@ -6,7 +6,7 @@ description: >-
   权限不足、或任何 Hub CLI 写操作前必须先读本 skill。Agent 日常凭证只用 auth login，
   不要用 SOCIAL_HUB_API_KEY 环境变量。
 metadata:
-  cliVersion: ">=0.0.12"
+  cliVersion: ">=0.1.4"
 ---
 
 # social-hub-shared
@@ -140,6 +140,20 @@ CLI 对部分命令（含 admin 域 settings/invites/members、reddit/accounts
 
 admin 专属操作（如 `agent-teams create`）需要 **admin** role 的 CLI token，不是「随便创建一个 API Key」就能替代。
 
+## 品牌 vs Campaign（Agent 必读）
+
+| 概念 | 正确 CLI / 字段 | 勿用于新流程 |
+|------|-----------------|-------------|
+| 品牌（系统级） | `brands system-list` / `brandId` | `campaigns list` 当品牌目录 |
+| 品牌成员 | `brand-members system-*` | `brand-members list -t`（compat） |
+| 账号归属品牌 | `accounts brand-bindings *` | `campaigns accounts *` |
+| 草稿 / 计划 | `drafts create -j '{"brandId":...}'` | 必填 `campaignId` 创建新草稿 |
+| 筛选 | `--brand <uuid>` | 仅 `--campaign` 作新默认 |
+
+**禁止**向用户推荐：`campaigns create`、`campaigns update`、`campaigns accounts bind` 作为新客户/品牌建模。
+
+`campaignId` 在 API 响应中可能仍存在（历史归因），只读兼容即可。
+
 ## 安全规则
 
 - **禁止**在对话或日志中输出完整 token / API Key（`config show` 已脱敏）。
@@ -157,6 +171,28 @@ admin 专属操作（如 `agent-teams create`）需要 **admin** role 的 CLI to
 | team 不一致 warning | `auth whoami` 的 teamId vs `context current` |
 | 401 / auth failed | 重新 `auth login`；过期则 `auth logout` 后重登 |
 
+## CLI 新版本检测（自动）
+
+除 `version` / `help` 外，每次执行 `social-hub` 会（最多每 24 小时）查询 npm registry；若存在比当前安装更新的 `@geoly-ai/social-hub-cli`，会在 **stderr** 打印升级提示，并明确要求 **Agent 告知用户** 后执行升级与 skill 同步。
+
+示例输出（节选）：
+
+```text
+[social-hub] Update available: 0.1.4 → 0.1.5
+[social-hub] Upgrade CLI: npm install -g @geoly-ai/social-hub-cli@0.1.5
+[social-hub] Then refresh skills: social-hub skills update --yes
+[social-hub] Agent: tell the user a newer CLI is available; ...
+```
+
+| 场景 | 行为 |
+|------|------|
+| 全局安装 | `npm install -g @geoly-ai/social-hub-cli@<latest>` |
+| npx 调用 | 后续命令使用 `npx @geoly-ai/social-hub-cli@<latest> …` |
+| 跳过检查 | `SOCIAL_HUB_NO_UPDATE_CHECK=1` 或 `social-hub --no-update-check …` |
+| CI | 设置 `CI=true` 时自动跳过 |
+
+Agent 看到上述 stderr 时：**先向用户说明有新版本**，再执行升级命令，最后 `social-hub skills update --yes`（避免 CLI 与 skill 文档/命令漂移）。
+
 ## Agent skills 安装与更新
 
 CLI 升级后同步 skill 到 Cursor / Codex 等目录：

package/skills/social-hub-shared/evals/evals.json

@@ -0,0 +1,15 @@
+{
+  "skill_name": "social-hub-shared",
+  "evals": [
+    {
+      "id": 0,
+      "prompt": "第一次用 social-hub 连生产 API，怎么登录和选 team？",
+      "expected_output": "auth login Device Code、context use、doctor；禁止 SOCIAL_HUB_API_KEY 作为默认",
+      "assertions": [
+        { "type": "must_include", "value": "auth login" },
+        { "type": "forbidden_pattern", "value": "SOCIAL_HUB_API_KEY" },
+        { "type": "must_include_any", "values": ["brandId", "brands system"] }
+      ]
+    }
+  ]
+}