@geoly-ai/social-hub-cli 0.0.6 → 0.0.8

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

@@ -1,363 +1,237 @@
 ---
 name: social-hub-cli
 description: >-
-  Social Ops Hub 命令行 social-hub：账号、事件、日历、调度任务、Reddit 帖、报告、API Key、OpenClaw 回填等。
+  Social Ops Hub 命令行 social-hub：账号、事件、日历、调度任务、Reddit 帖、报告、OpenClaw 回填等。
   只要用户提到 social-hub、Social Ops Hub、Hub 写数据、查账号、发帖计划、permalink 回填、openclaw、
-  调度任务、团队 API Key、互动事件，或要在 Hub 里查/改运营数据，就应使用本 skill（即使用户没说 CLI）。
-  先读本 skill 做路由，再打开对应领域 skill（ops-runtime、openclaw-context 等）。
+  调度任务、互动事件，或要在 Hub 里查/改运营数据，就应使用本 skill（即使用户没说 CLI）。
+  先读本 skill 做路由；执行任何命令前必须先读 social-hub-shared 完成 auth login 与 context。
 metadata:
-  cliVersion: ">=0.0.4"
-  homepage: https://github.com/your-org/social-ops-hub/tree/main/skills
+  cliVersion: ">=0.0.6"
+  homepage: https://github.com/geoly-ai/geoly-reddit/tree/main/social-ops-hub/skills
 ---
 
 # Social Hub CLI
 
-`social-hub` 封装 Social Ops Hub REST API，供人工与 Agent 使用。配套领域 skill 与本目录同级（`skills/social-hub-*`）。
+`social-hub` 封装 Social Ops Hub REST API，供人工与 Agent 使用。
 
-## 安装 Skill
+> **前置条件：** 执行 Hub 命令前 MUST 先读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
+> 完成 `social-hub auth login`（Device Code）并 `social-hub context use <team-id>`。
+> 日常**不要**使用 `SOCIAL_HUB_API_KEY` / `SOCIAL_HUB_API_URL` 环境变量。
 
-- **推荐（CLI）**：`social-hub skills tui` 或 `social-hub skills install --agent cursor --global --yes`
+## 快速开始（生产）
+
+```bash
+social-hub auth login --api-url https://reddit.eclick-geo.com/api
+social-hub auth whoami
+social-hub context use <team-uuid>
+social-hub doctor
+social-hub health
+```
+
+生产 API 基址：**`https://reddit.eclick-geo.com/api`**。下文示例中 `<team-id>` 指当前 context 的 team UUID。
+
+## 安装 CLI 与 Skill
+
+```bash
+npm install -g @geoly-ai/social-hub-cli@latest
+social-hub version
+```
+
+安装 Agent Skills：
+
+- **交互式（推荐，默认）**：`social-hub skills install` 或 `social-hub skills install <skillId>`（TTY 下打开 TUI，CLI 参数会预填 agent/skill/scope）
+- **Cursor 全局（脚本）**：`social-hub skills install --agent cursor --global --yes`
+- **单 skill 脚本化**：`social-hub skills install social-hub-cli --agent cursor --global --yes`
+- **更新已装 skills**：`social-hub skills update --agent cursor --global --yes`
+- **所有已检测 agent 目录（显式 opt-in）**：`social-hub skills install --agent '*' --global --yes`
 - **免全局安装**：`npx @geoly-ai/social-hub-cli skills bootstrap`
-- **GitHub 最新**：`social-hub skills install --source github --repo geoly-ai/geoly-reddit --yes`
-- **更新已装 skill**：`social-hub skills update --all --yes`（可加 `--source github`）
+- **GitHub 最新**：`social-hub skills install --source github --repo geoly-ai/geoly-reddit --agent cursor --global --yes`
 - **检查状态**：`social-hub skills doctor`
-- **同仓开发**：`pnpm skills:install`（或 `pnpm --filter @geoly-ai/social-hub-cli run build` 后使用内置 bundle）
-- **skill.sh / 公开市场**：从 [skill.sh](https://skill.sh) 导入本仓库 `skills/` 子目录（见 `skills/README.md`）
 
-## 领域 Skill 路由（先读子 skill）
+## 领域 Skill 路由
 
 | 场景 | Skill |
 |------|--------|
-| 配置 / doctor / auth | `social-hub-shared` |
+| 鉴权 / config / doctor / context | **`social-hub-shared`**（必读） |
 | OpenClaw 领任务 / 回填 | `social-hub-ops-runtime` |
 | 账号/任务上下文（DB） | `social-hub-openclaw-context` |
 | 账号 CRUD | `social-hub-accounts` |
 | Reddit 帖 | `social-hub-posts` |
 | 日历 / jobs | `social-hub-calendar-jobs` |
 | 发布闭环 | `social-hub-publishing` |
-| settings / invites | `social-hub-admin` |
+| settings / invites / 成员 | `social-hub-admin` |
 | 情报 | `social-hub-intelligence` |
 | 导入导出 replay | `social-hub-migration` |
 
-`social-hub` 是 Social Ops Hub 的命令行工具，封装了全部 REST API。
+命中上表场景时，打开对应领域 skill，**不要**只在总览里硬写命令而跳过子 skill。
 
-## 配置（环境变量）
+## 同仓开发 Build
 
-使用前需设置以下环境变量：
+在 **social-ops-hub  monorepo** 内改 CLI/SDK 后：
 
 ```bash
-export SOCIAL_HUB_API_URL="http://localhost:3000"   # Hub API 地址，默认 localhost:3000
-export SOCIAL_HUB_API_KEY="soh_..."                 # API Key（除 health 外均必需）
-export SOCIAL_HUB_TEAM_ID="<uuid>"                  # 当前操作的 Team UUID（命令中用 $SOCIAL_HUB_TEAM_ID）
-```
-
-`health` 命令不需要 API Key。其他所有命令必须设置 `SOCIAL_HUB_API_KEY`。
-
-## 前置步骤：Build
-
-在 **本 monorepo 根目录** 首次使用或更新代码后，需先 build：
-
-```bash
-cd "$(git rev-parse --show-toplevel)"
 pnpm --filter @geoly-ai/social-hub-sdk run build
 pnpm --filter @geoly-ai/social-hub-cli run build
 ```
 
----
-
-## 初始化工作流（新环境冷启动）
+## 本地 API 冷启动（仅开发）
 
-### 步骤 0：部署前置
+部署/seed 细节见仓库文档；CLI 侧只需改 API 地址并重新 login：
 
 ```bash
-# 1. 复制并填写环境变量
-cp .env.example .env
-# 至少填写：DATABASE_URL、REDIS_URL、API_KEY_PEPPER、JWT_SECRET
-
-# 2. 执行数据库迁移
+cp .env.example .env   # 填写 DATABASE_URL、REDIS_URL 等
 pnpm run db:migrate
-
-# 3. 初始化最小管理员种子（自动创建 moss team + admin 用户 + seed-cli API Key）
 SOCIAL_OPS_SEED_MODE=minimal-admin pnpm run db:seed
-# 控制台输出：
-#   admin@local.test / password123
-#   SOCIAL_HUB_TEAM_ID=<uuid>
-#   SOCIAL_HUB_API_KEY=soh_...
-
-# 4. 导出环境变量（或写入 .env）
-export SOCIAL_HUB_API_URL="http://localhost:3000"
-export SOCIAL_HUB_API_KEY="soh_..."          # 从上面控制台复制
-export SOCIAL_HUB_TEAM_ID="<moss-team-uuid>"  # 从上面控制台复制
-
-# 5. 验证 Hub 是否正常
+pnpm dev
+social-hub auth login --api-url http://localhost:3000
+social-hub context use <seed 输出的 team uuid>
 social-hub health
 ```
 
-### 步骤 1：创建新团队（若需要独立 team）
-
-```bash
-# 使用 admin API Key 创建新团队
-NEW_TEAM=$(social-hub agent-teams create --slug javis --name "Javis Agent Team" | jq -r '.id')
-export T=$NEW_TEAM
-
-# 创建运营用户（密码直接设置，不需要 set-password 额外操作）
-social-hub users create -t $T -j '{"email":"ops@javis.local","password":"Ops2026!","name":"Javis Ops","role":"manager"}'
+创建新 team、用户等业务初始化：在 **已 auth login 且 role 足够** 的前提下执行下方「团队与用户管理」命令；**不要**再 export API Key。
 
-# 为新团队创建 API Key（Web 登录后进入 API Keys 页面，或用 admin key）
-social-hub api-keys create -t $T -j '{"name":"javis-ops","role":"manager"}'
-# → 记录返回的 rawKey，后续操作换用该 Key
-
-export SOCIAL_HUB_TEAM_ID=$T
-export SOCIAL_HUB_API_KEY="soh_..."  # 上面新建的 Key
-
-# 确认团队列表
-social-hub agent-teams list
-```
-
-### 步骤 2：创建业务数据（Brand → Campaign → Account → Plan）
+### 业务数据初始化示例
 
 ```bash
-T=$SOCIAL_HUB_TEAM_ID
-
-# 创建品牌
-BRAND_ID=$(social-hub brands create -t $T -j '{"name":"My Brand","slug":"my-brand"}' | jq -r '.id')
-
-# 创建 Campaign
-CAMP_ID=$(social-hub campaigns create -t $T -j \
-  "{\"brandId\":\"$BRAND_ID\",\"name\":\"2026 Q3 Launch\"}" | jq -r '.id')
-
-# 添加 Reddit 账号
-ACCOUNT_ID=$(social-hub accounts create -t $T -j \
-  "{\"platform\":\"reddit\",\"handle\":\"u/my_ops_account\",\"credentialsRef\":\"vault:javis/main\"}" | jq -r '.id')
-
-# 创建内容草稿
-DRAFT_ID=$(social-hub drafts create -t $T -j \
-  "{\"campaignId\":\"$CAMP_ID\",\"title\":\"Launch Post\",\"body\":\"...\"}" | jq -r '.id')
-
-# 创建发布计划（自动生成 scheduled_jobs）
-social-hub plans create -t $T -j "{
-  \"campaignId\": \"$CAMP_ID\",
-  \"name\": \"Q3 Week 1\",
-  \"entries\": [{
-    \"socialAccountId\": \"$ACCOUNT_ID\",
-    \"subreddit\": \"LocalLLaMA\",
-    \"plannedAt\": \"2026-07-01T09:00:00Z\",
-    \"contentDraftId\": \"$DRAFT_ID\"
-  }]
-}"
-
-# 验证：查看日历和任务
-social-hub calendar list -t $T --status scheduled
-social-hub jobs list -t $T --status scheduled
+# 创建品牌 → campaign → 账号 → 计划（<team-id> 来自 context current）
+BRAND_ID=$(social-hub brands create -t <team-id> -j '{"name":"My Brand","slug":"my-brand"}' | jq -r '.id')
+CAMP_ID=$(social-hub campaigns create -t <team-id> -j "{\"brandId\":\"$BRAND_ID\",\"name\":\"2026 Q3 Launch\"}" | jq -r '.id')
+ACCOUNT_ID=$(social-hub accounts create -t <team-id> -j '{"platform":"reddit","handle":"u/my_ops_account","credentialsRef":"vault:javis/main"}' | jq -r '.id')
+DRAFT_ID=$(social-hub drafts create -t <team-id> -j "{\"campaignId\":\"$CAMP_ID\",\"title\":\"Launch Post\",\"body\":\"...\"}" | jq -r '.id')
+social-hub plans create -t <team-id> -j "{\"campaignId\":\"$CAMP_ID\",\"name\":\"Q3 Week 1\",\"entries\":[{\"socialAccountId\":\"$ACCOUNT_ID\",\"subreddit\":\"LocalLLaMA\",\"plannedAt\":\"2026-07-01T09:00:00Z\",\"contentDraftId\":\"$DRAFT_ID\"}]}"
+social-hub calendar list -t <team-id> --status scheduled
+social-hub jobs list -t <team-id> --status scheduled
 ```
 
 ---
 
 ## 命令速查表
 
+以下 `-t <team-id>` 可换为 `social-hub context current` 中的 `currentTeamId`。
+
 ### health & dashboard
 
 ```bash
 social-hub health
-social-hub dashboard summary -t $T
-social-hub dashboard summary -t $T  # 支持 campaignId 过滤（通过 API 传参）
+social-hub dashboard summary -t <team-id>
 ```
 
 ### 互动事件
 
 ```bash
-social-hub events append -t $T --type comment --payload '{"permalink":"https://..."}'
-social-hub events list -t $T -n 20                   # 简单列表
-social-hub events list-full -t $T --account <uuid>   # 按账号过滤
-social-hub events list-full -t $T --type comment --result succeeded --from 2026-05-01T00:00:00Z
-social-hub events export-csv -t $T > events.csv
-social-hub events export-csv -t $T --account <uuid> --from 2026-05-01T00:00:00Z > filtered.csv
+social-hub events append -t <team-id> --type comment --payload '{"permalink":"https://..."}'
+social-hub events list -t <team-id> -n 20
+social-hub events list-full -t <team-id> --account <uuid>
+social-hub events export-csv -t <team-id> > events.csv
 ```
 
 ### 发布日历
 
 ```bash
-social-hub calendar list -t $T --status scheduled
-social-hub calendar list-full -t $T --account <accountId> --status scheduled
-social-hub calendar patch -t $T -e <entryId> --body '{"status":"succeeded","permalink":"https://..."}'
+social-hub calendar list -t <team-id> --status scheduled
+social-hub calendar list-full -t <team-id> --account <accountId> --status scheduled
+social-hub calendar patch -t <team-id> -e <entryId> --body '{"status":"succeeded","permalink":"https://..."}'
 ```
 
 ### 调度任务
 
 ```bash
-social-hub jobs list -t $T --status scheduled
-social-hub jobs list-full -t $T --account <accountId>
-social-hub jobs create -t $T -j '{"socialAccountId":"<uuid>","action":"engage","subreddit":"LocalLLaMA","runAt":"2026-05-07T09:00:00Z"}'
-social-hub jobs agent-status -t $T -i <jobId> -j '{"status":"succeeded"}'
-social-hub jobs agent-status -t $T -i <jobId> -j '{"status":"failed","lastError":"timeout"}'
-social-hub jobs retry -t $T -i <jobId>
-social-hub jobs cancel -t $T -i <jobId>
-```
-
-### 发布计划
-
-```bash
-social-hub plans list -t $T
-social-hub plans list -t $T --campaign <campaignId>
-social-hub plans create -t $T -j '{"campaignId":"<uuid>","name":"Q3 Week1","entries":[{"socialAccountId":"<uuid>","subreddit":"LocalLLaMA","plannedAt":"2026-07-01T09:00:00Z"}]}'
-social-hub plans cancel -t $T --plan <planId>
+social-hub jobs list -t <team-id> --status scheduled
+social-hub jobs create -t <team-id> -j '{"socialAccountId":"<uuid>","action":"engage","subreddit":"LocalLLaMA","runAt":"2026-05-07T09:00:00Z"}'
+social-hub jobs retry -t <team-id> -i <jobId>
+social-hub jobs cancel -t <team-id> -i <jobId>
 ```
 
-### 内容草稿
-
-```bash
-social-hub drafts list -t $T -n 20
-social-hub drafts create -t $T -j '{"campaignId":"<uuid>","title":"Test Post","body":"Content..."}'
-social-hub drafts get -t $T --draft <uuid>
-social-hub drafts update -t $T --draft <uuid> -j '{"status":"approved"}'
-social-hub drafts delete -t $T --draft <uuid>
-```
-
-### 报告库
-
-```bash
-social-hub reports list -t $T -n 20
-social-hub reports create -t $T -j '{"reportType":"campaign-digest","title":"5月报告","source":"manual","contentMarkdown":"# 报告..."}'
-social-hub reports ingest -t $T -j '{"reportType":"reddit-post-snapshot","source":"path/to/file.md"}'
-```
+OpenClaw 执行态优先 `social-hub ops *`（见 `social-hub-ops-runtime`）；`jobs agent-status` 为遗留路径。
 
-### 账号管理
+### 发布计划 / 草稿 / 报告
 
 ```bash
-social-hub accounts list -t $T
-social-hub accounts list -t $T --status active
-social-hub accounts get -t $T --account <uuid>
-social-hub accounts create -t $T -j '{"platform":"reddit","handle":"u_example","externalId":"..."}'
-social-hub compliance risk-get -t $T -a <accountId>
-social-hub compliance risk-put -t $T -a <accountId> -j '{"riskLevel":"medium","notes":"..."}'
+social-hub plans list -t <team-id>
+social-hub plans create -t <team-id> -j '{"campaignId":"<uuid>","name":"Q3 Week1","entries":[...]}'
+social-hub drafts list -t <team-id> -n 20
+social-hub reports list -t <team-id> -n 20
 ```
 
-### 品牌与 Campaign
+### 账号 / 品牌 / Campaign
 
 ```bash
-social-hub brands list -t $T
-social-hub brands create -t $T -j '{"name":"My Brand","slug":"my-brand"}'
-social-hub brands update -t $T --brand <brandId> -j '{"name":"New Name"}'
-social-hub campaigns list -t $T --brand <brandId>
-social-hub campaigns get -t $T --campaign <uuid>
-social-hub campaigns create -t $T -j '{"brandId":"<uuid>","name":"2026 Q2"}'
-social-hub campaigns update -t $T --campaign <uuid> -j '{"name":"2026 Q3"}'
+social-hub accounts list -t <team-id> --status active
+social-hub accounts get -t <team-id> --account <uuid>
+social-hub brands list -t <team-id>
+social-hub campaigns list -t <team-id> --brand <brandId>
 ```
 
 ### 板块情报
 
 ```bash
-social-hub intelligence hot-posts -t $T --subreddit LocalLLaMA
-social-hub intelligence hot-posts -t $T --sort score -n 50
-social-hub intelligence dispatch -t $T -j '{"hotPostId":"<uuid>","socialAccountId":"<uuid>","action":"engage"}'
-social-hub intelligence kol-intents -t $T -n 20
-social-hub intelligence watchlists-list -t $T
+social-hub intelligence hot-posts -t <team-id> --subreddit LocalLLaMA --sort score -n 50
+social-hub intelligence dispatch -t <team-id> -j '{"hotPostId":"<uuid>","socialAccountId":"<uuid>","action":"engage"}'
+social-hub intelligence watchlists-list -t <team-id>
 ```
 
 ### 团队与用户管理
 
 ```bash
 social-hub agent-teams list
-social-hub agent-teams create --slug moss --name "Moss Agent Team"          # admin only
-social-hub agent-teams add-member -t $T --user <userId> --role manager      # admin only
-social-hub users list -t $T
-social-hub users create -t $T -j '{"email":"agent@example.com","password":"xxx","role":"manager"}'
+social-hub agent-teams create --slug javis --name "Javis Agent Team"   # admin only
+social-hub users list -t <team-id>
+social-hub users create -t <team-id> -j '{"email":"ops@example.com","password":"...","role":"manager"}'
 ```
 
 ### 通知渠道
 
 ```bash
-social-hub notification-channels list -t $T
-social-hub notification-channels create -t $T -j '{"provider":"feishu","externalId":"https://open.feishu.cn/open-apis/bot/v2/hook/..."}'
-social-hub notification-channels test -t $T --channel <uuid>
-social-hub notification-channels delete -t $T --channel <uuid>
+social-hub notification-channels list -t <team-id>
+social-hub notification-channels create -t <team-id> -j '{"provider":"feishu","externalId":"https://..."}'
 ```
 
-### API Key 管理
+### API Key 管理（管理员资源，非 CLI 登录方式）
 
 ```bash
-social-hub api-keys list -t $T
-social-hub api-keys create -t $T -j '{"name":"agent-key","role":"manager"}'
-social-hub api-keys rotate -t $T --key <uuid>
-social-hub api-keys delete -t $T --key <uuid>
+social-hub api-keys list -t <team-id>
+social-hub api-keys create -t <team-id> -j '{"name":"integration","role":"manager"}'
 ```
 
 ---
 
 ## 典型工作流
 
-### 工作流 1：Agent 执行完成后回填 Hub
+### Agent 执行完成后回填
 
-```bash
-T=$SOCIAL_HUB_TEAM_ID
-ENTRY_ID="<calendarEntryId>"
-PERMALINK="https://www.reddit.com/r/LocalLLaMA/comments/xxx/yyy/"
-
-# 1. 更新日历条目状态为 succeeded
-social-hub calendar patch -t $T -e $ENTRY_ID \
-  --body "{\"status\":\"succeeded\",\"permalink\":\"$PERMALINK\"}"
+优先 `social-hub ops complete --permalink ...`（见 `social-hub-ops-runtime`）。手动 patch 示例：
 
-# 2. 写入互动事件
-social-hub events append -t $T \
-  --type "post.published" \
-  --payload "{\"permalink\":\"$PERMALINK\",\"calendarEntryId\":\"$ENTRY_ID\"}"
-
-# 3. 查看该账号近期事件（验证写入）
-social-hub events list-full -t $T --account $ACCOUNT_ID -n 10
+```bash
+social-hub calendar patch -t <team-id> -e <entryId> \
+  --body '{"status":"succeeded","permalink":"https://www.reddit.com/r/.../..."}'
+social-hub events append -t <team-id> --type post.published \
+  --payload '{"permalink":"...","calendarEntryId":"<entryId>"}'
 ```
 
-### 工作流 2：查看账号运营数据
+### 查看账号运营数据
 
 ```bash
-T=$SOCIAL_HUB_TEAM_ID
-ACCOUNT_ID="<socialAccountId>"
-
-# 账号详情
-social-hub accounts get -t $T --account $ACCOUNT_ID
-
-# 近期事件
-social-hub events list-full -t $T --account $ACCOUNT_ID -n 20
-
-# 近期调度任务
-social-hub jobs list-full -t $T --account $ACCOUNT_ID --status scheduled
-
-# 关联发布日历
-social-hub calendar list-full -t $T --account $ACCOUNT_ID --status scheduled
-
-# 风险档案
-social-hub compliance risk-get -t $T -a $ACCOUNT_ID
+social-hub accounts get -t <team-id> --account <accountId>
+social-hub events list-full -t <team-id> --account <accountId> -n 20
+social-hub jobs list-full -t <team-id> --account <accountId> --status scheduled
+social-hub compliance risk-get -t <team-id> -a <accountId>
 ```
 
-### 工作流 3：情报热帖派发任务
+### 情报热帖派发
 
 ```bash
-T=$SOCIAL_HUB_TEAM_ID
-
-# 1. 查看热帖
-social-hub intelligence hot-posts -t $T --sort score -n 10
-
-# 2. 查看可用账号
-social-hub accounts list -t $T --status active
-
-# 3. 派发互动任务
-social-hub intelligence dispatch -t $T -j '{
-  "hotPostId": "<hotPostId>",
-  "socialAccountId": "<accountId>",
-  "action": "engage",
-  "runAt": "2026-05-07T09:00:00Z"
-}'
-
-# 4. 确认任务已创建
-social-hub jobs list -t $T --status scheduled -n 5
+social-hub intelligence hot-posts -t <team-id> --sort score -n 10
+social-hub accounts list -t <team-id> --status active
+social-hub intelligence dispatch -t <team-id> -j '{"hotPostId":"...","socialAccountId":"...","action":"engage","runAt":"..."}'
+social-hub jobs list -t <team-id> --status scheduled -n 5
 ```
 
 ---
 
 ## 注意事项
 
-- 所有命令输出均为 **JSON**，可管道传给 `jq` 处理：`social-hub accounts list -t $T | jq '.items[].handle'`
-- `DELETE` 端点（drafts delete、plans cancel、notification-channels delete）返回空响应（204），成功时打印 `OK`
-- `events export-csv` 和 `intelligence hot-posts-export` 输出 CSV 到 stdout，可直接重定向：`> output.csv`
-- 团队管理操作（`agent-teams create/update/add-member`）需要 **admin** 角色的 API Key
-- Session（Cookie）认证不在 CLI 支持范围内，始终使用 API Key
-
+- 命令输出多为 **JSON**，可管道 `jq`。
+- `DELETE` / cancel 成功时可能返回 204，CLI 打印 `OK`。
+- `events export-csv`、`intelligence hot-posts-export` 输出 CSV 到 stdout。
+- 团队管理（`agent-teams create` 等）需要 **admin** role 的 CLI token。
+- CLI 凭证来自 **Device Code**（`auth login`），不是 Web Session Cookie，也不是日常手动创建的 API Key。

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

@@ -3,20 +3,20 @@
   "evals": [
     {
       "id": 0,
-      "prompt": "我刚在本地部署好了 Social Ops Hub，openclaw-template 也初始化完了。我需要在 Hub 里注册一个新团队叫 javis，slug 也是 javis，然后给这个团队添加一个管理员用户，email 是 ops@javis.local，密码是 Javis2026!。完成后确认一下团队列表里有了这个团队。",
-      "expected_output": "使用 social-hub-cli skill，依次执行：social-hub agent-teams create、social-hub users create -t <newTeamId>、social-hub agent-teams list，输出各步骤的命令和 JSON 结果",
+      "prompt": "我要连生产 Social Ops Hub（https://reddit.eclick-geo.com/api），用 social-hub 登录并确认当前身份和 team，然后在 Hub 里注册一个新团队 javis（slug 也是 javis），给这个团队添加管理员用户 ops@javis.local，密码 Javis2026!，最后确认团队列表里有 javis。不要用 SOCIAL_HUB_API_KEY 环境变量。",
+      "expected_output": "先读 social-hub-shared：auth login --api-url 生产地址、auth whoami、context use；再读 social-hub-cli/admin：agent-teams create、users create、agent-teams list；全程 Device Code 凭证，不 export API key",
       "assertions": []
     },
     {
       "id": 1,
-      "prompt": "我的 Reddit 账号 u/example_user（id 是 abc123-...-uuid）刚刚在 r/LocalLLaMA 发了一个帖子，permalink 是 https://www.reddit.com/r/LocalLLaMA/comments/abc123/test_post/。对应的发布日历条目 id 是 def456-...-uuid。帮我把这个结果写进 Social Ops Hub：把日历条目标记为 succeeded，写入 permalink，同时记录一条 post.published 事件。最后查一下这个账号最近的互动事件确认写入成功。",
-      "expected_output": "执行 calendar patch（succeeded + permalink）、events append（post.published）、events list-full --account，输出每步的命令和结果",
+      "prompt": "Reddit 账号 u/example_user 刚在 r/LocalLLaMA 发帖，permalink 是 https://www.reddit.com/r/LocalLLaMA/comments/abc123/test_post/，日历条目 def456-uuid。我已在生产 Hub auth login 并 context use 了 team。帮我把日历标 succeeded、写 post.published 事件，并查该账号最近事件。优先 ops complete，若需手动则 calendar patch + events append。",
+      "expected_output": "确认已 auth/context；执行 ops complete 或 calendar patch + events append + events list-full；不要求设置 SOCIAL_HUB_API_KEY",
       "assertions": []
     },
     {
       "id": 2,
-      "prompt": "帮我查一下 Social Ops Hub 里板块情报里 r/Entrepreneur 最近按分数排名的前 5 条热帖，然后选第一条，派发一个 engage 互动任务给账号 ghi789-...-uuid，运行时间设为明天上午 9 点（2026-05-07T01:00:00Z UTC）。任务派发完后确认一下调度任务列表里有这条新任务。",
-      "expected_output": "执行 intelligence hot-posts --subreddit Entrepreneur --sort score -n 5、intelligence dispatch（带 hotPostId/socialAccountId/action/runAt）、jobs list 确认，输出各步命令和结果",
+      "prompt": "查生产 Hub 里 r/Entrepreneur 按 score 前 5 热帖，给账号 ghi789-uuid 派发 engage 任务，runAt 2026-05-07T01:00:00Z，并确认 jobs 列表有新任务。我已 social-hub auth login 到 reddit.eclick-geo.com。",
+      "expected_output": "路由 social-hub-intelligence：hot-posts、dispatch；social-hub-calendar-jobs：jobs list；使用 -t team-id 来自 context，不用 localhost 或 API key env",
       "assertions": []
     }
   ]

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

@@ -4,22 +4,27 @@ description: >-
   板块情报：watchlists、hot posts、KOL intents、industry-pools、dispatch 等 social-hub intelligence 子命令。
   用户要盯 subreddit、拉热帖、行业池、情报派发时用本 skill。
 metadata:
-  cliVersion: ">=0.0.1"
+  cliVersion: ">=0.0.6"
 ---
 
 # social-hub-intelligence
 
+> **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
+> 确认已 auth login 并 `context use <team-id>`。
+
 ```bash
-social-hub intelligence industry-pools-list -t "$T"
-social-hub intelligence watchlists-list -t "$T"
-social-hub intelligence hot-posts -t "$T" --subreddit technology
-social-hub intelligence dispatch -t "$T" -j '{ ... }'   # 写操作注意 --apply
+social-hub intelligence industry-pools-list -t <team-id>
+social-hub intelligence watchlists-list -t <team-id>
+social-hub intelligence hot-posts -t <team-id> --subreddit technology --sort score -n 50
+social-hub intelligence kol-intents -t <team-id> -n 20
+social-hub intelligence dispatch -t <team-id> -j '{ ... }'   # 写操作：确认 payload 与 --apply（若命令支持）
 ```
 
-账号可发帖板块优先用：
+账号可发帖板块优先用 Hub DB 查询，不要猜 subreddit：
 
 ```bash
-social-hub query account-pools -t "$T" --account <ref>
+social-hub query account-pools -t <team-id> --account <ref>
+social-hub query subreddit-candidates -t <team-id> --account <ref> --action publish_post
 ```
 
 WebSocket `runs/ws` 为 watch 能力，不适合普通 CLI 批处理。

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

@@ -4,23 +4,26 @@ description: >-
   Hub 数据批量：export events-jsonl、export agent-context、runbook replay、openclaw-ingest。
   用户要导出 JSONL、回放事件、迁移/对账时用本 skill；不包含工作区 shared 目录批量 sync（需人工决策）。
 metadata:
-  cliVersion: ">=0.0.1"
+  cliVersion: ">=0.0.6"
 ---
 
 # social-hub-migration
 
+> **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
+> 确认已 auth login；导出/回放目标 team 用 `-t <team-id>`。
+
 ## 导出
 
 ```bash
-social-hub export events-jsonl -t "$T" -o events.jsonl -n 500
-social-hub export agent-context -t "$T" --account "<uuid>" -o ctx.json
+social-hub export events-jsonl -t <team-id> -o events.jsonl -n 500
+social-hub export agent-context -t <team-id> --account <uuid> -o ctx.json
 ```
 
 ## Runbook 回放
 
 ```bash
-social-hub runbook replay -t "$T" -f events.jsonl --dry-run
-social-hub runbook replay -t "$T" -f events.jsonl          # 实际 append events
+social-hub runbook replay -t <team-id> -f events.jsonl --dry-run
+social-hub runbook replay -t <team-id> -f events.jsonl          # 实际 append events
 ```
 
 JSONL 每行：`{"type":"comment","payload":{...}}`

package/skills/social-hub-openclaw-context/SKILL.md

@@ -5,15 +5,18 @@ description: >-
   export agent-context。用户问账号能发哪些版、任务上下文、板块池、guardrails、数据是否过期时，
   必须用 Hub DB 聚合接口，不要解析 Javis/Moss/Panda 工作区里的 shared/*.md。
 metadata:
-  cliVersion: ">=0.0.1"
+  cliVersion: ">=0.0.6"
 ---
 
 # social-hub-openclaw-context
 
+> **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
+> 确认已 auth login。所有 `-t <team-id>` 与授权 team 一致。
+
 ## 账号上下文
 
 ```bash
-social-hub context account -t "$T" --account A1 \
+social-hub context account -t <team-id> --account A1 \
   --expand pools,jobs,persona,risk,env,guardrails
 ```
 
@@ -22,24 +25,24 @@ social-hub context account -t "$T" --account A1 \
 ## 任务上下文
 
 ```bash
-social-hub context job -t "$T" --job "<scheduledJobId>"
+social-hub context job -t <team-id> --job <scheduledJobId>
 ```
 
 ## 板块与候选
 
 ```bash
-social-hub query account-pools -t "$T" --account A1 --limit 50
-social-hub query subreddit-candidates -t "$T" --account A1 --action publish_post
+social-hub query account-pools -t <team-id> --account A1 --limit 50
+social-hub query subreddit-candidates -t <team-id> --account A1 --action publish_post
 ```
 
-## 导出（给人看或离线审计）
+## 导出（审计 / 离线查看）
 
 ```bash
-social-hub export agent-context -t "$T" --account "<uuid>" -o /tmp/ctx.json
+social-hub export agent-context -t <team-id> --account <uuid> -o /tmp/ctx.json
 ```
 
 ## freshness
 
-响应中的 `freshness.needsRefresh === true` 时，应先刷新账号指标或情报，再执行发帖/评论。
+响应中 `freshness.needsRefresh === true` 时，应先刷新账号指标或情报，再执行发帖/评论。
 
 执行任务前配合 `social-hub-ops-runtime`；执行后 `ops complete` 回填 permalink。