@geoly-ai/social-hub-cli 0.0.1 → 0.0.3

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

@@ -0,0 +1,23 @@
+{
+  "skill_name": "social-hub-cli",
+  "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 结果",
+      "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，输出每步的命令和结果",
+      "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 确认，输出各步命令和结果",
+      "assertions": []
+    }
+  ]
+}

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

@@ -0,0 +1,25 @@
+---
+name: social-hub-intelligence
+description: >-
+  板块情报：watchlists、hot posts、KOL intents、industry-pools、dispatch 等 social-hub intelligence 子命令。
+  用户要盯 subreddit、拉热帖、行业池、情报派发时用本 skill。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-intelligence
+
+```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
+```
+
+账号可发帖板块优先用：
+
+```bash
+social-hub query account-pools -t "$T" --account <ref>
+```
+
+WebSocket `runs/ws` 为 watch 能力，不适合普通 CLI 批处理。

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

@@ -0,0 +1,32 @@
+---
+name: social-hub-migration
+description: >-
+  Hub 数据批量：export events-jsonl、export agent-context、runbook replay、openclaw-ingest。
+  用户要导出 JSONL、回放事件、迁移/对账时用本 skill；不包含工作区 shared 目录批量 sync（需人工决策）。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-migration
+
+## 导出
+
+```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
+```
+
+## Runbook 回放
+
+```bash
+social-hub runbook replay -t "$T" -f events.jsonl --dry-run
+social-hub runbook replay -t "$T" -f events.jsonl          # 实际 append events
+```
+
+JSONL 每行：`{"type":"comment","payload":{...}}`
+
+## openclaw-ingest
+
+API 支持将工作区文档写入 `team_workspace_documents`；**不要**在本 skill 内自动化批量 sync 整个 `Javis-workspace/shared` 或 `Moss-workspace/shared`，除非用户明确要求并指定范围。
+
+运行时查询请用 `social-hub-openclaw-context`，不是解析 Markdown。

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

@@ -0,0 +1,45 @@
+---
+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。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-openclaw-context
+
+## 账号上下文
+
+```bash
+social-hub context account -t "$T" --account A1 \
+  --expand pools,jobs,persona,risk,env,guardrails
+```
+
+`--account` 可为 UUID 或 handle（如 `A1`）。
+
+## 任务上下文
+
+```bash
+social-hub context job -t "$T" --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
+```
+
+## 导出（给人看或离线审计）
+
+```bash
+social-hub export agent-context -t "$T" --account "<uuid>" -o /tmp/ctx.json
+```
+
+## freshness
+
+响应中的 `freshness.needsRefresh === true` 时，应先刷新账号指标或情报，再执行发帖/评论。
+
+执行任务前配合 `social-hub-ops-runtime`；执行后 `ops complete` 回填 permalink。

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

@@ -0,0 +1,40 @@
+---
+name: social-hub-ops-runtime
+description: >-
+  OpenClaw / Agent 任务运行时：social-hub ops claim-next、claim、heartbeat、complete、fail、skip。
+  用户要领任务、续租、心跳、回填 permalink、任务失败/跳过、避免改本地 Markdown 状态时必须用本 skill。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-ops-runtime
+
+Hub DB 是执行状态的真源；不要用 `shared/reddit-account-status.md` 等文件记录任务结果。
+
+## 推荐流程
+
+```bash
+export T="$SOCIAL_HUB_TEAM_ID"
+export AGENT="javis"   # 或 moss / 你的 agentId
+
+social-hub ops claim-next -t "$T" --agent "$AGENT"
+social-hub context job -t "$T" --job "<jobId>"
+social-hub ops heartbeat -t "$T" --job "<jobId>" --agent "$AGENT"
+# 执行 Reddit / 浏览器操作，并写 interaction events（见 social-hub-cli events）
+social-hub ops complete -t "$T" --job "<jobId>" --agent "$AGENT" --permalink "https://reddit.com/..."
+```
+
+失败或跳过：
+
+```bash
+social-hub ops fail -t "$T" --job "<jobId>" --agent "$AGENT" --reason rule_blocked --message "..."
+social-hub ops skip -t "$T" --job "<jobId>" --agent "$AGENT" --reason manual_intervention_required
+```
+
+## `--reason` 枚举（仅允许下列值）
+
+`ip_drift`, `env_start_timeout`, `login_expired`, `wrong_account_logged_in`, `reddit_connection_failed`, `rte_failed`, `subreddit_banned`, `bot_bouncer_blocked`, `rule_blocked`, `manual_intervention_required`, `unknown`
+
+## 并发
+
+同一账号同时只能有一个有效 lease；重复 claim 会被拒绝。`complete` 会原子更新 job 与关联 calendar（若 payload 含 calendarEntryId）。

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

@@ -0,0 +1,20 @@
+---
+name: social-hub-posts
+description: >-
+  Reddit 帖快照与数据：social-hub reddit list/stats/refresh/refresh-all/import-feishu 等。
+  用户要查帖表现、刷新 score、导入飞书表、permalink 对应快照时用本 skill（命令组名为 reddit）。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-posts
+
+```bash
+social-hub reddit list -t "$T" -n 20
+social-hub reddit stats -t "$T" --campaign "<uuid>"
+social-hub reddit refresh-status -t "$T" --id "<snapshotId>"
+social-hub reddit refresh-all -t "$T"
+social-hub reddit import-feishu -t "$T" -j '{ ... }'
+```
+
+发帖成功后应通过 `social-hub ops complete --permalink ...` 写回任务链路（见 `social-hub-publishing`）。

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

@@ -0,0 +1,31 @@
+---
+name: social-hub-publishing
+description: >-
+  内容发布闭环：campaign → plan → draft → calendar → scheduled_job → events → reddit snapshot → report。
+  用户要从草稿到排期、执行任务、permalink 回填、避免 job 成功但 calendar 未更新时用本 skill。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-publishing
+
+## 事实源
+
+- **计划**：`calendar_entries`
+- **执行**：`scheduled_jobs`
+- 本地 Markdown 日历仅作导入/导出视图，不是运行时真源
+
+## 链路
+
+```
+campaign → publishing_plan → content_draft → calendar_entry → scheduled_job
+  → interaction_events → reddit_post_snapshot → op_report
+```
+
+## Agent 推荐
+
+1. 创建/查询 draft、plan、calendar、job（见 `social-hub-cli` 对应命令）
+2. `social-hub ops claim-next` → 执行 → `social-hub ops complete --permalink <url>`
+3. `complete` 原子更新 job + calendar（+ 可选 snapshot id）
+
+失败时 `ops fail` / `ops skip`，并写标准 `reason` 枚举。

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

@@ -0,0 +1,41 @@
+---
+name: social-hub-shared
+description: >-
+  social-hub 基础能力：config init/show、auth login、doctor、version、permissions、context list/use/current。
+  在跑任何 Hub 写操作前应先 doctor 或 auth；配置报错、连不上 API、team 不对、权限不足时优先用本 skill。
+metadata:
+  cliVersion: ">=0.0.1"
+---
+
+# social-hub-shared
+
+## 环境变量
+
+```bash
+export SOCIAL_HUB_API_URL="http://localhost:3000"
+export SOCIAL_HUB_API_KEY="soh_..."
+export SOCIAL_HUB_TEAM_ID="<team-uuid>"   # 或用 context use 持久化
+```
+
+## 常用命令
+
+```bash
+social-hub config init --api-url http://localhost:3000 --team $T
+social-hub auth login --api-key "$SOCIAL_HUB_API_KEY"
+social-hub auth whoami
+social-hub doctor
+social-hub version --json
+social-hub context use "$T"
+social-hub context current
+social-hub permissions matrix
+social-hub auth explain
+```
+
+## 排障顺序
+
+1. `social-hub health`（无需 Key）
+2. `social-hub doctor`（含 `/health/live` 与 auth context）
+3. 确认 `SOCIAL_HUB_TEAM_ID` 与 API Key 绑定 team 一致
+4. `social-hub auth explain` 查看当前角色允许的命令
+
+更完整命令表见同包的 `social-hub-cli` skill。