@geoly-ai/social-hub-cli 0.0.12 → 0.0.14

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

@@ -1,12 +1,12 @@
 ---
 name: social-hub-cli
 description: >-
-  Social Ops Hub 命令行 social-hub：账号、事件、日历、调度任务、Reddit 帖、报告、OpenClaw 回填等。
-  只要用户提到 social-hub、Social Ops Hub、Hub 写数据、查账号、发帖计划、permalink 回填、openclaw、
-  调度任务、互动事件，或要在 Hub 里查/改运营数据，就应使用本 skill（即使用户没说 CLI）。
-  先读本 skill 做路由；执行任何命令前必须先读 social-hub-shared 完成 auth login 与 context。
+  Social Ops Hub 命令行总路由：social-hub 安装、健康检查、领域 skill 索引。
+  只要用户提到 social-hub、Social Ops Hub、Hub 写数据、查账号、发帖计划、permalink 回填、
+  openclaw、调度任务、互动事件，或要在 Hub 里查/改运营数据，就应使用本 skill 做路由。
+  执行任何命令前必须先读 social-hub-shared 完成 auth login 与 context。
 metadata:
-  cliVersion: ">=0.0.6"
+  cliVersion: ">=0.0.12"
   homepage: https://github.com/geoly-ai/geoly-reddit/tree/main/social-ops-hub/skills
 ---
 
@@ -16,9 +16,8 @@ metadata:
 
 > **前置条件：** 执行 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` 环境变量。
 
-## 快速开始（生产）
+## 快速开始
 
 ```bash
 social-hub auth login --api-url https://reddit.eclick-geo.com/api
@@ -26,212 +25,57 @@ social-hub auth whoami
 social-hub context use <team-uuid>
 social-hub doctor
 social-hub health
+social-hub version --json
 ```
 
-生产 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 --agent cursor --global --yes`
-- **检查状态**：`social-hub skills doctor`
-
 ## 领域 Skill 路由
 
 | 场景 | Skill |
 |------|--------|
-| 鉴权 / config / doctor / context | **`social-hub-shared`**（必读） |
+| 鉴权 / config / doctor / context list·use·current | **`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` |
-| 情报 | `social-hub-intelligence` |
-| 导入导出 replay | `social-hub-migration` |
+| 社交账号 CRUD / browser-envs / personas | `social-hub-accounts` |
+| Reddit 帖快照 CRUD / batch-upsert | `social-hub-posts` |
+| 日历 / scheduled jobs | `social-hub-calendar-jobs` |
+| 发布闭环（brand→report） | `social-hub-publishing` |
+| 事件 / dashboard / audit / reports | `social-hub-events-observability` |
+| 图谱 / 合规 / 风控 | `social-hub-graph-compliance` |
+| settings / invites / members / api-keys | `social-hub-admin` |
+| 板块情报 / KOL / insights | `social-hub-intelligence` |
+| 导入导出 / runbook / openclaw-ingest | `social-hub-migration` |
+
+命中上表场景时，**打开对应领域 skill**；不要在总路由里重复展开领域命令细节。
 
-命中上表场景时，打开对应领域 skill，**不要**只在总览里硬写命令而跳过子 skill。
+## 安装 CLI 与 Skill
 
-## 同仓开发 Build
+```bash
+npm install -g @geoly-ai/social-hub-cli@latest
+social-hub skills install --agent cursor --global --yes
+social-hub skills update --agent cursor --global --yes
+social-hub skills doctor
+```
 
-在 **social-ops-hub  monorepo** 内改 CLI/SDK 后：
+## 同仓开发 Build
 
 ```bash
 pnpm --filter @geoly-ai/social-hub-sdk run build
 pnpm --filter @geoly-ai/social-hub-cli run build
+pnpm --filter @geoly-ai/social-hub-cli test
 ```
 
-## 本地 API 冷启动（仅开发）
-
-部署/seed 细节见仓库文档；CLI 侧只需改 API 地址并重新 login：
+## 本地 API（仅开发）
 
 ```bash
-cp .env.example .env   # 填写 DATABASE_URL、REDIS_URL 等
-pnpm run db:migrate
-SOCIAL_OPS_SEED_MODE=minimal-admin pnpm run db:seed
-pnpm dev
 social-hub auth login --api-url http://localhost:3000
-social-hub context use <seed 输出的 team uuid>
-social-hub health
-```
-
-创建新 team、用户等业务初始化：在 **已 auth login 且 role 足够** 的前提下执行下方「团队与用户管理」命令；**不要**再 export API Key。
-
-### 业务数据初始化示例
-
-```bash
-# 创建品牌 → 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 <team-id>
-```
-
-### 互动事件
-
-```bash
-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 <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 <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>
+social-hub context use <seed-team-uuid>
 ```
 
-OpenClaw 执行态优先 `social-hub ops *`（见 `social-hub-ops-runtime`）；`jobs agent-status` 为遗留路径。
-
-### 发布计划 / 草稿 / 报告
-
-```bash
-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
-
-```bash
-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 <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 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 <team-id>
-social-hub notification-channels create -t <team-id> -j '{"provider":"feishu","externalId":"https://..."}'
-```
-
-### API Key 管理（管理员资源，非 CLI 登录方式）
-
-```bash
-social-hub api-keys list -t <team-id>
-social-hub api-keys create -t <team-id> -j '{"name":"integration","role":"manager"}'
-```
-
----
-
-## 典型工作流
-
-### Agent 执行完成后回填
-
-优先 `social-hub ops complete --permalink ...`（见 `social-hub-ops-runtime`）。手动 patch 示例：
-
-```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>"}'
-```
-
-### 查看账号运营数据
-
-```bash
-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>
-```
-
-### 情报热帖派发
-
-```bash
-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
-```
-
----
+业务初始化（创建 brand/campaign/account）见 `social-hub-publishing` 与 `social-hub-admin`。
 
 ## 注意事项
 
-- 命令输出多为 **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。
+- 命令输出多为 **JSON**，可管道 `jq`
+- `events export-csv`、`intelligence hot-posts-export` 输出 CSV 到 stdout
+- CLI 凭证来自 **Device Code**，不是 Web Session Cookie，也不是日常手动创建的 API Key
+- 覆盖矩阵见仓库 `docs/cli-api-coverage.md`

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

@@ -3,20 +3,20 @@
   "evals": [
     {
       "id": 0,
-      "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",
+      "prompt": "我要连生产 Social Ops Hub（https://reddit.eclick-geo.com/api），用 social-hub 登录并确认当前身份和 team，然后在 Hub 里注册一个新团队 my-ops-team（slug 也是 my-ops-team），给这个团队添加管理员用户 ops@example.com，最后确认团队列表里有 my-ops-team。不要用 SOCIAL_HUB_API_KEY 环境变量。",
+      "expected_output": "先读 social-hub-shared：auth login、auth whoami、context use；再读 social-hub-admin：agent-teams create、users system-create 或 agent-teams add-member、agent-teams list；全程 Device Code 凭证",
       "assertions": []
     },
     {
       "id": 1,
       "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",
+      "expected_output": "路由 social-hub-ops-runtime 或 social-hub-events-observability + social-hub-calendar-jobs；不要求 SOCIAL_HUB_API_KEY",
       "assertions": []
     },
     {
       "id": 2,
       "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",
+      "expected_output": "路由 social-hub-intelligence：hot-posts、dispatch；social-hub-calendar-jobs：jobs list",
       "assertions": []
     }
   ]

package/skills/social-hub-events-observability/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: social-hub-events-observability
+description: >-
+  互动事件与可观测性：social-hub events append/list/batch/export-csv、dashboard summary、
+  audit list、reports list/create/ingest。用户要记事件、查运营总览、审计日志或报告库时用本 skill。
+metadata:
+  cliVersion: ">=0.0.12"
+---
+
+# social-hub-events-observability
+
+> **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
+> 确认已 `auth login` 并 `context use <team-id>`。
+
+## 互动事件
+
+```bash
+social-hub events append -t <team-id> --type comment \
+  --external-ref evt_123 --account <uuid> --subreddit test --result succeeded \
+  --payload '{"schemaVersion":"v1","runId":"a4-cron-202605231030"}'
+social-hub events list -t <team-id> -n 20
+social-hub events list-full -t <team-id> --account <uuid> --type post.published -n 100
+social-hub events batch -t <team-id> -j '{"events":[{"type":"comment","externalRef":"evt_1","payload":{}}]}'
+```
+
+## 运营总览
+
+```bash
+social-hub dashboard summary -t <team-id>
+```
+
+## 审计日志
+
+```bash
+social-hub audit list -t <team-id> -n 50 [--type <prefix>] [--actor agent] [--account <uuid>]
+```
+
+## 报告库
+
+```bash
+social-hub reports list -t <team-id> -n 20
+social-hub reports create -t <team-id> -j '{"title":"Weekly","bodyMarkdown":"..."}'
+social-hub reports ingest -t <team-id> -j '{"source":"external","payload":{...}}'
+```
+
+## 相关 skill
+
+- 发布闭环：`social-hub-publishing`
+- 图谱追溯：`social-hub-graph-compliance`
+- 批量导出/回放：`social-hub-migration`（`export events-jsonl`、`runbook replay`）

package/skills/social-hub-graph-compliance/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: social-hub-graph-compliance
+description: >-
+  账号图谱与合规风控：social-hub graph list/drilldown/v2-*、compliance sanctions-*、
+  risk-*、rule-caches-*。用户要查账号关联图谱、风险簇、制裁、风控配置或 subreddit
+  规则缓存时用本 skill。
+metadata:
+  cliVersion: ">=0.0.12"
+---
+
+# social-hub-graph-compliance
+
+> **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
+> 确认已 `auth login` 并 `context use <team-id>`。
+
+## 账号图谱（v1）
+
+```bash
+social-hub graph list -t <team-id> [--account <uuid>] [--edge <type>] -n 100
+social-hub graph drilldown -t <team-id> --account <uuid> -n 20
+```
+
+## 账号图谱（v2）
+
+```bash
+social-hub graph v2-ego -t <team-id> --node-ref <account-uuid> --node-type account -n 100
+social-hub graph v2-timeline -t <team-id> --node-ref <account-uuid> --node-type account --from 2026-01-01T00:00:00Z
+social-hub graph v2-explain -t <team-id> --edge-id <edge-uuid>
+social-hub graph v2-path -t <team-id> --source-ref <uuid> --source-type account --target-ref <uuid> --target-type account
+social-hub graph v2-clusters -t <team-id> --scope-ref <account-uuid> --min-risk 60
+social-hub graph v2-impact -t <team-id> --campaign-ref <campaign-uuid> --min-reuse 2
+```
+
+## 合规：制裁与风控
+
+```bash
+social-hub compliance sanctions-list -t <team-id> [--account <uuid>] [--sub <name>]
+social-hub compliance sanctions-create -t <team-id> -j '{"socialAccountId":"<uuid>","subreddit":"example","status":"blocked","reason":"..."}'
+
+social-hub compliance risk-list -t <team-id> -n 100
+social-hub compliance risk-get -t <team-id> -a <account-uuid>
+social-hub compliance risk-put -t <team-id> -a <account-uuid> -j '{"riskLevel":"medium","safeHoursStart":"08:00","safeHoursEnd":"22:00"}'
+```
+
+## Subreddit 规则缓存
+
+```bash
+social-hub compliance rule-caches-list -t <team-id> [--include-expired]
+social-hub compliance rule-caches-upsert -t <team-id> --sub example -j '{
+  "rulesMarkdown": "# Rules\n...",
+  "sourceUrl": "https://www.reddit.com/r/example/about/rules",
+  "expiresInDays": 30
+}'
+```
+
+## 相关 skill
+
+- 账号详情：`social-hub-accounts`
+- 互动事件追溯：`social-hub-events-observability`
+- Agent 上下文（含 risk/guardrails）：`social-hub-openclaw-context`

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

@@ -1,26 +1,91 @@
 ---
 name: social-hub-intelligence
 description: >-
-  板块情报：watchlists、hot posts、KOL intents、industry-pools、dispatch 等 social-hub intelligence 子命令。
-  用户要盯 subreddit、拉热帖、行业池、情报派发时用本 skill。
+  板块情报：watchlists、hot-posts、kol-intents、industry-pools、tier-rules、runs、
+  kol-profiles、fetch-by-*、insights/*、dispatch 等 social-hub intelligence 子命令。
+  用户要盯 subreddit、拉热帖、行业池、情报派发、分层规则或洞察分析时用本 skill。
 metadata:
-  cliVersion: ">=0.0.6"
+  cliVersion: ">=0.0.12"
 ---
 
 # social-hub-intelligence
 
 > **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
-> 确认已 auth login 并 `context use <team-id>`。
+> 确认已 `auth login` 并 `context use <team-id>`。
+
+## Watchlists 与行业池
 
 ```bash
 social-hub intelligence industry-pools-list -t <team-id>
-social-hub intelligence watchlists-list -t <team-id>
+social-hub intelligence watchlists-list -t <team-id> [--campaign <uuid>]
+social-hub intelligence watchlists-create -t <team-id> -j '{"subreddit":"technology","tags":["core"]}'
+social-hub intelligence watchlists-update -t <team-id> --id <uuid> -j '{"tags":["updated"]}'
+social-hub intelligence watchlists-delete -t <team-id> --id <uuid>
+```
+
+## 热帖
+
+```bash
 social-hub intelligence hot-posts -t <team-id> --subreddit technology --sort score -n 50
+social-hub intelligence hot-posts-create -t <team-id> -j '{ ... }'
+social-hub intelligence hot-posts-export -t <team-id> --subreddit technology > hot-posts.csv
+```
+
+## KOL
+
+```bash
 social-hub intelligence kol-intents -t <team-id> -n 20
-social-hub intelligence dispatch -t <team-id> -j '{ ... }'   # 写操作：确认 payload 与 --apply（若命令支持）
+social-hub intelligence kol-intents-create -t <team-id> -j '{ ... }'
+social-hub intelligence kol-profiles-list -t <team-id> [--platform reddit]
+social-hub intelligence kol-profiles-get -t <team-id> --id <uuid>
 ```
 
-账号可发帖板块优先用 Hub DB 查询，不要猜 subreddit：
+## Tier rules
+
+```bash
+social-hub intelligence tier-rules-list -t <team-id> [--tier T1] [--enabled true]
+social-hub intelligence tier-rules-create -t <team-id> -j '{"subreddit":"example","tier":"T1","entryMode":"organic","enabled":true}'
+social-hub intelligence tier-rules-update -t <team-id> --id <uuid> -j '{"enabled":false}'
+social-hub intelligence tier-rules-delete -t <team-id> --id <uuid>
+```
+
+## 抓取任务（异步 run）
+
+```bash
+social-hub intelligence fetch-by-industry -t <team-id> -j '{"mode":"all","industryKeys":["tech"],"sort":"hot","limitPerSubreddit":25}'
+social-hub intelligence fetch-by-tier -t <team-id> -j '{"mode":"all","tier":"T1","sort":"hot"}'
+social-hub intelligence fetch-by-keywords -t <team-id> -j '{"mode":"all","brandKeywords":["brand"],"competitorKeywords":["rival"]}'
+social-hub intelligence runs-list -t <team-id> [--dimension industry] [--status queued]
+```
+
+## Insights
+
+```bash
+social-hub intelligence brand-mention-radar -t <team-id> -j '{"keywords":["brand"]}'
+social-hub intelligence opportunity-map -t <team-id> -j '{"keywords":["topic"]}'
+social-hub intelligence sov -t <team-id> -j '{"brandKeywords":["brand"],"competitorKeywords":["rival"]}'
+social-hub intelligence sentiment-intent -t <team-id>
+social-hub intelligence campaign-lift -t <team-id> -j '{"keywords":["brand"],"campaignStartAt":"2026-01-01T00:00:00Z","campaignEndAt":"2026-02-01T00:00:00Z"}'
+social-hub intelligence snapshot-latest -t <team-id>
+social-hub intelligence snapshot-save -t <team-id> -j '{"payload":{"note":"manual snapshot"}}'
+```
+
+## 派发到调度任务
+
+```bash
+social-hub intelligence dispatch -t <team-id> -j '{
+  "hotPostId": "<uuid>",
+  "socialAccountId": "<uuid>",
+  "action": "engage",
+  "runAt": "2026-05-07T09:00:00Z"
+}'
+```
+
+`dispatch` 无 `--dry-run`/`--apply`；确认 payload 后再执行。
+
+## 板块候选（Hub DB）
+
+不要猜账号可发哪些 subreddit：
 
 ```bash
 social-hub query account-pools -t <team-id> --account <ref>

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

@@ -2,15 +2,15 @@
 name: social-hub-migration
 description: >-
   Hub 数据批量：export events-jsonl、export agent-context、runbook replay、openclaw-ingest。
-  用户要导出 JSONL、回放事件、迁移/对账时用本 skill；不包含工作区 shared 目录批量 sync（需人工决策）。
+  用户要导出 JSONL、回放事件、迁移/对账时用本 skill；不包含 agent 工作区目录的自动批量 sync。
 metadata:
-  cliVersion: ">=0.0.6"
+  cliVersion: ">=0.0.12"
 ---
 
 # social-hub-migration
 
 > **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
-> 确认已 auth login；导出/回放目标 team 用 `-t <team-id>`。
+> 确认已 `auth login`；导出/回放目标 team 用 `-t <team-id>`。
 
 ## 导出
 
@@ -19,6 +19,8 @@ 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
 ```
 
+事件 CSV 导出见 `social-hub-events-observability`（`events export-csv`）。
+
 ## Runbook 回放
 
 ```bash
@@ -30,6 +32,17 @@ JSONL 每行：`{"type":"comment","payload":{...}}`
 
 ## openclaw-ingest
 
-API 支持将工作区文档写入 `team_workspace_documents`；**不要**在本 skill 内自动化批量 sync 整个 `Javis-workspace/shared` 或 `Moss-workspace/shared`，除非用户明确要求并指定范围。
+将 agent 工作区文档写入 `team_workspace_documents`（需用户明确范围）：
+
+```bash
+social-hub openclaw-ingest -t <team-id> -j '{"mode":"dry-run"}'
+social-hub openclaw-ingest -t <team-id> -j '{
+  "mode": "apply",
+  "sourceRoot": "/path/to/agent-workspace",
+  "sourcePaths": { "guardrails": "shared/guardrails.md" }
+}'
+```
+
+**不要**在本 skill 内自动化批量 sync 整个 agent 工作区 `shared/`，除非用户明确要求并指定路径。
 
-运行时查询请用 `social-hub-openclaw-context`，不是解析 Markdown。
+运行时查询请用 `social-hub-openclaw-context`（Hub DB 真源），不是解析 Markdown。

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

@@ -1,26 +1,35 @@
 ---
 name: social-hub-openclaw-context
 description: >-
-  OpenClaw Agent 执行前上下文：social-hub context account/job、query account-pools、subreddit-candidates、
-  export agent-context。用户问账号能发哪些版、任务上下文、板块池、guardrails、数据是否过期时，
-  必须用 Hub DB 聚合接口，不要解析 Javis/Moss/Panda 工作区里的 shared/*.md。
+  OpenClaw Agent 执行前上下文：social-hub context account/job、query account-pools、
+  subreddit-candidates、export agent-context。用户问账号能发哪些版、任务上下文、板块池、
+  guardrails、数据是否过期时，必须用 Hub DB 聚合接口，不要解析 agent 工作区 Markdown。
 metadata:
-  cliVersion: ">=0.0.6"
+  cliVersion: ">=0.0.12"
 ---
 
 # social-hub-openclaw-context
 
 > **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
-> 确认已 auth login。所有 `-t <team-id>` 与授权 team 一致。
+> 确认已 `auth login`。所有 `-t <team-id>` 与授权 team 一致。
+
+## 与 shared 的分工
+
+| 命令 | 所在 skill |
+|------|------------|
+| `context list` / `use` / `current` | `social-hub-shared` |
+| `context account` / `context job` | 本 skill |
+| `query account-pools` / `subreddit-candidates` | 本 skill |
+| `export agent-context` | 本 skill（亦见 `social-hub-migration`） |
 
 ## 账号上下文
 
 ```bash
 social-hub context account -t <team-id> --account A1 \
-  --expand pools,jobs,persona,risk,env,guardrails
+  --expand pools,events,jobs,persona,risk,env,guardrails,style,quota
 ```
 
-`--account` 可为 UUID 或 handle（如 `A1`）。
+`--expand pools` 返回 team 级板块池；`--expand events` 返回该账号最近 20 条互动事件摘要。
 
 ## 任务上下文
 
@@ -43,6 +52,12 @@ social-hub export agent-context -t <team-id> --account <uuid> -o /tmp/ctx.json
 
 ## freshness
 
-响应中 `freshness.needsRefresh === true` 时，应先刷新账号指标或情报，再执行发帖/评论。
+响应中 `freshness.needsRefresh === true` 时，应先刷新账号指标或情报，再执行发帖/评论：
+
+```bash
+social-hub accounts update -t <team-id> --account <uuid> -j '{"metricsUpdatedAt":"..."}'
+social-hub reddit refresh-all -t <team-id>
+social-hub intelligence fetch-by-industry -t <team-id> -j '{ ... }'
+```
 
 执行任务前配合 `social-hub-ops-runtime`；执行后 `ops complete` 回填 permalink。

package/skills/social-hub-ops-runtime/SKILL.md

@@ -4,25 +4,28 @@ description: >-
   OpenClaw / Agent 任务运行时：social-hub ops claim-next、claim、heartbeat、complete、fail、skip。
   用户要领任务、续租、心跳、回填 permalink、任务失败/跳过、避免改本地 Markdown 状态时必须用本 skill。
 metadata:
-  cliVersion: ">=0.0.6"
+  cliVersion: ">=0.0.12"
 ---
 
 # social-hub-ops-runtime
 
 > **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
-> 确认已 auth login 并 `context use <team-id>`。不要用环境变量传 team 或 API key。
+> 确认已 `auth login` 并 `context use <team-id>`。
 
-Hub DB 是执行状态的真源；不要用 `shared/reddit-account-status.md` 等文件记录任务结果。
+Hub DB 是执行状态的真源；不要用 agent 工作区 `shared/*.md` 记录任务结果。
 
 ## 推荐流程
 
 ```bash
-AGENT="javis"   # 或 moss / 你的 agentId
+AGENT="<agent-id>"
 
 social-hub ops claim-next -t <team-id> --agent "$AGENT"
+# 或指定 job：
+social-hub ops claim -t <team-id> --job <jobId> --agent "$AGENT"
+
 social-hub context job -t <team-id> --job <jobId>
 social-hub ops heartbeat -t <team-id> --job <jobId> --agent "$AGENT"
-# 执行 Reddit / 浏览器操作，并写 interaction events（见 social-hub-cli events）
+# 执行 Reddit / 浏览器操作，并写 interaction events（见 social-hub-events-observability）
 social-hub ops complete -t <team-id> --job <jobId> --agent "$AGENT" --permalink "https://reddit.com/..."
 ```
 
@@ -40,3 +43,5 @@ social-hub ops skip -t <team-id> --job <jobId> --agent "$AGENT" --reason manual_
 ## 并发
 
 同一账号同时只能有一个有效 lease；重复 claim 会被拒绝。`complete` 会原子更新 job 与关联 calendar（若 payload 含 calendarEntryId）。
+
+遗留路径 `jobs agent-status` 仅在未接 ops 链路时使用（见 `social-hub-calendar-jobs`）。