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

package/skills/social-hub-style-curator/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: social-hub-style-curator
+description: >-
+  Hub 账号风格沉淀：style-marks list/approve/reject/extract/set 与 curator run、
+  accounts style-guide get。用户要提取高赞评论风格、审核 style mark、批量 curator 写回风格资产时用本 skill。
+  不负责 Reddit 帖快照 CRUD（见 social-hub-posts）。
+metadata:
+  cliVersion: ">=0.1.4"
+---
+
+# social-hub-style-curator
+
+> **前置条件：** 先阅读 [`../social-hub-shared/SKILL.md`](../social-hub-shared/SKILL.md)，
+> 确认已 `auth login` 并 `context use <team-id>`。
+
+## 职责边界
+
+| 做                                        | 不做                                        |
+| ----------------------------------------- | ------------------------------------------- |
+| `style-marks` CRUD / 按 event 幂等 upsert | `reddit list` / `batch-upsert` / 帖表现刷新 |
+| `curator run` 批量沉淀到 Hub style-guide  | 从飞书/本地 JSON 直接当 SSOT 主写           |
+
+## 列出与审核
+
+`style-marks list` 当前按 `socialAccountId` 过滤，`--account` 必须传 **账号 UUID**。如果手里只有 OpenClaw 槽位/handle，先用 `context account` 解析：
+
+```bash
+social-hub context account -t <team-id> --account <slot-or-handle>
+# 取响应 account.id，作为下方 <account-uuid>
+```
+
+```bash
+social-hub style-marks list -t <team-id> --account <account-uuid> \
+  --extract-status pending --approved true -n 50
+
+social-hub style-marks approve -t <team-id> --id <styleMarkId> [--note "..."]
+social-hub style-marks reject -t <team-id> --id <styleMarkId> [--note "..."]
+social-hub style-marks extract -t <team-id> --id <styleMarkId> [--dry-run]
+```
+
+## 按 event 幂等写入 mark
+
+```bash
+social-hub style-marks set -t <team-id> --event-ref <externalRef> -j '{
+  "styleTags": ["concise", "helpful"],
+  "markExternalRef": "mk_evt_001",
+  "onConflict": "update"
+}'
+```
+
+`--event-ref` 对齐 OpenClaw `event_id` / Hub `externalRef`。
+
+## Curator 批量沉淀
+
+```bash
+social-hub curator run -t <team-id> --account <slot-or-uuid> [--dry-run]
+social-hub accounts style-guide get -t <team-id> --account <slot-or-uuid>
+```
+
+成功后 Hub 将对应 marks 的 `extractStatus` 置为 `extracted`（幂等：`markExternalRef`）。
+
+## 离线回退
+
+`doctor` 失败时：只读/写本地 `interaction-history.json` 的 `style_marks[]` 与 `account-style-guides/*.md`，回执标注 `[hub-offline-fallback]`。Hub 在线时禁止对同一 mark 双主写。
+
+## 与维护 CRON 的关系
+
+`reddit-post-reply-maintenance` Step 4.5–4.6 在 metrics 达标后调用本 skill；互动 CRON 不负责写 style marks。

package/skills/social-hub-subreddit-pools/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: social-hub-subreddit-pools
+description: >-
+  Social Hub 运营板块池：catalog、pool aliases、tier rules 的 CRUD 与列表。
+  用户要管理 industryKey/subreddit 目录、persona_pools.* alias、S0–S3 准入规则，
+  或提到 social-hub pools、subreddit-pools API 时使用。不用于 watchlists、热帖、
+  insights 抓取（用 social-hub-intelligence）或 Agent 选板（用 social-hub-openclaw-context）。
+---
+
+# social-hub-subreddit-pools
+
+先读 `social-hub-shared` 完成 `auth login` 与 `context use`。
+
+## 命令组
+
+```bash
+social-hub pools catalog-list -t <team-id> [--pool-kind pet|common|industry|brand|other]
+social-hub pools catalog-create -t <team-id> -j '{"industryKey":"...","industryLabel":"...","subreddit":"..."}'
+social-hub pools catalog-update -t <team-id> --id <pool-id> -j '{...}'
+social-hub pools catalog-delete -t <team-id> --id <pool-id>
+
+social-hub pools aliases-list -t <team-id> [--alias-ref persona_pools.P23.starter]
+social-hub pools aliases-create -t <team-id> -j '{"aliasRef":"persona_pools.P23.starter","industryKey":"common_pools__starter_casual"}'
+social-hub pools aliases-update -t <team-id> --id <alias-id> -j '{...}'
+social-hub pools aliases-delete -t <team-id> --id <alias-id>
+
+social-hub pools tier-rules-list -t <team-id>
+social-hub pools tier-rules-create -t <team-id> -j '{...}'
+social-hub pools tier-rules-update -t <team-id> --id <rule-id> -j '{...}'
+social-hub pools tier-rules-delete -t <team-id> --id <rule-id>
+```
+
+## API
+
+- `GET/POST/PATCH/DELETE /v1/teams/:teamId/subreddit-pools/catalog`
+- `GET/POST/PATCH/DELETE /v1/teams/:teamId/subreddit-pools/aliases`
+- `GET/POST/PATCH/DELETE /v1/teams/:teamId/subreddit-pools/tier-rules`
+
+权限资源：`subredditPool`（与 `subredditIntelligence` 分析只读分离）。
+
+兼容：旧 `subreddit-intelligence/industry-pools` 仍可读；新写操作优先走 `subreddit-pools/*`。