siluzan-cso-cli 1.1.24 → 1.1.25-beta.2

package/dist/skill/three-lib-content-workflow/persona-onboarding.md

@@ -0,0 +1,175 @@
+# 人设引导脚本
+
+## 这份文件是什么
+
+当用户进入三库内容工作流但**没有可用人设卡**时，AI 第一句话该说什么、怎么把用户引导到一张可用的人设卡。
+
+`content-writer.workflow.md` 第 0 步会引用本文件。人设统一走 CSO 平台。
+
+## 触发条件
+
+进入工作流后，按以下顺序判断：
+
+1. 用户本次对话直接提供了人设卡文件 / 内容 → 读取后跳过引导，进入"导入路径"
+2. CSO 平台已有人设（`siluzan-cso persona list`）→ 列出供用户选择
+3. 以上都没有 → 触发本引导脚本
+
+## 第一句话（AI 主动开口）
+
+> 在开始之前，我需要先和你确认"人设"——也就是这个账号是个什么样的"人"。
+>
+> 为什么这一步不能省：三库（流量因子 / 产品资产 / 烹调方法）是通用骨架，同一个"强观点开场"模板，配不同腔调写出来完全是两篇东西。差别全在人设。
+>
+> 三种方式，挑一个：
+>
+> **① 用 3 篇代表作品反推（推荐）**
+> 你贴 3 篇想延续风格的作品（你自己写的、或者想对标的账号都行），我读完会给你一张反推出来的人设卡。
+>
+> **② 你直接描述**
+> 如果脑子里已经很清楚账号长什么样，跟我说定位 / 受众 / 风格 / 口头禅就行，我边问边整理。
+>
+> **③ 你已经有现成的人设卡**
+> .md / 文本 / 截图，发给我，我结构化后保存到 CSO 平台。
+>
+> 你想走哪条？
+
+## 兜底分支：用户什么都不想填
+
+如果用户表达"我先随便写一篇看看""我不想搞这么麻烦""我还没想好"——**不要硬卡**，给临时人设路径：
+
+> 你现在就想写一篇？也可以——你先告诉我这次想写什么主题、给谁看、希望什么腔调。我用一个**临时人设**给你生成。
+>
+> 写完之后，如果你喜欢这版的腔调，我们就把它保存成正式人设；不喜欢就丢掉重来。
+
+临时人设的处理：
+- 仅在会话内存中，**不**保存到 CSO 平台
+- confidence 字段全部标 `likely` 或 `unverified`
+- 写完后主动问一次："这版的腔调你喜欢吗？要不要保存？"
+- 用户说"保存"才入库（`siluzan-cso persona create`）
+
+## "我不知道什么叫人设" 的解释
+
+如果用户提出这个疑问：
+
+> 你可以把它想成演员的角色卡：这个号是个什么样的"人"，聊什么、不聊什么、说话什么腔。我们后面写出来的所有内容，都是这个"人"在说话。不用一开始就完美，写几篇会越来越准。
+
+## 三个分支的执行细节
+
+### 分支 ① 反推路径（推荐）
+
+**AI 说：**
+> 好，把 3 篇贴给我（或者上传文件）。每篇之间用 `---` 分隔，或者一篇一条消息发都行。
+
+**收到后：**
+- 调用 `persona-reverse-sop.md` 流程
+- 输出人设卡（符合 `persona-schema.md`）
+- 进入 **A1 确认环节**（见下方"落盘前确认流程"）
+
+**作品数量兜底：**
+- 只给 1–2 篇：
+  > 可以，但 1–2 篇里有些字段我没法稳定推出来（句式、禁区、选题边界这些）。这些字段我会标"待验证"，最后我们一条条过一遍。你愿意补充更多作品吗？或者直接进确认环节，缺的部分你来填？
+
+- 给超过 5 篇：
+  > 这么多篇我可以全读，但建议挑你最想延续风格的 3–5 篇就好——多了反而难找共性。你来挑，还是我读完所有的之后告诉你哪几篇最有代表性？
+
+### 分支 ② 描述路径
+
+**AI 主动按 schema 顺序问，不要把空表格甩给用户：**
+
+```
+Q1: 先说定位——这个账号是干嘛的？想解决什么问题？
+Q2: 写给谁看？他们现在处于什么状态？（新手 / 老手 / 决策者 / 围观者）
+Q3: 想让人感觉这个号是什么风格？我给你几个倾向你挑：
+    - 强判断（先下结论，立场鲜明）
+    - 务实步骤（教程感，可执行）
+    - 故事感（有画面，节奏慢）
+    - 互动型（引发讨论）
+    - 反差颠覆（打脸式认知）
+    - 温和分享（生活化）
+    - 专业权威（知识密度高）
+    - 接地气（口语化）
+   可以挑 1–3 个。
+Q4: 节奏偏好——快节奏（句句推进）、中等、还是稳一点的慢节奏？
+Q5: 你常讲什么话题？尽量列具体方向。
+Q6: 有什么是你绝对不讲的？或者绝不能用的表达？（没有就说"无"）
+Q7: 行业/赛道是哪个？还是说不限行业？
+Q8:（可选）有口头禅、固定开场、标志性比喻吗？想到几条算几条。
+Q9:（可选）你希望我每次写完检查哪些点？比如"是不是足够具体""有没有可执行的动作"——这是你这个号特有的判断标准。
+```
+
+问完整理成卡 → **A1 确认环节**。
+
+### 分支 ③ 已有卡路径
+
+**AI 说：**
+> 发给我，任何格式都行。我读完按标准 schema 重排版，缺的字段补问你，然后保存到 CSO 平台。
+
+**收到后：**
+- 解析内容，映射到 `persona-schema.md` 字段
+- 缺失必填字段 → 单独问用户
+- 选填字段缺失但能从内容推断 → 标 `likely` 让用户确认
+- 完全没线索的选填字段 → 留空，confidence 标 `unverified`
+- 进入 **A1 确认环节**
+
+## 落盘前确认流程（A1）
+
+所有路径最终都汇到这里。**强制执行**，不允许跳过。
+
+**AI 说：**
+> 我整理了一张人设卡，咱们一条条过一遍。我会列出每个字段和我的判断，你确认 / 修改 / 补充。
+>
+> 过完之后保存到 CSO 平台，下次写稿可以直接用 `siluzan-cso persona list` 取回。
+
+**逐条过的展示形式：**
+
+```
+✅ 已确认 [字段名]: <值>
+       —— 来源：作品 A 反复出现 / 你刚才描述的 / 你提供的卡
+       —— 要改吗？
+
+⚠️ 高概率 [字段名]: <值>
+       —— 来源：作品 B 出现 1 次，需要确认
+       —— 保留 / 修改 / 删除？
+
+❓ 待验证 [字段名]: <值>
+       —— 我推不出来，需要你确认
+       —— 你的回答？
+```
+
+每个字段三选一：保留 / 改 / 删。过完后所有字段的 confidence 升级为 `confirmed`，才允许保存到平台。
+
+**最后一步：命名 + 保存**
+
+> 给这个人设起个名字（英文/拼音/中文皆可，会作为平台 personaName）。
+
+AI 把确认好的 markdown 写到临时文件，调用：
+
+```
+siluzan-cso persona create --name "<name>" --style-guide-file <临时文件路径>
+```
+
+保存成功后反馈：
+
+> 已保存到 CSO 平台（人设 ID：<id>）。下次写稿直接用 `<name>` 引用就行。
+>
+> 接下来回到主流程，开始写稿。
+
+## 临时人设的写完追问
+
+如果用户走的是"临时人设"路径，写完正文后必须主动问一次：
+
+> 这版稿子你看下——
+>
+> - 腔调对吗？
+> - 这次用的人设我没保存。你喜欢这版的话，我可以保存成正式人设（写到 CSO 平台），下次直接用。要保存吗？
+
+- 用户说要 → 进入 A1 确认流程 → `siluzan-cso persona create`
+- 用户说不要 → 不保存，结束
+
+## 与其他文件的关系
+
+- 字段定义：见 `persona-schema.md`
+- 反推具体步骤：见 `persona-reverse-sop.md`
+- 平台命令细节：见 `references/persona.md`
+- 入口集成：见 `content-writer.workflow.md` 第 0 步
+- 字段如何被消费：见 `sop.md` 各步骤

package/dist/skill/three-lib-content-workflow/persona-reverse-sop.md

@@ -1,185 +1,188 @@
 # 代表作品反推人设卡 SOP
 
-## 目标
+## 这份文件是什么
 
-通过少量代表作品，反推出一个账号的人设卡，包括：
+输入若干篇代表作品，输出一张符合 `persona-schema.md` 的人设卡。
 
-- 账号定位
-- 受众
-- 核心任务
-- 风格
-- 选题边界
-- 常用表达
-- 禁忌
-- 适合内容形态
+本流程是 `persona-onboarding.md` 的"分支 ①"具体执行步骤。
+
+## 输出契约
+
+最终产物必须严格符合 `persona-schema.md` 的字段标准。落盘（保存到 CSO 平台）前必须走 A1 强制逐条确认，所有字段 confidence 升级为 `confirmed`，再用 `siluzan-cso persona create` 保存。
 
 ## 输入要求
 
-你给我的内容最好是：
+最佳：3–5 篇代表作品。
+最低：1 篇（不推荐，多数字段会标 `unverified`）。
 
-- 1-5 篇代表作品
-- 如果有，附上账号名称或用途
-- 如果有，附上你对这个账号的直觉判断
-- 如果有，附上你希望我重点关注的点
+如有以下补充信息一并提供：
+- 账号名称或用途
+- 你对这个账号的直觉判断
+- 你希望重点关注的点
 
 ## 第一步：先读作品，不急着下结论
 
-先看作品本身，找这些信息：
+逐篇扫描，找以下信息（**只采集，不下判断**）：
 
-- 讲什么主题
+- 主题是什么
 - 面向谁
-- 语气是什么
+- 语气怎么样
 - 开头怎么起
 - 中段怎么推
 - 结尾怎么收
 - 有没有固定套路
 - 有没有强烈的情绪或判断
+- 有没有反复出现的句式 / 关键词 / 比喻
 
-这一阶段不要先写人设，先**找共性**。
-
-## 第二步：从作品里反推 7 个维度
-
-### 1）账号定位
-
-回答：这组作品整体在解决什么问题？它更偏认知、方法、情绪，还是转化？
-
-### 2）目标受众
-
-回答：它明显在写给谁看？是老板、业务员、外贸新人、创业者，还是消费者？受众的成熟度如何？
-
-### 3）核心任务
-
-回答：它是提供判断？提供方法？提供灵感？提供案例？提供安慰？提供成交？
-
-### 4）核心风格
-
-回答：是强势还是温和？是理性还是感性？是专业还是口语？是犀利还是稳重？是快节奏还是叙述型？
-
-### 5）选题边界
-
-回答：它常讲什么？它不讲什么？它适合哪些主题？它有哪些明显禁区？
-
-### 6）常用表达
+读完所有作品后，**先找共性**：哪些是反复出现的？哪些只出现一次？哪些是 1–2 篇里偶发的？
+
+## 第二步：按 schema 字段反推
 
-回答：有没有固定句式？有没有高频关键词？有没有标志性比喻？有没有喜欢用的转折结构？
+对每个字段，按"作品里有没有支撑"标置信度：
+- **`confirmed`**：多篇作品反复出现，明确
+- **`likely`**：1–2 篇出现，倾向明显但不确定
+- **`unverified`**：作品里完全没线索
 
-### 7）适合的内容形态
+### 必填字段反推
 
-回答：热点解读、方法教程、案例拆解、趋势判断、爆款口播、转化内容。
+#### positioning（定位）
+回答：这组作品整体在解决什么问题？偏认知 / 方法 / 情绪 / 转化？
+- ≥3 篇有同一倾向 → `confirmed`
+- 仅 1–2 篇 → `likely`
 
-## 第三步：提取“作品证据”
+#### audience（受众）
+回答：明显在写给谁？他们的成熟度？
+- 作品里明确点名或预设受众 → `confirmed`
+- 只能从话题推测 → `likely`
 
-不要只写主观判断，要写证据。
-比如：
+#### core_task（核心任务）
+回答：它在提供判断 / 方法 / 灵感 / 案例 / 安慰 / 转化？（可多选）
+- 多篇主线一致 → `confirmed`
+- 各篇任务不同 → 列出所有，标 `likely`
 
-- 从作品 A 看，账号更像……
-- 从作品 B 看，它常用……
-- 从作品 C 看，它不太写……
+#### style_tags（风格标签，1–3 个）
+从枚举里选：
+`strong_opinion` / `practical_steps` / `story_driven` / `interactive` / `reframe` / `gentle_sharing` / `expert_authority` / `grounded`
 
-这样写出来的人设卡更稳，不容易跑偏。
+判断方法：
+- ≥3 篇都体现某标签 → `confirmed`
+- 仅 1–2 篇 → `likely`
+- 推不出来 → `unverified`，提示用户必须确认
 
-## 第四步：先写“临时人设卡”
+#### tone（语气）
+用一句话描述。从作品里找形容词级别的特征（强势 / 温和 / 犀利 / 稳重 / 紧迫 / 真诚）。
 
-如果作品还不多，不要强行写死。先写一个**临时版**，分三类：
+#### pace（节奏）
+- `fast`：短句、高密度、句句推进
+- `medium`：长短交替
+- `steady`：长句、节奏舒缓、铺陈型
 
-### 已确认
+#### topic_scope（常讲什么）
+列出作品涉及的所有具体话题方向，去重后保留高频项。
 
-作品已经非常明确表现出来的特征。
+#### topic_taboos（不讲什么）
+- 如果作品里明显避开某些话题 → 写下来
+- 没线索 → 留 `unverified`，确认环节请用户补
 
-### 高概率
+### 选填字段反推
 
-从多篇作品中能看出来，但还可以继续验证的特征。
+#### industry_focus
+如果作品集中在某个行业 → 填该行业；如果跨行业 → 填"通用"。
 
-### 待验证
+#### platform_focus
+根据作品形态判断：公众号长文 → 填 `公众号`；短视频口播脚本 → 填 `短视频`；不确定则留空，A1 环节问用户。
 
-目前只是推测，后面需要更多作品确认的部分。
+#### common_phrases
+**这是反推最有价值的字段**。从作品里抓所有反复出现的句式，分四类：
+- opening：开头句式
+- transition：过渡句式
+- ending：结尾句式
+- cta：行动号召句式
 
-## 第五步：整理成人设卡
+每类至少抓 2 条（如果作品支持）。
 
-推荐结构如下：
+#### keywords / metaphors / forbidden_expressions
+- 高频关键词：词频统计后挑 top 5–10
+- 标志性比喻：作品里反复用的形象化表达
+- 禁忌表达：作品里明显回避的词（如果观察不到，留空）
 
-```markdown
-# XXX 人设卡（由代表作品反推）
+#### opening_preferences / progression_preferences / ending_preferences
+从作品的结构观察，选枚举值：
 
-## 代表作品
+**opening_preferences**:
+- `contrast`（反差开头）
+- `question`（设问开头）
+- `conclusion_first`（结论先行）
+- `story`（故事开头）
+- `crisis_signal`（危机信号开头）
 
-- 作品1
-- 作品2
-- 作品3
+**progression_preferences**:
+- `three_points`（三点拆解）
+- `phenomenon_to_essence`（现象→本质）
+- `problem_to_solution`（问题→解法）
+- `case_to_judgment`（案例→判断）
 
-## 作品共性
+**ending_preferences**:
+- `punchline`（金句收尾）
+- `action_call`（行动提醒）
+- `interaction`（评论互动）
+- `next_episode`(下期预告)
+- `boundary_reminder`（边界提醒）
 
-- ...
+#### quality_checks（账号特有的质检维度）
+**这字段最容易被忽视，但最重要**。
 
-## 反推账号定位
+观察这组作品反复满足的"隐含标准"：
+- 是不是每篇都有具体动作？→ 加一条 "有没有可执行的动作"
+- 是不是每篇都有明确判断？→ 加一条 "有没有清晰的判断"
+- 是不是每篇都让人感觉"这事和我有关"？→ 加一条 "有没有让受众产生代入感"
+- 是不是每篇都避免说教？→ 加一条 "有没有避开说教感"
 
-- ...
+至少抽出 3 条。这是这个人设区别于其他号的"灵魂尺子"。
 
-## 反推受众
+## 第三步：写"作品证据"
 
-- ...
+**不允许只写主观判断**。每个非空字段都要带证据：
 
-## 反推核心任务
-
-- ...
-
-## 反推核心风格
-
-- ...
-
-## 反推选题方向
-
-- ...
-
-## 反推常用表达
-
-- ...
-
-## 反推禁忌
-
-- ...
-
-## 适合的内容形态
-
-- ...
+```
+positioning: <值>
+  证据：作品 A 第二段、作品 C 整体倾向 → confirmed
 ```
 
-## 第六步：如果要落地到写稿，还要补 3 项
+证据写得清楚，A1 确认时用户能快速判断对不对。
 
-人设卡不只是描述，还要能直接用。
-所以建议再补：
+## 第四步：组装成卡，进入 A1 确认
 
-### 1）开头偏好
+按 `persona-schema.md` 的完整模板组装。confidence 字段诚实标注，**不要为了好看把 `likely` 偷偷升级成 `confirmed`**。
 
-- 反差开头
-- 设问开头
-- 结论先行
-- 故事开头
+进入 `persona-onboarding.md` 的"落盘前确认流程（A1）"，确认完成后用 `siluzan-cso persona create --style-guide-file` 保存到平台。
 
-### 2）中段推进方式
+## 第五步：如果要直接落地到写稿，强烈建议补的 3 项
 
-- 三点拆解
-- 现象→本质
-- 问题→解法
-- 案例→判断
+这三项不是 schema 必填，但缺了主 SOP 第7步/第9步会被迫用通用默认值：
 
-### 3）结尾收法
+1. **opening_preferences**（开头偏好）
+2. **progression_preferences**（中段推进偏好）
+3. **ending_preferences**（结尾偏好）
 
-- 金句收尾
-- 行动提醒
-- 评论互动
-- 下期预告
-- 边界提醒
+A1 确认环节碰到这三项为空时，主动追问用户。
 
 ## 标准工作流
 
-**拿作品 → 找共性 → 拆 7 维 → 找证据 → 写临时卡 → 补开头/中段/结尾偏好 → 输出人设卡**
+**拿作品 → 找共性 → 按 schema 字段反推（带证据 + 置信度） → 组装人设卡 → A1 强制逐条确认 → 命名 → `persona create` 保存到 CSO 平台**
 
 ## 最实用的判断原则
 
-如果你只靠作品反推人设卡，最怕两件事：
+只靠作品反推，最怕两件事：
+
+1. **过度脑补**：看到一篇作品就把字段写死。**对策**：严格用 confidence 标注，1–2 篇出现的一律 `likely` 不升级。
+2. **只看风格，不看任务**：只填 style_tags，positioning / audience / core_task 含糊。**对策**：每个必填字段都必须有作品证据，没证据宁可标 `unverified` 让用户填。
+
+记住核心公式：**人设 = 定位 + 受众 + 任务 + 风格 + 边界 + 表达 + 质检尺子**，不是只有风格。
 
-1. **过度脑补**：看到一篇作品就把人设写死。
-2. **只看风格，不看任务**：只写“犀利、专业、稳重”，但没写它到底服务什么目标。
+## 与其他文件的关系
 
-所以一定要记住：**人设 = 定位 + 受众 + 任务 + 风格 + 边界**，不是只有风格。
+- 输出字段标准：见 `persona-schema.md`
+- 引导入口：见 `persona-onboarding.md`
+- 平台保存命令：见 `references/persona.md`
+- 反推产物如何被消费：见 `sop.md` 第1步及各步骤