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

package/dist/register-ops.js

@@ -120,12 +120,18 @@ export function registerAgentContext(program) {
         .requiredOption("--account <ref>", "账号 UUID 或 handle")
         .option("--industry <key>", "行业 key")
         .option("--limit <n>", "条数", "50")
+        .option("--persona-aware <bool>", "按系统人设解析候选池", "true")
+        .option("--tier <tier>", "starter|advanced|all", "all")
+        .option("--include-debug", "输出 personaPools / fallback")
         .action(async (opts) => {
         await withCliErrorBoundary(async () => {
             const teamId = resolveTeamId(opts.team);
             const res = await requireClient().listAccountPools(teamId, opts.account, {
                 industry: opts.industry,
                 limit: Number(opts.limit),
+                personaAware: opts.personaAware !== "false",
+                tier: opts.tier,
+                includeDebug: Boolean(opts.includeDebug),
             });
             printResult(res);
         });
@@ -137,6 +143,9 @@ export function registerAgentContext(program) {
         .option("--industry <key>", "行业 key")
         .option("--action <action>", "动作类型")
         .option("--limit <n>", "条数", "30")
+        .option("--persona-aware <bool>", "按系统人设解析候选池", "true")
+        .option("--tier <tier>", "starter|advanced|all", "all")
+        .option("--include-debug", "输出 personaPools / diversity / fallback", true)
         .action(async (opts) => {
         await withCliErrorBoundary(async () => {
             const teamId = resolveTeamId(opts.team);
@@ -144,6 +153,9 @@ export function registerAgentContext(program) {
                 industry: opts.industry,
                 action: opts.action,
                 limit: Number(opts.limit),
+                personaAware: opts.personaAware !== "false",
+                tier: opts.tier,
+                includeDebug: opts.includeDebug !== false,
             });
             printResult(res);
         });

package/dist/register-ops.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-ops.js","sourceRoot":"","sources":["../src/register-ops.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"register-ops.js","sourceRoot":"","sources":["../src/register-ops.ts"],"names":[],"mappings":"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"}

package/dist/update-check.d.ts

@@ -1,3 +1,8 @@
+export declare const PACKAGE_NAME = "@geoly-ai/social-hub-cli";
+export declare function shouldSkipUpdateCheck(argv: string[]): boolean;
 export declare function isNewerVersion(latest: string, current: string): boolean;
+export declare function formatUpgradeCommand(latest: string): string;
+/** Human + agent-facing lines when registry latest > installed CLI. */
+export declare function formatUpdateNoticeLines(current: string, latest: string): string[];
 export declare function maybeNotifyUpdate(argv?: string[]): Promise<void>;
 //# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AA+BA,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAavE;AA8DD,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBpF"}
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,YAAY,6BAA6B,CAAC;AAYvD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAW7D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAavE;AA+CD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUjF;AAMD,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBpF"}

package/dist/update-check.js

@@ -3,13 +3,13 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { isRunningViaNpx } from "./skills/paths.js";
 import { getCliVersion } from "./version-info.js";
-const PACKAGE_NAME = "@geoly-ai/social-hub-cli";
+export const PACKAGE_NAME = "@geoly-ai/social-hub-cli";
 const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME.replace("/", "%2F")}/latest`;
 const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
 const FETCH_TIMEOUT_MS = 2_000;
 const CACHE_DIR = join(homedir(), ".config", "geoly");
 const CACHE_FILE = join(CACHE_DIR, "social-hub-update-check.json");
-function shouldSkipUpdateCheck(argv) {
+export function shouldSkipUpdateCheck(argv) {
     if (process.env["SOCIAL_HUB_NO_UPDATE_CHECK"] === "1")
         return true;
     if (process.env["CI"] === "true" || process.env["CI"] === "1")
@@ -81,17 +81,25 @@ async function fetchLatestVersion() {
         clearTimeout(timer);
     }
 }
-function printUpdateNotice(current, latest) {
-    const upgradeLine = isRunningViaNpx()
-        ? `Run npx ${PACKAGE_NAME}@${latest} … to upgrade`
-        : `Run npm update -g ${PACKAGE_NAME} to upgrade`;
-    process.stderr.write([
+export function formatUpgradeCommand(latest) {
+    return isRunningViaNpx()
+        ? `npx ${PACKAGE_NAME}@${latest}`
+        : `npm install -g ${PACKAGE_NAME}@${latest}`;
+}
+/** Human + agent-facing lines when registry latest > installed CLI. */
+export function formatUpdateNoticeLines(current, latest) {
+    const upgradeCmd = formatUpgradeCommand(latest);
+    return [
         "",
-        `Update available ${current} → ${latest}`,
-        upgradeLine,
-        `After upgrading CLI, run: social-hub skills update --yes`,
+        `[social-hub] Update available: ${current} → ${latest}`,
+        `[social-hub] Upgrade CLI: ${upgradeCmd}`,
+        "[social-hub] Then refresh skills: social-hub skills update --yes",
+        "[social-hub] Agent: tell the user a newer CLI is available; run the commands above before relying on new flags or skill docs.",
         "",
-    ].join("\n"));
+    ];
+}
+function printUpdateNotice(current, latest) {
+    process.stderr.write(formatUpdateNoticeLines(current, latest).join("\n"));
 }
 export async function maybeNotifyUpdate(argv = process.argv) {
     if (shouldSkipUpdateCheck(argv))

package/dist/update-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"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"}

package/dist/update-check.test.js

@@ -1,5 +1,47 @@
 import { describe, expect, it } from "vitest";
-import { isNewerVersion } from "./update-check.js";
+import { formatUpdateNoticeLines, formatUpgradeCommand, isNewerVersion, shouldSkipUpdateCheck, } from "./update-check.js";
+describe("shouldSkipUpdateCheck", () => {
+    it("skips when env SOCIAL_HUB_NO_UPDATE_CHECK=1", () => {
+        const prev = process.env["SOCIAL_HUB_NO_UPDATE_CHECK"];
+        process.env["SOCIAL_HUB_NO_UPDATE_CHECK"] = "1";
+        try {
+            expect(shouldSkipUpdateCheck(["node", "cli", "doctor"])).toBe(true);
+        }
+        finally {
+            if (prev === undefined)
+                delete process.env["SOCIAL_HUB_NO_UPDATE_CHECK"];
+            else
+                process.env["SOCIAL_HUB_NO_UPDATE_CHECK"] = prev;
+        }
+    });
+    it("skips version and help subcommands", () => {
+        expect(shouldSkipUpdateCheck(["node", "cli", "version"])).toBe(true);
+        expect(shouldSkipUpdateCheck(["node", "cli", "--version"])).toBe(true);
+        expect(shouldSkipUpdateCheck(["node", "cli", "help", "doctor"])).toBe(true);
+    });
+    it("skips when --no-update-check is present", () => {
+        expect(shouldSkipUpdateCheck(["node", "cli", "--no-update-check", "doctor"])).toBe(true);
+        expect(shouldSkipUpdateCheck(["node", "cli", "doctor", "--no-update-check"])).toBe(true);
+    });
+    it("runs check for normal commands", () => {
+        expect(shouldSkipUpdateCheck(["node", "cli", "doctor"])).toBe(false);
+        expect(shouldSkipUpdateCheck(["node", "cli", "health"])).toBe(false);
+    });
+});
+describe("formatUpdateNoticeLines", () => {
+    it("includes upgrade and skills refresh hints", () => {
+        const lines = formatUpdateNoticeLines("0.1.4", "0.1.5");
+        expect(lines.join("\n")).toContain("0.1.4 → 0.1.5");
+        expect(lines.join("\n")).toContain("social-hub skills update --yes");
+        expect(lines.join("\n")).toMatch(/Agent:/);
+    });
+});
+describe("formatUpgradeCommand", () => {
+    it("returns npm global install by default", () => {
+        expect(formatUpgradeCommand("0.2.0")).toContain("npm install -g");
+        expect(formatUpgradeCommand("0.2.0")).toContain("@0.2.0");
+    });
+});
 describe("isNewerVersion", () => {
     it("detects patch bump", () => {
         expect(isNewerVersion("0.0.2", "0.0.1")).toBe(true);

package/dist/update-check.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.test.js","sourceRoot":"","sources":["../src/update-check.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"update-check.test.js","sourceRoot":"","sources":["../src/update-check.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geoly-ai/social-hub-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "description": "social-hub CLI for Social Ops Hub",
   "repository": {
@@ -22,7 +22,7 @@
   "dependencies": {
     "commander": "^12.1.0",
     "@geoly-ai/social-hub-authz": "0.0.3",
-    "@geoly-ai/social-hub-sdk": "0.0.12"
+    "@geoly-ai/social-hub-sdk": "0.0.13"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",

package/skills/manifest.json

@@ -1,7 +1,7 @@
 {
   "version": 1,
   "package": "social-ops-hub",
-  "cliVersion": "0.1.3",
+  "cliVersion": "0.1.5",
   "repository": "social-ops-hub",
   "publish": {
     "registry": "https://skill.sh",

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

@@ -111,7 +111,8 @@ Web 控制台：**人设库** 导航项（`#personas`），需 `systemPersona.li
 
 ```bash
 social-hub api-keys list -t <team-id>
-social-hub api-keys create -t <team-id> -j '{"name":"integration","role":"manager"}' --apply
+social-hub api-keys create -t <team-id> -j '{"name":"client-scope","role":"client","visibleBrandIds":["<brand-uuid>"]}' --apply
+# legacy：visibleCampaignIds 仍支持，新 client scope 优先 visibleBrandIds
 social-hub api-keys delete -t <team-id> --key <uuid> --apply
 social-hub api-keys rotate -t <team-id> --key <uuid> --apply
 social-hub api-keys batch-revoke -t <team-id> -j '{"apiKeyIds":["uuid1"]}' --apply
@@ -123,3 +124,5 @@ social-hub permissions-update -t <team-id> -j '{...}'
 
 - **API Key**：集成/服务端密钥管理；Agent 日常仍用 Device Code（见 `social-hub-shared`）
 - admin 写操作建议先 `--dry-run` 再 `--apply`
+- `api-keys delete` / `batch-revoke` / `batch-rotate`：**必须** `--apply`；先 `list` 核对 key id
+- `members remove` / `invites revoke`：破坏性，先确认 user/email

package/skills/social-hub-calendar-jobs/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: social-hub-calendar-jobs
 description: >-
-  发布日历与调度任务：social-hub calendar list/patch/list-full、jobs list/create/batch/
-  summary/retry/cancel/list-full。用户要排期、查 scheduled job、重试失败任务、取消任务时用本 skill；
-  Agent 执行态回填优先 ops-runtime。
+  发布日历条目与调度任务：calendar list/patch/list-full、jobs list/create/batch/retry/cancel。
+  用户要查/改日历条目、管理 scheduled job、重试或取消任务时用本 skill。不用于创建草稿/计划
+  （social-hub-publishing）或 ops claim/complete（social-hub-ops-runtime）。
 metadata:
   cliVersion: ">=0.0.12"
 ---
@@ -16,7 +16,7 @@ metadata:
 ## 日历
 
 ```bash
-social-hub calendar list -t <team-id> [--status scheduled]
+social-hub calendar list -t <team-id> [--brand <brand-uuid>] [--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":"..."}'
 ```

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

@@ -6,7 +6,7 @@ description: >-
   openclaw、调度任务、互动事件，或要在 Hub 里查/改运营数据，就应使用本 skill 做路由。
   执行任何命令前必须先读 social-hub-shared 完成 auth login 与 context。
 metadata:
-  cliVersion: ">=0.0.12"
+  cliVersion: ">=0.1.4"
   homepage: https://github.com/geoly-ai/geoly-reddit/tree/main/social-ops-hub/skills
 ---
 
@@ -47,6 +47,12 @@ social-hub version --json
 
 命中上表场景时，**打开对应领域 skill**；不要在总路由里重复展开领域命令细节。
 
+## CLI 新版本提醒
+
+运行任意子命令时（`version`/`help` 除外），CLI 会检测 npm 上的最新版并在 stderr 提示升级；**Agent 应转告用户** 并执行 `social-hub skills update --yes`。详见 `social-hub-shared` 的「CLI 新版本检测」。
+
+跳过：`SOCIAL_HUB_NO_UPDATE_CHECK=1` 或根级 `--no-update-check`。
+
 ## 安装 CLI 与 Skill
 
 ```bash

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

@@ -5,19 +5,31 @@
       "id": 0,
       "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": []
+      "assertions": [
+        { "type": "must_include", "value": "social-hub-shared" },
+        { "type": "must_include", "value": "auth login" },
+        { "type": "forbidden_pattern", "value": "SOCIAL_HUB_API_KEY" },
+        { "type": "forbidden_pattern", "value": "campaigns create" }
+      ]
     },
     {
       "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": "路由 social-hub-ops-runtime 或 social-hub-events-observability + social-hub-calendar-jobs；不要求 SOCIAL_HUB_API_KEY",
-      "assertions": []
+      "assertions": [
+        { "type": "must_include_any", "values": ["social-hub-ops-runtime", "ops complete"] },
+        { "type": "forbidden_pattern", "value": "SOCIAL_HUB_API_KEY" }
+      ]
     },
     {
       "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",
-      "assertions": []
+      "assertions": [
+        { "type": "must_include", "value": "social-hub-intelligence" },
+        { "type": "must_include", "value": "dispatch" },
+        { "type": "forbidden_pattern", "value": "campaigns create" }
+      ]
     }
   ]
 }

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

@@ -1,8 +1,9 @@
 ---
 name: social-hub-events-observability
 description: >-
-  互动事件与可观测性：social-hub events append/list/batch/export-csv、dashboard summary、
-  audit list、reports list/create/ingest。用户要记事件、查运营总览、审计日志或报告库时用本 skill。
+  互动事件与可观测性：events append/list/export、dashboard summary、audit、reports。
+  用户要记事件、查运营总览、审计或报告库时用本 skill。不用于草稿/计划创建（social-hub-publishing）
+  或 OpenClaw 任务 claim（social-hub-ops-runtime）。
 metadata:
   cliVersion: ">=0.0.12"
 ---
@@ -22,15 +23,28 @@ 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":{}}]}'
 social-hub events export-csv -t <team-id> [--account <uuid>] [--type <eventType>] [-n 500]
-social-hub events import-openclaw-history -t <team-id> -j '{"mode":"dry-run","sourceRoot":"..."}'
 ```
 
+### OpenClaw 历史导入（注意参数）
+
+```bash
+# 先 dry-run 预览，再正式导入
+social-hub events import-openclaw-history -t <team-id> -f /path/to/history.jsonl --dry-run
+social-hub events import-openclaw-history -t <team-id> -f /path/to/history.jsonl
+# 可选：--no-auto-mark  跳过自动标记
+```
+
+**不要**使用 `-j` 传文件路径；文件路径用 **`-f <path>`**。
+
 ## 运营总览
 
 ```bash
 social-hub dashboard summary -t <team-id>
+social-hub dashboard summary -t <team-id> --brand <brand-uuid>
 ```
 
+`--campaign` 为 legacy 筛选；新流程用 `--brand`。
+
 ## 审计日志
 
 ```bash
@@ -45,10 +59,16 @@ social-hub reports create -t <team-id> -j '{"reportType":"content-weekly","title
 social-hub reports ingest -t <team-id> -j '{"reportType":"content-weekly","source":"external","traceId":"..."}'
 ```
 
-离线 `content-ideas.md` / `content-ideas-weekly-report-*.md` 在线写入请用 **`reportType: "content-weekly"`**（无独立 `content-ideas` CLI）。
+## 写操作护栏
+
+| 操作 | 要求 |
+|------|------|
+| `events batch` | 先小批量或 `list` 抽样；确认 payload 结构 |
+| `events import-openclaw-history` | **必须**先 `--dry-run`；`-f` 指向可读 JSONL |
+| `reports create` | 确认 `reportType` 与 team 权限 |
 
 ## 相关 skill
 
 - 发布闭环：`social-hub-publishing`
 - 图谱追溯：`social-hub-graph-compliance`
-- 批量导出/回放：`social-hub-migration`（`export events-jsonl`、`runbook replay`）
+- 批量导出/回放：`social-hub-migration`

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

@@ -85,11 +85,13 @@ social-hub intelligence dispatch -t <team-id> -j '{
 
 ## 板块候选（Hub DB）
 
-不要猜账号可发哪些 subreddit：
+不要猜账号可发哪些 subreddit；细节见 **`social-hub-openclaw-context`**：
 
 ```bash
-social-hub query account-pools -t <team-id> --account <ref>
-social-hub query subreddit-candidates -t <team-id> --account <ref> --action publish_post
+social-hub query account-pools -t <team-id> --account <ref> \
+  --persona-aware true --tier all
+social-hub query subreddit-candidates -t <team-id> --account <ref> \
+  --action comment --include-debug
 ```
 
 WebSocket `runs/ws` 为 watch 能力，不适合普通 CLI 批处理。

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

@@ -2,10 +2,11 @@
 name: social-hub-openclaw-context
 description: >-
   OpenClaw Agent 执行前上下文：social-hub context account/job、query account-pools、
-  subreddit-candidates、export agent-context。用户问账号能发哪些版、任务上下文、板块池、
-  guardrails、数据是否过期时，必须用 Hub DB 聚合接口，不要解析 agent 工作区 Markdown。
+  subreddit-candidates（persona-aware、diversity、selectionWeight）、export agent-context。
+  用户问账号能发哪些版、任务上下文、板块池、养号轮换、guardrails、数据是否过期时，
+  必须用 Hub DB 聚合接口，不要解析 agent 工作区 Markdown。
 metadata:
-  cliVersion: ">=0.0.12"
+  cliVersion: ">=0.1.4"
 ---
 
 # social-hub-openclaw-context
@@ -29,7 +30,9 @@ social-hub context account -t <team-id> --account A1 \
   --expand pools,events,jobs,persona,risk,env,guardrails,style,quota
 ```
 
-`--expand pools` 返回 team 级板块池；`--expand events` 返回该账号最近 20 条互动事件摘要。
+- `--expand pools`：persona-aware 板块池（含 `personaPools.expandedByKind` / `expandedPools` / `brandPools` / `fallback`）
+- `--expand persona`：账号绑定系统人设摘要
+- `--expand events`：该账号最近 20 条互动事件摘要
 
 ## 任务上下文
 
@@ -37,13 +40,56 @@ social-hub context account -t <team-id> --account A1 \
 social-hub context job -t <team-id> --job <scheduledJobId>
 ```
 
-## 板块与候选
+## 板块与候选（persona-aware + diversity）
+
+互动选板 **主读** `subreddit-candidates`；发布前查池可用 `account-pools`。
 
 ```bash
-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
+# 账号级池列表（可选 debug）
+social-hub query account-pools -t <team-id> --account A1 \
+  --limit 50 --persona-aware true --tier all --include-debug
+
+# 互动/评论候选（默认带 diversity debug）
+social-hub query subreddit-candidates -t <team-id> --account A1 \
+  --action comment --include-debug
+
+# 浏览动作更宽松
+social-hub query subreddit-candidates -t <team-id> --account A1 --action browse
 ```
 
+| 参数 | 默认 | 说明 |
+|------|------|------|
+| `--persona-aware` | `true` | `false` 时仅 team 级 `subreddit_industry_pools` |
+| `--tier` | `all` | `starter` / `advanced` / `all` |
+| `--include-debug` | `subreddit-candidates` 默认开启 | 输出 `personaPools`、`fallback`、`selectionWeight`、`cooldownUntil` 等 |
+| `--action` | 无 | `comment` / `browse` / `publish_post` 等，影响 `allowedActions` 与冷却 |
+
+**响应要点**（`subreddit-candidates`）：
+
+| 字段 | 说明 |
+|------|------|
+| `items[].source` | `persona.redditRefs`、`persona.starterPoolRefs`、`persona.petPoolRefs`、`brand.binding`、`fallback_team_pool` 等 |
+| `items[].poolKind` | `pet` / `common` / `industry` / `brand` / `direct` / `other` |
+| `items[].subreddit` | 可直接消费的 `r/Subreddit` 格式 |
+| `items[].selectionWeight` | 加权随机用；**禁止直接取 `items[0]`** |
+| `items[].cooldownUntil` | 未过期时禁止 `comment`/`reply` |
+| `items[].allowedActions` | 当前动作允许的操作 |
+| `personaPools.expandedByKind` | 按来源汇总：`direct` / `common` / `industry` / `pet` / `brand` 的 `r/...` 列表 |
+| `personaPools.expandedPools[].subreddits` | 每个 pool ref 展开后的具体板块（可多条） |
+| `personaPools.brandPools` | 账号品牌绑定及对应 `brand_pools.*` ref 展开结果 |
+| `personaPools.unresolvedRefs` | alias 表无法解析的 ref（含部分 `persona_pools.Pxx.*`） |
+| `fallback.reason` | 如 `candidate_pool_exhausted` 须在 Agent 回执说明 |
+
+**Agent 门禁**：
+
+1. Hub 在线时不要本地展开 `persona_pools.Pxx`；以 Hub 返回的 `source` / `tier` / `poolKind` 为准。
+2. 选板前先读 `personaPools.expandedByKind`，确认 `direct` / `common` / `industry` / `pet` / `brand` 是否都有候选；缺类时看 `unresolvedRefs` 与 `fallback.reason`。
+3. 同任务维护 `usedSubreddits`，排除已选 sub。
+4. 养号阶段 `poolKind=pet` 且可用宠物 sub **≥3** 时须轮换；**不得**用 `brand` 池替代宠物主池。
+5. 运营期品牌池（`poolKind=brand` / `source=brand.binding`）仅低占比补充（建议 10%–20%）。
+
+配合 `social-hub-events-observability` 的 `events list-full` 可核对近期 sub；`social-hub-graph-compliance` 的 blocklist 已由候选接口过滤。
+
 ## 导出（审计 / 离线查看）
 
 ```bash

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

@@ -45,3 +45,13 @@ 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`）。
+
+## 写操作护栏
+
+| 命令 | 要求 |
+|------|------|
+| `ops complete` | `permalink` 须为 reddit.com URL；先 `claim` 或 `claim-next` |
+| `ops fail` / `ops skip` | `--reason` 必须用文档枚举值 |
+| `ops claim` | 确认 `jobId` 来自 `jobs list`，勿猜测 UUID |
+
+无 `--dry-run`；误操作后用 `fail`/`skip` 记录原因，勿改本地 Markdown 状态。

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

@@ -33,6 +33,7 @@ metadata:
 
 ```bash
 social-hub reddit list -t <team-id> -n 20
+social-hub reddit list-full -t <team-id> --brand <brand-uuid> -n 50
 social-hub reddit list -t <team-id> --aggregate --all
 social-hub reddit stats -t <team-id> --aggregate --range 30
 social-hub reddit stats -t <team-id> --aggregate --range all
@@ -41,8 +42,11 @@ social-hub reddit refresh-status -t <team-id>
 social-hub reddit refresh -t <team-id> --snapshot <snapshotId>
 social-hub reddit refresh-progress -t <team-id> --batch <batchId>
 social-hub reddit refresh-all -t <team-id>
+social-hub reddit refresh-logs -t <team-id> -n 20
 ```
 
+筛选帖表现时优先 **`--brand`**，勿把 `--campaign` 当作品牌 ID。
+
 ## 单条写入与更新
 
 ```bash

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

@@ -3,21 +3,13 @@
   "evals": [
     {
       "id": 0,
-      "prompt": "查 team <team-id> 最近 20 条 Reddit 帖快照，并按系统级 brand <brand-id> 看 stats 汇总。我已 auth login。",
-      "expected_output": "social-hub reddit list、reddit stats；不路由到飞书同步或 lark-cli",
-      "assertions": []
-    },
-    {
-      "id": 1,
-      "prompt": "我有一批外部 JSON 帖数据（含 permalink、subreddit、score、feishuRecordId recABC），要批量写入 Hub team <team-id>，先 dry-run 再 apply。",
-      "expected_output": "social-hub reddit batch-upsert --dry-run 然后正式 upsert；说明 feishuRecordId 幂等；不展开飞书取数流程",
-      "assertions": []
-    },
-    {
-      "id": 2,
-      "prompt": "刷新 team <team-id> 全部 Reddit 帖 score，并查看 refresh 任务进度。",
-      "expected_output": "social-hub reddit refresh-all、reddit refresh-status 或 refresh-progress",
-      "assertions": []
+      "prompt": "查我们品牌在 Hub 里最近 30 天 Reddit 帖表现，按品牌筛选，不要走 campaign。",
+      "expected_output": "social-hub-posts：reddit stats --brand 或 list --brand；勿 campaigns list",
+      "assertions": [
+        { "type": "must_include", "value": "--brand" },
+        { "type": "forbidden_pattern", "value": "campaigns create" },
+        { "type": "forbidden_pattern", "value": "--campaign" }
+      ]
     }
   ]
 }