@geoly-ai/social-hub-cli 0.3.21 → 0.3.22

package/skills/social-hub-content-classification/SKILL.md

@@ -2,7 +2,7 @@
 name: social-hub-content-classification
 description: >-
   Social Hub 内容四轴分类（Phase B1a 最小控制面）：content-classification get-subject 读某 hot_post
-  的 current proposed 分类，spec list/get/create/activate 管理 classifier spec，presentation 读展示分层。
+  的 current proposed 分类，recent 看最近成功 run，spec list/get/create/activate 管理 classifier spec，presentation 读展示分层。
   用户要查某热帖被分成什么内容形态（comparison/review/tutorial/showcase/news/deal 等四轴），或
   建/激活分类器 spec、看 highlight/directional/control 展示配置时用本 skill。
   不用于板块风格画像/帖子标注（用 social-hub-style-profiles）、板块情报采集（用 social-hub-intelligence）。
@@ -36,8 +36,12 @@ worker（单实例 cron）按 active spec 对缺当前 revision 成功 run 的
 
 - **spec 写（create / activate）仅 admin**，且 user-only：CLI 本地先拒 API Key，API 侧另拒服务/job token
   并要求真实登录用户（有 userId）+ admin 角色。manager 也**不可**写 spec（区别于 style-profiles 的 manager 可写）。
-- **读（get-subject / spec list / spec get / presentation）**：非 client 内部角色（internal/senior/supervisor/manager/admin）可用，client 恒拒。
+- **读（get-subject / recent / spec list / spec get / presentation）**：非 client 内部角色（internal/senior/supervisor/manager/admin）可用，client 恒拒。
 - 无 accept/reject 命令：pilot 不引人工裁决，只暴露 spec 管理 + 只读。
+- **`recent` 是 shadow 观测面，不是权威 current**：它按 active spec 列最近的成功 run，
+  这些 run 可能对应帖子的**旧 revision**。要判断某帖「当前」被分成什么，只能用
+  `get-subject`（精确唯一键查询，proposed / missing 二态）。**不要拿 `recent` 的
+  第一条当 latest 用。**
 
 ## 读面
 
@@ -51,6 +55,10 @@ social-hub content-classification spec list [--purpose <p>]
 # 按 id 查任意 spec（含 draft / retired）
 social-hub content-classification spec get --id <spec-uuid>
 
+# active spec 下最近的成功 run + 帖子上下文（shadow 观测/抽查；非权威 current，见上方约束）
+# --content-form 过滤 comparison|review|tutorial|showcase|news|deal；--limit 1-200，默认 20
+social-hub content-classification recent [--purpose <p>] [--content-form review] [--limit 50]
+
 # 展示分层（highlight/directional/control forms；缺则契约默认，source 标注来源）
 social-hub content-classification presentation
 ```
@@ -79,6 +87,7 @@ social-hub content-classification spec activate --id <spec-uuid> --apply
 
 - `GET /v1/system/content-classifications/subjects/:hotPostId`（current proposed；`?purpose=`）
 - `GET /v1/system/content-classifications/specs`（该 purpose active spec；`?purpose=`）、`GET .../specs/:id`
+- `GET /v1/system/content-classifications/runs/recent`（active spec 最近成功 run；`?purpose=&contentForm=&limit=`）
 - `POST /v1/system/content-classifications/specs`（建 draft，admin）、`POST .../specs/:id/activate`（激活，admin）
 - `GET /v1/system/content-classifications/presentation`
 

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

@@ -182,7 +182,7 @@ admin 专属操作（如 `agent-teams create`）需要 **admin** role 的 CLI to
 ```text
 [social-hub] Update available: 0.1.4 → 0.1.5
 [social-hub] Upgrade CLI: npm install -g @geoly-ai/social-hub-cli@0.1.5
-[social-hub] After upgrade, new skills auto-sync on next run (or run: social-hub skills install)
+[social-hub] Skills are NOT synced by this background upgrade: the next `social-hub` command syncs them (run `social-hub skills sync` to do it now).
 [social-hub] Agent: tell the user a newer CLI is available; ...
 ```
 
@@ -193,7 +193,11 @@ admin 专属操作（如 `agent-teams create`）需要 **admin** role 的 CLI to
 | 跳过检查 | `SOCIAL_HUB_NO_UPDATE_CHECK=1` 或 `social-hub --no-update-check …` |
 | CI       | 设置 `CI=true` 时自动跳过                                          |
 
-Agent 看到上述 stderr 时：**先向用户说明有新版本**，再执行升级命令（`npm install -g @geoly-ai/social-hub-cli@latest`）。升级后新发布的 skill 会在后续运行时同步到已托管目录（**默认自动完成**；仅当设了 `SOCIAL_HUB_NO_SKILLS_AUTO_UPDATE=1` 关掉时才只在 stderr 提示补齐）；手动补齐新增 skill 用 `social-hub skills install`（`update` 只刷新已安装的 skill、不装新增的），以避免 CLI 与 skill 文档/命令漂移。
+Agent 看到上述 stderr 时：**先向用户说明有新版本**，再执行升级命令（`npm install -g @geoly-ai/social-hub-cli@latest`）。
+
+> 🔴 **二进制自更新本身不同步 skills。** 后台跑的只是 `npm i -g`；skills 的同步发生在**下一条** `social-hub` 命令（那时才加载新二进制、skill-check 缓存因版本变化立即失效）。npm 的 `postinstall` 也补不上这一拍——它只打印提示文案。所以准确说法是「**升级后下一条命令自动同步 skills**」，中间有**一拍延迟**（实测约几十秒，取决于下一条命令什么时候跑）。**要立刻同步就跑 `social-hub skills sync`**，或用 `social-hub self-update`（它把升级 + 同步串起来一次做完）。
+
+同步默认自动完成；仅当设了 `SOCIAL_HUB_NO_SKILLS_AUTO_UPDATE=1` 关掉时才只在 stderr 提示补齐。手动补齐新增 skill 用 `social-hub skills sync`（或 `skills install`）——注意 `skills update` 只刷新**已安装**的 skill、不装新增的，以避免 CLI 与 skill 文档/命令漂移。
 
 ## 技能过期检测与自动更新（自动）