@geoly-ai/social-hub-cli 0.3.18 → 0.3.19

package/skills/reddit-phase-research/references/phase01-research.md

@@ -120,7 +120,9 @@ Phase 0 门禁自查：
 
 ## Phase 0.5 — 候选板块发现与分析
 
-**目标：** 系统性发现适合发帖的候选子版（subreddit），完成版规过滤、内容风格分析和发帖频率建议，产出「候选板块分析报告」。
+**目标：** 系统性发现适合发帖的候选子版（subreddit），完成版规过滤，产出每个通过板块的 **SubredditResearchProfile（SRP）** 与「候选板块分析报告」。
+
+> **发帖节奏/容量不在本阶段拍板。** 有 SRP 时由 `reddit-phase-planning` 的排期决策程序 D5 从 SRP 推导 `capacityMax`；无 SRP 时才用本文件「补充条例 a-F」的兜底默认表取一个默认节奏，并标 `FallbackOnly`。
 
 > **项目类型判断（执行任何步骤前必须先确认）：** 两类合同对 Geoly 数据可用性影响不同：
 >
@@ -195,9 +197,9 @@ get_prompt_citations(
 | 解析项 | 负责 Skill | 职责 |
 |--------|-----------|------|
 | 版规 / 风控 / 板块适配 / 账号门槛 / AutoModerator·banner·Installed Apps 信号 | **reddit-subreddit-compliance**（独立矩阵 skill） | **风控管理**：产出 Fit / OverallRisk / EvidenceCompleteness / AccountGate；决定通过、过滤、待验证 |
-| 板块里大家喜欢的主贴型、讨论内容方向、score 梯队、存活帖学习 | **reddit-voc-volume**（独立矩阵 skill；脚本路径通常为 `~/.cursor/skills/reddit-voc-volume/scripts/reddit_voc_volume.py`） | **声量采样**：拉帖子样本与互动数据；样本仅作社区偏好信号，**不能**替代明文版规 |
+| 板块研究画像（SRP）：全窗口 flair 分布、话题构成、删帖率；以及高分帖的定性观察 | **reddit-voc-volume**（独立矩阵 skill；脚本路径通常为 `~/.cursor/skills/reddit-voc-volume/scripts/reddit_voc_volume.py`） | **声量采样**：按 SRP 契约 S1–S9 拉全窗口数据与帖子样本；样本仅作社区偏好信号，**不能**替代明文版规；**top-N 样本不得产出任何占比类结论** |
 
-> **补充条例 a（板块选取硬规则）：** 选取板块时**优先依据版规与合规风控结论**，不得因「每周访客数特别高」直接采用。高流量但 `OverallRisk=High`、明确禁止品牌推广、或落入 `NotRecommended` 的板块仍须过滤或标「待验证」，不得进入 Phase 4 执行表。
+> **补充条例 a（板块选取硬规则 · 未降级，仍是硬规则；勿与下文兜底表「补充条例 a-F」混淆）：** 选取板块时**优先依据版规与合规风控结论**，不得因「每周访客数特别高」直接采用。高流量但 `OverallRisk=High`、明确禁止品牌推广、或落入 `NotRecommended` 的板块仍须过滤或标「待验证」，不得进入 Phase 4 执行表。
 
 **步骤 0.5.4** 逐板块合规风控检测（reddit-subreddit-compliance）：
 
@@ -282,9 +284,21 @@ python3 "$VOC" flair-filters -r "<subreddit>" \
 | `VerifiedCandidates` + Fit=High，Risk=Low/Medium，允许个人经验/推荐 | 宽松 | **通过** |
 | `NeedsVerificationCandidates`（EvidenceCompleteness=Partial/Insufficient） | — | 标「待验证」，默认**不**进入 Phase 4 执行表，直至补 rules/flair wiki/pinned/sidebar/bot/Installed Apps 证据 |
 
-**补充条例 a — 发帖频率判断规则（通过版规风控、非 NotRecommended 的板块均须执行）：**
+**补充条例 a-F — 无 SRP 兜底默认表（`SRPMode: Fallback` 专用）：**
 
-| 版规松紧 | 每周贡献数 | 频率建议 | P-B 帖倾向 |
+> ⚠️ **本表已降级为兜底默认，不是配比判据。** 它是「没有板块研究画像（SRP）时」的替代品。
+>
+> - `SRPMode: Full`（该板块已有 SRP）：**禁止**使用本表参与任何配比推导；节奏与容量由
+>   排期决策程序 D5 的 `capacityMax` 给出，配比由 D6 求解。
+> - `SRPMode: Fallback`（该板块无 SRP）：可用本表取默认节奏，**每一处引用都必须标 `FallbackOnly`**。
+> - **不得用本表反推配比。** 表中「P-B 帖倾向」一列只是**风控倾向**，
+>   **不改变**任何 P-B / P-NB / C-B / C-NB / PGC 的合同数字——配额语义以
+>   `memory/phase4-sku-基准表.md` 与 `phase4-planning.md` Phase 4.0.0 为唯一来源。
+>
+> **注意与 L200 的「补充条例 a（板块选取硬规则）」区分：** 那一条（合规优先于流量选板块）
+> **未降级，仍是硬规则**；本条 a-F 才是被 SRP + 排期决策程序取代的兜底查表。
+
+| 版规松紧 | 每周贡献数 | 频率建议（FallbackOnly） | P-B 帖倾向（仅风控倾向，非配额） |
 |---------|---------|---------|-----------|
 | 宽松 | 高（>5000） | 每 1–2 天一帖，帖被快速淹没举报风险低 | 可适当提高 P-B 比例 |
 | 宽松 | 中（1000–5000） | 每 2–3 天一帖 | 正常配比 |
@@ -293,25 +307,47 @@ python3 "$VOC" flair-filters -r "<subreddit>" \
 | 中等 | 低 | 每 5–7 天一帖 | 以 P-NB 为主 |
 | 严格 | 任何 | 评估是否放弃该板块，或仅用 C-NB 外部评论介入 | 禁止 P-B |
 
-**步骤 0.5.5** 板块内容深度分析（reddit-voc-volume · 声量采样；**仅**对步骤 0.5.4.3 通过、非「过滤」的板块）：
+**步骤 0.5.5** 板块研究画像（SubredditResearchProfile / SRP）产出或复用（**仅**对步骤 0.5.4.3 通过、非「过滤」的板块）：
+
+> **本步骤已从「top-N 采样 + score 梯队」改为「按 SRP 契约的 S1–S9 标准作业步骤产出板块研究画像」。**
+>
+> **为什么换：** 旧做法用 `--sort top --limit 50` 采样。**top-N 是按 score 排序的偏差样本，
+> 统计上不可能产出可信的全板 flair 占比**——它系统性地过采高分帖，低分/日常/提问类内容被整段截掉。
+> 而排期决策程序 D2 依赖的核心资产是**全窗口 flair 分布**（分母明确的全量占比，
+> 例：某板块窗口内抓取 1200 / 有效 936 / `General Question` 28.1%）。
+> 这不是 agent 不够努力，是这一步的方法上限就到不了标杆。
+>
+> **必读契约：** `~/.cursor/skills/reddit-strategy-shared/references/subreddit-research-profile.md`
+> （Windows：`$HOME\.cursor\skills\reddit-strategy-shared\references\subreddit-research-profile.md`）。
+> 按契约的 **S1–S9 标准作业步骤**逐步执行；**已有未过期的 SRP 可直接复用**，复用时记录其版本与采集时间。
+>
+> **版规与风控结论仍以 0.5.4 compliance 输出为准**，不得用帖子样本反推版规松紧。
+
+**a. 产出/复用 SRP（S1–S9）：** 按契约执行，产出至少包含窗口起止、抓取总数、有效数、
+排除数与排除原因，即契约的**分母三件套** `fetchedN` / `dedupedN` / `eligibleN` +
+`excludedByReason` + `unknownFlairN`；`flairDistribution[]`（每 flair 的 `count` + `share` +
+**显式声明的分母**，`Unknown` 作为显式 bucket）、`lowSignalFlairs`、`flairBoundaryNotes`、
+`contentTypes[]`、`removalStats`（mod 删除 / 用户自删 / unknown 三项分列）、`selfPromoPolicy`、
+`samplingFrame` + 逐字段 `claimScope`、`confidence`、`computedAt` 与 `lineage`。**字段口径以契约为准**。
+
+> **占比类结论的唯一合法来源是 SRP 的全窗口统计。** 以下一律禁止：
+> **禁止**用 top-N 样本产出 flair 占比、帖型占比、话题占比或任何「百分比」结论；
+> **禁止**把样本内比例说成板块总体比例；**禁止**在没有明确分母的情况下报占比。
+>
+> 采不到 SRP 时记 `SRPMode: Fallback`（无画像）；采到但契约判 `confidence: Insufficient`
+> 且无法补采时记 `SRPMode: Insufficient`（画像不可信）。**两者不得混用**——
+> 前者走兜底默认继续排期，后者按排期决策程序 D7 判 0 篇。
 
-> 本步骤只回答「板块里大家喜欢什么帖型、讨论什么方向」；**版规与风控结论以 0.5.4 compliance 输出为准**，不得用 top 帖样本反推版规松紧。
+**b. top 采样的保留用途（定性观察，不得产出占比）：**
 
 ```bash
-# 抓取该板块 top 帖（含时间戳，用于存活分析）
+# 仅用于定性观察：高分帖长什么样。不得用于 flair / 帖型 / 话题占比。
 python3 "$VOC" keyword "subreddit:<subreddit>" --sort top --limit 50 --pretty
 ```
 
-**a. Score 百分比梯队划分：** 对 50 条帖子按净赞数（score）排序，划分 4 档：
-
-```
-top 10%（前 5 条）：score ≥ N1
-10%–30%（第 6–15 条）：score N2~N1
-30%–50%（第 16–25 条）：score N3~N2
-50% 以下：score < N3
-```
-
-**b. 存活帖提取与学习：** 对每梯队中 `created_utc` 距今 **≥ 3 个月**的帖子，逐条学习以下 4 个维度：
+按 score 从高到低划**排名档位**（第 1–5 名 / 第 6–15 名 / 第 16–25 名 / 第 26 名以后），
+**只作定位用，不是分布，不得写成百分比档位**。对每档中 `created_utc` 距今 **≥ 3 个月**的帖子，
+逐条学习以下 4 个维度（定性学习，同样不产出占比）：
 
 | 学习维度 | 说明 |
 |---------|------|
@@ -327,7 +363,8 @@ top 10%（前 5 条）：score ≥ N1
 
 **步骤 0.5.5b — Ask AI 贴型权重分析（reddit-answers-research）**
 
-> **目的：** VOC（步骤 0.5.5）告诉你该品类社区覆盖哪些帖型；Ask AI 进一步告诉你**哪几种帖型最多被 Reddit AI 引用**，从而在 Phase 4 执行表中调高这些帖型的比例。
+> **目的：** SRP（步骤 0.5.5）告诉你该品类社区覆盖哪些帖型；Ask AI 进一步告诉你**哪几种帖型最多被 Reddit AI 引用**。
+> 本步骤只产出**倾向**，作为排期决策程序 D6 的软目标输入；**具体条数由 D6 在硬约束下求解并由用户锁定**，本步骤不得直接调整执行表比例。
 
 **执行条件：** 可选步骤，但强烈建议执行；需要浏览器 MCP 可用。若浏览器能力不可用或 Geoly Prompt 尚未建立，记录跳过原因，不得伪造 Ask AI 结果。
 
@@ -369,16 +406,20 @@ top 10%（前 5 条）：score ≥ N1
 | Prompt | <Prompt> | N | GUIDE×3, ASK×2 | GUIDE |
 
 ### 综合结论：高 AI 收录权重帖型（跨维度出现 ≥2 次）
-- GUIDE：品类科普/选购攻略被 AI 高频引用 → 建议在执行表中提高 GUIDE 比例至 XX%
-- ROUNDUP：横评帖被引用率高 → 建议维持或略提 ROUNDUP 比例
-- ASK：问答帖在 SKU 维度被引用多 → 保持配比，重点让首楼评论露出品牌
+- GUIDE：品类科普/选购攻略被 AI 高频引用 → 倾向调高（具体条数交 D6）
+- ROUNDUP：横评帖被引用率高 → 倾向维持或略调高（具体条数交 D6）
+- ASK：问答帖在 SKU 维度被引用多 → 倾向维持；重点让首楼评论露出品牌（形态受 brandEntryAllowedSet 约束）
 
-### 权重调整建议（供 Phase 4.0 执行表参考）
-- 原 VOC 帖型覆盖计划：[从步骤 0.5.5 提取，如 GUIDE/ROUNDUP/ASK/OWNER/OPINION 各 XX 条]
-- Ask AI 权重调整后：[如 GUIDE +2条, ROUNDUP +1条，OPINION -1条]
-- 调整依据：GUIDE 在 3/4 查询维度均为 AI 引用前3帖型
+### 权重倾向建议（D6 的**软目标输入**，不是配比结论）
+- 原 VOC 帖型覆盖倾向：[从步骤 0.5.5 的定性观察提取]
+- Ask AI 倾向：[如 GUIDE 偏高、ROUNDUP 偏高、OPINION 偏低]
+- 依据：GUIDE 在 3/4 查询维度均为 AI 引用前3帖型
 ```
 
+> **不得在此直接改配比。** 本节只提供倾向，落到具体条数由 `reddit-phase-planning` 的
+> 排期决策程序 D6 在硬约束下求解、并由用户锁定方案。写「GUIDE +2 条」这类数字调整，
+> 等于绕过 D6 的硬约束与人审，禁止。
+
 > **诚实边界：** Ask AI 引用帖样本量有限，仅作方向性参考；不代表 Geoly 实测 citation 数据；正式报告须标注「待 Geoly 数据验证」。
 
 **步骤 0.5.6** 产出候选板块分析报告，写入 `memory/phase0.5-board-analysis.md`：
@@ -391,6 +432,22 @@ top 10%（前 5 条）：score ≥ N1
 | r/xxx | VOC | 41万 | 9344 | 9344（contributions alias） | High | Low | 宽松 | 每1-2天 | GUIDE/ASK | 通勤降噪/预算选品 | 无 | Complete |
 | r/yyy | Geoly-TWS | — | — | — | Medium | Medium | 中等 | 每3天 | OWNER | 使用体验分享 | 须含使用时长 | Partial |
 
+> 「频率建议」列须注明来源。**研究阶段只能填两种值**：`FallbackOnly（补充条例 a-F）`（无 SRP 时直接填），
+> 或 `PendingD5`（有 SRP 时——容量由 planning 阶段的排期决策程序 D5 推导后回填，研究阶段不得自行拍板）。
+> 无来源标注视为未完成。
+
+## 板块研究画像（SRP）索引 —— 每个通过版规的板块一节
+
+| 板块 | SRPMode | samplingFrame | 窗口起止 | fetchedN | dedupedN | eligibleN | excludedByReason | unknownFlairN | flair 分布分母 | 主导 flair（share） | lowSignalFlairs | flairBoundaryNotes | removalStats（mod/自删/unknown） | claimScope | confidence | computedAt | profileId·revisionId |
+|---|---|---|---|---:|---:|---:|---|---:|---:|---|---|---|---|---|---|---|---|
+| r/xxx | Full | FullWindow | 2025-08-01 ~ 2026-08-01 | 1200 | 1050 | 936 | Removed 60 / Deleted 40 / ModPost 14 | 22 | eligibleN=936 | General Question 28.1% | Watches(17帖), Appraisal(5帖) | Showcase 与 Haul 两可 → 按「有无购买叙事」归类 | 3% / 5% / 2% | Population | Verified | 2026-08-12 | srp-… · r3 |
+
+> 全窗口 flair 分布必须给出**显式声明的分母**（默认 `eligibleN`），并逐 flair 给 `count` + `share`；
+> `Unknown` 作为显式 bucket 出现。分母不变量（`fetchedN ≥ dedupedN ≥ eligibleN`，
+> `dedupedN = eligibleN + Σ excludedByReason`，`unknownFlairN ⊆ eligibleN`）任一不成立 → `Insufficient`。
+> **禁止**用 top-N 样本的比例填这张表。无 SRP 的板块此表填 `SRPMode: Fallback` 一行，其余列填「—」；
+> 有 SRP 但 `confidence: Insufficient` 的填 `SRPMode: Insufficient`，**不得**改写成 Fallback。
+
 ## 合规风控摘要（reddit-subreddit-compliance · 每板块 ComplianceDetectionSummary 摘录）
 - r/xxx: Fit=High / OverallRisk=Low / AccountGate=Unknown / RulesEvidenceStatus=Provided / Recommendation=可尝试
 - r/yyy: Fit=Medium / OverallRisk=Medium / RiskTriggerSummary=self-promotion / Recommendation=谨慎尝试
@@ -419,10 +476,17 @@ Phase 0.5 门禁自查：
 [ ] 每周访客数/每周贡献数/每周活跃用户来自 about-page 的 `weekly_visitors` / `weekly_contributions` / `weekly_active_users`，无法取得时填「—」且未用 subscribers 冒充
 [ ] 每个候选板块已产出 ComplianceDetectionSummary（Fit / OverallRisk / EvidenceCompleteness / AccountGate）
 [ ] VerifiedCandidates / NeedsVerificationCandidates / NotRecommended 三层已划分；不合规板块已标注「过滤」并说明原因
-[ ] 补充条例 a 已执行：板块选取优先版规与风控，非仅按访客数；已为每个通过风控的板块计算频率建议
+[ ] 补充条例 a（板块选取硬规则）已执行：板块选取优先版规与风控，非仅按访客数
 [ ] 待验证板块已单独列出，默认不进入 Phase 4 执行表
-[ ] 每个通过版规的板块已完成 score 梯队划分（4 档）
-[ ] 存活 ≥ 3 个月的帖已提取，帖型/内容方向/语气/语境已学习
+[ ] 【步骤 0.5.5】每个通过版规的板块已按 SRP 契约 S1–S9 产出或复用 SubredditResearchProfile；
+    分母三件套（fetchedN / dedupedN / eligibleN）+ excludedByReason + unknownFlairN 齐全且不变量成立；
+    flairDistribution 逐项含 count + share 且分母显式声明、Unknown 为显式 bucket；
+    samplingFrame 与逐字段 claimScope 已标；lowSignalFlairs / flairBoundaryNotes / confidence / lineage 齐全
+[ ] 每个板块已声明 SRPMode（Full / Provisional / Fallback / Insufficient）；Fallback（无画像）与 Insufficient（画像不可信）未混用
+[ ] 无任何占比类结论来自 top-N 样本；top 采样仅用于定性观察与排名档位，未写成百分比档位
+[ ] 【补充条例 a-F】仅对 SRPMode=Fallback 的板块使用兜底默认表取频率，且已逐处标 FallbackOnly；
+    未用该表反推 P-B / C-B 配比（配额语义未被改动）
+[ ] 存活 ≥ 3 个月的帖已提取，帖型/内容方向/语气/语境已学习（定性，不产出占比）
 [ ] 存活 ≥ 1 年的帖已标注「★ 长期有效参考」
 [ ] 【步骤 0.5.5b】Ask AI 帖型权重分析已执行（品牌/SKU/品类/Prompt 4维度查询；或已记录跳过原因：浏览器MCP不可用/Geoly Prompt待建），引用帖型分布已写入 phase0.5-board-analysis.md「Ask AI 引用帖型分析」节
 [ ] 候选板块分析报告已展示（含 Ask AI 权重调整建议），用户已确认

package/skills/reddit-strategy-orchestrator/SKILL.md

@@ -20,23 +20,28 @@ Read the installed `reddit-strategy-shared` references before doing any full-flo
 - `~/.cursor/skills/reddit-strategy-shared/references/safety-rules.md`
 - Windows equivalents live under `$HOME\.cursor\skills\reddit-strategy-shared\references\`.
 
-For full-flow projects, also read these prerequisite files before Phase 0 — **as background only**.
-
-> **`LegacyStatus: Superseded` (v2.12.25).** These files preserve historical SOP
-> background. Do **not** execute any gate, schema, or structure rule found in
-> them: their four-part body structure, title formulas, format prohibition lists,
-> and 14-field execution table are all superseded. Structure comes from
-> `content-type-routing-contract.md` + the `StructureFamily` library; the
-> execution table is 16 core + 3 audit columns verified by
-> `phase406_verify.py`; per-post checks come from the three-layer final
-> checklist in `reddit-content-rewrite`. Where these files conflict with the
-> shared contracts above, the shared contracts win — and a conflict is not a
-> judgment call, the legacy text is simply not authoritative.
-
-- `~/.cursor/skills/reddit-strategy-shared/references/prerequisites/reddit-strategy-prerequisites-read.md`
-- `~/.cursor/skills/reddit-strategy-shared/references/prerequisites/reddit-strategy-reuse-playbook.md`
-- `~/.cursor/skills/reddit-strategy-shared/references/prerequisites/reddit-sop-v2-universal.md`
-- `~/.cursor/skills/reddit-strategy-shared/references/prerequisites/reddit-master-canvas-agent-prompt-template.md`
+**That list is the complete mandatory read. There is no prerequisite reading pack.**
+
+The four legacy SOP files that used to be force-read here
+(`reddit-strategy-prerequisites-read.md`, `reddit-strategy-reuse-playbook.md`,
+`reddit-sop-v2-universal.md`, `reddit-master-canvas-agent-prompt-template.md`
+— 1,994 lines, all `LegacyStatus: Superseded`) have moved to
+`reddit-strategy-shared/references/prerequisites/archive/`. **`archive/` is
+`AgentReadPolicy: DoNotRead` — human reference only.** Do not read it, do not
+cite it, and do not treat anything in it as a gate, schema, field list,
+structure rule, or writing spec.
+
+Every operative rule it contained now has an authoritative active version,
+including the two that were briefly ownerless: contract 「量」 unit conversion
+(`reddit-phase-planning/references/phase4-planning.md` step 4.0.0.0) and the
+external-comment A/B readout rule (same file, Phase 4.0.5). Read the active
+file; never go back to the archive for them. (The sibling
+`prerequisites/README.md` is a plain index of that authority mapping and is
+readable — it is the one file in `prerequisites/` not covered by DoNotRead —
+but reading it is optional, not a step.)
+
+`PrerequisitesRead:` in the output block is therefore always
+`N/A (archived v2.12.31)`.
 
 ## When To Use This Skill
 
@@ -76,6 +81,9 @@ Before Phase 0, collect or confirm:
 
 If required startup context is missing, stop and ask for it. Do not jump into Phase 0.
 
+Startup also owns Human Decision Points **#1 (优化目标权重)** — see
+`Human Decision Points — 必须停下来问人` below and ask it together with the list above.
+
 ## Phase Orchestration
 
 1. Shared context
@@ -86,6 +94,7 @@ If required startup context is missing, stop and ask for it. Do not jump into Ph
    - Skill: `reddit-phase-research`
    - Covers: Phase 0, 0.5, 1, 1.5, 1.6, 2
    - Must call or consume: `reddit-voc-volume`, `reddit-subreddit-compliance`, `kg-reddit-check` reference
+   - Human Decision Points: **#2, #5** (plus **#3, #4** when a subreddit profile is built)
 
 3. Planning
    - Skill: `reddit-phase-planning`
@@ -99,6 +108,7 @@ If required startup context is missing, stop and ask for it. Do not jump into Ph
      `StructureFamily` is not lockable.
    - Phase 4.0.5 fills B-group fanout.
    - Phase 4.0.6 runs SKU/brand-word verification and creates the batch map.
+   - Human Decision Points: **#6, #7, #8, #9** — #9 must be answered before the execution table can be locked
 
 4. Brief
    - Skill: `reddit-phase-brief`
@@ -106,6 +116,7 @@ If required startup context is missing, stop and ask for it. Do not jump into Ph
    - Requires: locked execution table, SKU baseline, board quantity plan, SKU/brand mapping, batch map
    - Produces: `memory/phase4-撰写brief.md` and `memory/phase4-内容排期表.md`
    - Gate: client mode requires `Brief 已通过`; internal mode requires `确认 Brief · 可动笔`
+   - Human Decision Points: **#10, #11**
 
 5. Brand-risk review
    - Skill: `reddit-brand-risk-response`
@@ -121,6 +132,7 @@ If required startup context is missing, stop and ask for it. Do not jump into Ph
 7. Delivery
    - Skill: `reddit-delivery-check`
    - Requires: all planned drafts, verification output, and a `pass` record for every post/comment in `memory/content-review-log.md`
+   - Human Decision Points: **#12**
 
 8. Renewal
    - Skill: `reddit-monthly-iteration`
@@ -140,6 +152,92 @@ If required startup context is missing, stop and ask for it. Do not jump into Ph
 - External comments require `reddit-ext-post-audit`.
 - The writing/rewrite output gate is strict: `social-hub content post-review` for posts and `social-hub content review` for comments/replies. Apply `revise` feedback and rerun. If no final account is selected, use ContentOnly with no `accountId`; this can pass content review but must remain `ReadyForDelivery: No`. For final delivery, rerun AccountBound with the real account and resolve any `brandFitReviewRequired` / blocking account feedback. Hub unavailable/degraded is not a pass.
 - Delivery cannot pass with missing batches, placeholders, or schema mismatches.
+- Every phase must clear its Human Decision Points before handing off: either an answer, or the recorded safe default plus an entry in `HumanDecisionsOpen`. Silently choosing for the user is a gate failure.
+- Human Decision Point **#6** (lifecycle authenticity) and the contract-conflict branch of **#10** are hard blocks — their safe default forbids the output, it does not downgrade it.
+- Never read `reddit-strategy-shared/references/prerequisites/archive/` (`AgentReadPolicy: DoNotRead`). Citing archived legacy SOP text as a rule is a gate failure. The sibling `prerequisites/README.md` is an index only — readable, but never a required step and never a rule source.
+
+## Human Decision Points — 必须停下来问人
+
+**立场（先读这一段）：** 下面 12 条**不能自动化，这是设计的一部分，不是缺陷。**
+它们是商业偏好、客户意图、领域判断和风险胃口——没有任何数据源能替人回答。
+SOP 的价值不在于消灭它们，而在于让它们**在正确的时刻、以正确的粒度被问出来**，
+并且在没拿到答案时有一个**明确的安全默认**——大多数条目的默认是「继续走，但降低
+承诺强度」；少数几条（#1 #6 #9 #10合同分支 #12）的默认就是**停下等人**，因为替人
+拍板的代价比停下来高。**默认的作用是消灭"瞎猜"，不是消灭"停"。**
+
+**怎么用：**
+
+1. 走到某一阶段时，先扫本表属于该阶段的行。命中就**停下来，一次性问清**（同阶段
+   的多条合并成一次提问，不要挤牙膏）。
+2. 问了没得到答案（用户不在、说"你定"、明确 defer）→ **落安全默认，不追问第二次**。
+3. 同一条被答过一次就**锁定并写进 memory**，后续阶段不得重问，也不得偷偷改判。
+
+**记录格式（12 条全部登记进 `HumanDecisions`；其中 `status: defaulted` 的子集
+另外汇总进 `HumanDecisionsOpen`，`answered` / `not-applicable` 不属于 open）：**
+
+```
+- id: <1-12>
+  status: answered | defaulted | not-applicable
+  decision: <答案，或所落的安全默认>
+  impact: <如果答案不同会改变什么>
+```
+
+**与既有 handoff 字段的接法（避免二义）：**
+
+字段层级先分清：`BlockingGaps` / `ReadyForNextPhase` 是
+`handoff-schemas.md` 定义的**本地 handoff 字段**，由你填；`blockingIssues` /
+`readyForNextSkill` 是 **Hub `handoff-create` 响应字段**，由服务端裁定，是最终
+phase gate。下面说的都是**本地字段**——本节不新增、不覆盖任何 Hub 语义，Hub
+返回 not-ready 时以 Hub 为准。
+
+- `not-applicable` → 不影响 `ReadyForNextPhase`。
+- `defaulted` → **一般仍可 `ReadyForNextPhase: Yes`**（安全默认只降低承诺强度），
+  该条同时进交付物的 Verification Boundaries。**两个例外见下。**
+- **`defaulted` 且属于 #6 / #10 合同冲突分支 / #12 → 必写 `BlockingGaps`，
+  `ReadyForNextPhase: No`：**
+  - **#6** 生命周期真实性（无证据的第一人称经历叙事 = 编造，不能降级）
+  - **#10** 的合同冲突分支（社区证据与合同硬性要求正面冲突 = 违约风险，须业务方裁决）
+  - **#12** 陈旧/残缺证据（交付判定本身就是商业决策）
+- **`defaulted` 且属于 #8，且 planning 侧记了 `D6Status: AwaitingHDP8`
+  （任一「合规已解但高风险」板块——探索位或普通分配位——的篇数无法重分配，
+  方案仍必须保留它）→ 同样按审批型阻断处理：`ReadyForNextPhase: No`，
+  `BlockingGaps` 写 `awaiting-approval: HDP#8`。** 若重分配成功（只记
+  `D7Status: AwaitingHDP8`，该探索位被排除出 `LockedPlanID`），#8 仍留在
+  `HumanDecisionsOpen`、交付物标 `Incomplete`，但**不阻断**交棒。
+- **`defaulted` 且属于 #1 / #9 → `ReadyForNextPhase: No`，
+  `BlockingGaps` 写 `awaiting-approval: HDP#1` / `HDP#9`。** 这两条是**审批型阻断**，
+  不是流程 bug：它们的安全默认「不锁板块配比 / 不锁执行表」会让流程停在
+  **Phase 4.0 锁表边界**——这是**故意的**，配比与取整没有客观最优解，没人拍板就不该
+  有人替他拍。正确行为是**照常产出加权草案 + 取整敏感项清单**然后停，不要为了让流程
+  "跑完"而自选一组整数。
+- **`answered` 不自动解除阻断。** 拿到答案只是补上了「人的判断」这一环；#6 仍需真实
+  证据、#10 合同分支仍需业务方书面裁决、#12 仍需既有 Hub waiver 或补齐证据。
+  答案与证据/waiver 都到齐，才可把该条移出 `BlockingGaps`。
+**收尾要求：**
+
+- `HumanDecisionsOpen` 非空（即存在 `defaulted` 条目）时，交付物必须标 `Incomplete`。
+- 交付前 12 条都必须在 `HumanDecisions` 里有 status，**不允许缺条**；没遇到就写
+  `not-applicable`，不能省略。
+
+| #   | 阶段       | 判断                   | 为什么不能自动化                                                         | 问什么                                                                       | 无答案时的安全默认                                                             |
+| --- | ---------- | ---------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| 1   | 启动       | 优化目标权重           | 覆盖 / 存活 / GEO / SKU 配额之间的取舍是商业偏好，没有客观最优解         | 「这一轮首要目标是什么？覆盖面、账号存活、GEO 引用、还是 SKU 配额？排个序」   | **不锁板块配比**；只出候选板块与各自取舍，不写死每板块条数                     |
+| 2   | Research   | 商品类别边界           | 品类归属是营销判断（wallet chain 算 jewelry 还是 streetwear accessory）  | 「这个品算哪个品类？边界上的这几个板块算不算目标人群？」                     | **排除弱相关板块**；只保留强相关，被排除项列入 Verification Boundaries         |
+| 3   | Profile    | flair 语义边界         | 是否合并需要领域知识（如 Chains 与 Question 是不是一回事）               | 「这几个 flair 在你们口径里是同一类吗？能不能合并统计？」                    | **保留原始 flair，不合并**；无法归类的记 `Unknown`，占比单列                   |
+| 4   | Profile    | 时间代表性             | 旺季、板块改版、版规变更无法从样本自证——样本看不见自己所处的时段        | 「这段窗口有没有旺季 / 版规变更 / 板块改版？要不要换窗口重采？」              | **分段报告**（按时间切片给结论），**不宣称长期稳定**                           |
+| 5   | Research   | 因果解读               | 「高分帖的共同特征」→「这就是它高分的原因」是推断跃迁，样本不支持       | 「这条特征你们要当因果用吗？还是只当相关性参考？」                           | **只写相关性**；禁止在 Master / Brief 里写成"因为 X 所以高分"                  |
+| 6   | Planning   | 生命周期真实性         | 阶段名（到货 / 用了三个月）不能证明这段经历真的发生过                    | 「这批账号有没有真实的购买 / 到货 / 使用记录？能出示吗？」                   | ⛔ **禁止无证据的第一人称到货 / 开箱 / 体验 / 长期使用断言**（硬阻断）。范围仅限第一人称经历主张——有据可查的规格对比、二手信息综述、公开评测转述不受影响，改走非体验型 `ContentFunction` / `EvidenceShape` 即可 |
+| 7   | Planning   | 搜索需求来源           | 一个搜索量数字的口径（地域、时间窗、工具、是否含长尾）无法自证           | 「这些搜索量是哪个工具、哪个地域、哪个时间窗导出的？能给原始文件吗？」       | **删除数字**，该来源**不参与配比计算**；保留定性方向并标来源未证实            |
+| 8   | Planning   | 风险预算               | 高删帖率板块要不要试投，是风险偏好，不是数据结论                         | 「这几个板块历史删帖率高，要不要试投？能承受几条被删？」                     | 分两种情形，**不要混为一谈**：①**合规未解**（compliance `NotRecommended` / 版规明确禁止 / 账号无资格）→ 配额 = 0，这与排期决策程序 D7 的「0 篇」判据同源，不是风险偏好问题；②**合规已解但风险高**（删帖率高 / 社区对推广敏感）→ **只出草案，不进执行表锁定**，其中也包括 D7 的 1 篇探索位（探索位需本条已答复才能锁表；未答复时它停在草案层） |
+| 9   | Planning   | 最终整数配比           | 从权重到整数条数的取舍（谁进位谁舍去）是人的偏好                         | 「按这个权重算出来是 X 板块 3.4 条，进位到 4 还是压到 3？」                  | **不锁执行表**；给出加权草案 + 取整敏感项清单，等确认                          |
+| 10  | Brief      | GEO 与社区冲突         | 品牌前置利于实体信号，但社区样本显示会被当广告——两个目标真实冲突        | 「标题前置品牌会提高 GEO 命中但拉高删帖风险，这轮偏哪边？合同有没有硬要求？」 | **优先存活**：品牌延后或不露面。若这会让 P-B / PGC 品牌词配额对不上，须**重排配额并重跑 Phase 4.0.6**，不得单方面破配额。**若合同硬性要求品牌前置 → 阻断，升级给业务方** |
+| 11  | Brief      | 卖点强度               | Required / Preferred / Optional 是客户意图，不是文案能推导的             | 「这几个卖点里哪些是必须出现的？哪些可有可无？」                             | **合同 / 客户材料里已明确写死的保持 Required；其余一律按 Optional 处理**，不得由 agent 自行把某个卖点升为 Required 去卡稿 |
+| 12  | Delivery   | 例外与陈旧证据         | 接不接受 stale / partial 交付，是商业决策（赶 deadline vs 等数据）       | 「这批证据已过期 / 缺 N 条，是照发还是等补齐？」                             | 标 `Incomplete`，**不发布、不排期**；列出缺口与补齐所需动作                    |
+
+**审计要求：** 每次全流程运行、每个阶段的 `HandoffContract` 都要带
+`HumanDecisionsAsked`（本阶段问过哪几条）与 `HumanDecisionsOpen`（还挂着哪几条
+`defaulted`）。两个字段都不得省略；本阶段无相关条目时显式写
+`None (阶段 X 未涉及)`。
 
 ## Output Format
 
@@ -149,12 +247,14 @@ For a full-flow startup request:
 ## RedditStrategyRoute
 - Mode: FullWorkflow
 - SharedFilesToRead:
-- PrerequisitesRead:
+- PrerequisitesRead: N/A (archived v2.12.31)
 - StartupVariables:
 - MissingInputs:
 - PhasePlan:
 - FirstSkillToRun:
 - BlockingGate:
+- HumanDecisionsAsked:
+- HumanDecisionsOpen:
 - DeliveryTarget:
 - ABTestPlan:
 ```
@@ -180,5 +280,7 @@ End every orchestrated phase with:
 - MemoryFilesRequired:
 - RequiredFields:
 - BlockingGaps:
+- HumanDecisionsAsked:
+- HumanDecisionsOpen:
 - ReadyForNextSkill: Yes / No
 ```

package/skills/reddit-strategy-shared/SKILL.md

@@ -12,6 +12,7 @@ This skill is the shared contract layer for the Reddit skill matrix. Read it bef
 
 - Defines the skill routing matrix.
 - Defines source-of-truth rules for facts, positioning, client constraints, Reddit samples, and subreddit compliance.
+- Defines the SubredditResearchProfile (SRP) contract for subreddit-level research profiles, and the evidence gates `G3` / `G5` / `G6`.
 - Defines required memory files and handoff fields.
 - Defines the mandatory Social Hub post/comment review gate for generated content.
 - Defines the ContentOnly and AccountBound review modes.
@@ -37,14 +38,15 @@ planning, brief, writing, rewrite, or delivery task**, not on-demand.
 - `references/content-type-routing-contract.md` for the mapping chain `客户内容原型 → skill 主帖型 → StructureFamily → rewrite route`, the ordered StructureFamily selection rule, and the hard stop on unmapped client prototype codes. **Mandatory.**
 - `references/content-diversity-contract.md` for fingerprint fields, the rolling-window collision rule, exception approval, `SampleSetID`, draft hash, and the four enforcement layers. **Mandatory.**
 - `references/routing.md` for deciding which matrix skill should handle a user request.
-- `references/evidence-policy.md` for source priority and conflict resolution.
+- `references/evidence-policy.md` for source priority, conflict resolution, and the evidence gates `G3` (URL 存活状态三字段), `G5` (来源职责矩阵), `G6` (fail-closed 适用面与例外).
+- `references/subreddit-research-profile.md` for the **SubredditResearchProfile (SRP)** contract — schema, sampling-frame rules (`TopN` may not carry `flairDistribution`), denominator invariants, `claimScope`, per-field TTL, the S1–S9 procedure, and the skill-freezes-contract / Hub-stores-instances split. **Required reading for any research, compliance, brief, or planning task that consumes subreddit-level conclusions.** SRP does not decide subreddit eligibility — `reddit-subreddit-compliance` still does.
 - `references/handoff-schemas.md` for required memory and output contracts.
 - `references/context-contract.md` for startup variables and project memory layout.
 - `references/content-review-gate.md` for the mandatory Hub review, revision loop, and memory record.
 - `references/safety-rules.md` for Feishu, Geoly, Reddit, evidence, and phase-control safety gates.
 - `references/path-conventions.md` for macOS/Linux and Windows installed skill paths.
 - `references/version-manifest.md` for matrix package contents and copied skill sources.
-- `references/prerequisites/` when a full-flow project needs the legacy SOP background files. **These are `LegacyStatus: Superseded` background only — never a writing or planning gate.** Their four-paragraph body structure, title formulas, format checklists, and 14-field execution table were deleted in v2.12.25; see the legacy-scope table in `references/context-contract.md` for what replaced each.
+- `references/prerequisites/README.md` 是**索引，不含规则**：可读，但**不是必读**，也不得当作规则来源（主要用于人工查阅历史背景与「谁是权威」的转发）。该目录下的 `archive/` 是 `AgentReadPolicy: DoNotRead` —— 四份 legacy SOP 文件已归档，**agent 不得读取、不得引用，引用即 gate failure**。它们的四段式正文结构、标题公式、格式清单与 14 字段执行表已在 v2.12.25 删除；替代关系见 `references/context-contract.md` 的 legacy-scope 表。
 
 ## Core Rule
 

package/skills/reddit-strategy-shared/references/content-diversity-contract.md

@@ -260,9 +260,25 @@ FixOwnerSkill: reddit-phase-brief
 6. 对该文本取小写十六进制 SHA-256，取前 8 位。
 
 对应 baseline manifest 至少包含：subreddit、`AcquiredAt`、`BaselineMaxAgeDays`、
-`ValidUntil`、query/sort/时间范围、URL 列表、有效样本数、word count 中位数 + IQR、
-段落数中位数、标题长度与句式分布、列表/小标题使用率、品牌首次出现位置分布、
-提问式结尾比例、是否常见 TL;DR、第一人称比例、评测帖与问题帖长度差异。
+`ValidUntil`、query/sort/时间范围、URL 列表、有效样本数，以及**全部 10 个风格维度**
+（缺任一项 = `BaselineStatus: Incomplete`，不得用默认值顶替）：
+
+1. word count 中位数 + IQR
+2. 段落数中位数
+3. 标题长度与句式分布
+4. 列表 / 小标题使用率
+5. 品牌首次出现位置分布（四档直方图 + `ComparableSampleCount` + `BrandMentionSampleCount` +
+   `NoBrandMentionRate`；「不出现」不是直方图的一档）
+6. 提问式结尾比例
+7. 是否常见 TL;DR
+8. 第一人称比例
+9. 评测帖与问题帖长度差异
+10. **破折号 / 括号使用分布**（频次或使用率）—— 标点冲突消解依据，不设跨板块统一禁令
+
+> 第 10 项与前 9 项同权：它进 manifest，因此它的变化**改变 `SampleSetID`**。
+> 维度清单的权威副本是 writing 侧 `reddit-content-writing/references/phase4-writing.md` 的
+> W-1.b 表与 `reddit-phase-brief/references/phase4-brief-workflow.md` 步骤 B-1.0；
+> 三处必须一致，共 10 项，不是 9 项。
 
 > **避免自引用：** 规范化 hash 的输入**排除**派生字段 `ManifestSha256` 与
 > `SampleSetID` 本身。先对不含这两项的规范化文本取 SHA-256，再把完整 hash 与

package/skills/reddit-strategy-shared/references/context-contract.md

@@ -12,7 +12,8 @@ Full-flow strategy work must collect or confirm:
 - Deliverable type and volume
 - Delivery target: Feishu folder/doc link, local Markdown only, or both
 - Whether strict A/B testing is required
-- If A/B is required: single test variable, A/B group symmetry, and whether external comments are excluded from the main A/B sample
+- If A/B is required: single test variable, A/B group symmetry, and whether external comments are excluded from the main A/B sample (**default: excluded** — external comments are supplementary observation only; readout rule in `reddit-phase-planning/references/phase4-planning.md` Phase 4.0.5)
+- Contract pricing unit: whether the contract is priced in 「量」(a unit that bundles posts and self-comments, e.g. 1 post + 3 self-comments = 1 unit — posts and comments are not the same cost unit and are never simply summed) or in direct post/comment counts; plus the total allowance and the confirmation source (Phase 4.0.0.0 blocks the quantity plan until this is confirmed; never assume an example ratio)
 - Whether competitor mentions are allowed
 - Review mode when content is generated: ContentOnly if the final publishing account is not selected; AccountBound only after the real account and approved brand context are known
 - Brief approval mode: client review first, internal confirmation only, or unknown
@@ -24,19 +25,40 @@ Full-flow strategy work must collect or confirm:
 
 ## Startup Prerequisites
 
-For full-flow projects, read the shared contracts first, then read these restored prerequisite files before Phase 0:
-
-- `reddit-strategy-prerequisites-read.md`
-- `reddit-strategy-reuse-playbook.md`
-- `reddit-sop-v2-universal.md`
-- `reddit-master-canvas-agent-prompt-template.md`
-
-These files are required background references for full-flow projects, not the source of current conflict resolution. If they conflict with `evidence-policy.md`, `safety-rules.md`, `handoff-schemas.md`, or this context contract, the shared matrix contracts win.
+For full-flow projects, read the shared contracts (`routing.md`, `evidence-policy.md`,
+`context-contract.md`, `handoff-schemas.md`, `safety-rules.md`) — **and nothing else** before Phase 0.
+
+**Phase-scoped contracts (read on entering the phase that consumes them, not at startup):**
+
+| Contract | Read before | Owner / consumers |
+|---|---|---|
+| `references/content-type-routing-contract.md` | Phase 4 Brief structure routing | brief / writing / rewrite / delivery |
+| `references/content-diversity-contract.md` | Phase 4 Brief baseline + fingerprint | brief / writing / rewrite / delivery |
+| `references/subreddit-research-profile.md` (SRP) | Phase 0.5 step 0.5.5, and any compliance / brief / planning step that consumes subreddit-level conclusions | research produces; compliance / planning / brief consume |
+| `reddit-phase-planning/references/scheduling-decision-procedure.md` (D1–D7) | Phase 4.0.0.4 board quantity planning | planning owns; brief reads `memory/phase4-排期决策台账.md`, not the procedure |
+
+Keeping these out of the startup read is deliberate: the startup budget is the five
+shared contracts above. Loading a phase contract early is not a gate failure, but
+skipping it when its phase starts is.
+
+> **⛔ 那四份 prerequisite 文件已归档，agent 不得读取。**
+> `reddit-strategy-prerequisites-read.md` / `reddit-strategy-reuse-playbook.md` /
+> `reddit-sop-v2-universal.md` / `reddit-master-canvas-agent-prompt-template.md` 已移入
+> `references/prerequisites/archive/`（`AgentReadPolicy: DoNotRead`）。
+>
+> **为什么**：这四份共 1,994 行，占全流程强制阅读量的 80%，而它们自己声明
+> `LegacyStatus: Superseded`、"Do not execute any gate, schema, or structure rule found in them"
+> —— 同时其中的规则又与 active 文件里的硬规则**逐条重复**。一份"声明不作数、内容却一致"的
+> 文本进入上下文，模型无从区分哪句该执行，只会稀释真正的门禁。
+>
+> 需要人工查阅历史背景时见 `references/prerequisites/README.md`（该 README 可读、非必读，
+> 只做转发与真空登记）。**active 文档不得再要求 agent 读取 archive 内容，引用即 gate failure。**
 
 **v2.12.25 legacy scope (binding).** `reddit-strategy-reuse-playbook.md` and
 `reddit-sop-v2-universal.md` are marked `LegacyStatus: Superseded` /
-`UseAsWritingGate: No` / `UseAsPlanningGate: No`. Read them for background only.
-Never take from them: post structure, opening-sentence form, title formulas,
+`UseAsWritingGate: No` / `UseAsPlanningGate: No`, and they are now under
+`prerequisites/archive/` with `AgentReadPolicy: DoNotRead` — **agents do not read
+them at all** (human historical reference only). Never take from them: post structure, opening-sentence form, title formulas,
 per-paragraph format checklists, or the execution-table schema. Their
 four-paragraph body structure, title-formula section, format-prohibition
 checklist, and 14-field table were **deleted** in v2.12.25. The replacements are:
@@ -61,6 +83,7 @@ Use `memory/` as the working truth store:
 - `phase2-缺口分析.md`
 - `phase3-master-canvas摘要.md`
 - `phase4-board-quantity-plan.md`
+- `phase4-排期决策台账.md`
 - `phase4-sku-基准表.md`
 - `phase4-执行表.md`
 - `phase4-external-post-audit.md`
@@ -88,6 +111,17 @@ Use `memory/` as the working truth store:
 - Phase 2 must write `phase2-缺口分析.md`.
 - Phase 3 must write `phase3-master-canvas摘要.md` and confirm all 21 Master Canvas boards.
 - Phase 4.0.0 must write `phase4-board-quantity-plan.md` and `phase4-sku-基准表.md`.
+- Phase 4.0.0.4 must run the D1–D7 scheduling decision procedure
+  (`reddit-phase-planning/references/scheduling-decision-procedure.md`) and write
+  `phase4-排期决策台账.md`: one row per planned post keyed by execution-table `Key`, all 9 fields
+  present, including `ProposedFlair` (the execution table has no flair column). Owner:
+  `reddit-phase-planning`. `reddit-phase-brief` reads it to verify and lock `AssignedFlair`;
+  a missing ledger or `ProposedFlair` is a `BlockingGap` back to planning, not a licence for the
+  Brief to pick its own flair.
+- Phase 0.5 step 0.5.5 must produce one `SubredditResearchProfile`
+  (`references/subreddit-research-profile.md`) per passing subreddit alongside
+  `phase0.5-board-analysis.md`; boards with no SRP are declared `SRPMode: Fallback` downstream,
+  which is **not** the same as `confidence: Insufficient`.
 - Phase 4.0 must write `phase4-执行表.md`; if external comment URLs exist, EPA results must be recorded in `phase4-external-post-audit.md` or as an `外部核验` control column.
 - Phase 4.0.6 must write `phase4-SKU品牌词映射.md` and `phase4-撰写批次map.md`.
 - Phase 4 Brief must write `phase4-内容排期表.md` and `phase4-撰写brief.md`; writing cannot start until the required Brief approval phrase is present.