|
|
@@ -1,18 +1,27 @@
|
|
|
---
|
|
|
name: reader-pull-checker
|
|
|
-description: 追读力检查器，评估钩子兑现/新增期待/模式重复，输出结构化报告
|
|
|
-tools: Read, Grep
|
|
|
+description: 追读力检查器 v5.3，评估钩子/微兑现/约束分层，支持Override Contract
|
|
|
+tools: Read, Grep, Bash
|
|
|
---
|
|
|
|
|
|
-# reader-pull-checker (追读力检查器)
|
|
|
+# reader-pull-checker (追读力检查器) v5.3
|
|
|
|
|
|
-> **Role**: 审查“读者为什么会点下一章”。
|
|
|
+> **Role**: 审查"读者为什么会点下一章"，执行 Hard/Soft 约束分层。
|
|
|
+
|
|
|
+## 核心参考
|
|
|
+
|
|
|
+- **Taxonomy**: `.claude/references/reading-power-taxonomy.md`
|
|
|
+- **Genre Profile**: `.claude/references/genre-profiles.md`
|
|
|
+- **章节追读力数据**: `index.db → chapter_reading_power`
|
|
|
+- **上章钩子**: `state.json → chapter_meta` 或 `index.db`
|
|
|
|
|
|
## 输入
|
|
|
- 章节正文（`正文/第{NNNN}章.md`）
|
|
|
-- 上章钩子与模式（从 `state.json → chapter_meta`）
|
|
|
+- 上章钩子与模式（从 `state.json → chapter_meta` 或 `index.db`）
|
|
|
+- 题材 Profile（从 `state.json → project.genre`）
|
|
|
+- 是否为过渡章标记
|
|
|
|
|
|
-## 输出格式（与其他 checker 对齐）
|
|
|
+## 输出格式（v5.3 增强）
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
@@ -20,76 +29,282 @@ tools: Read, Grep
|
|
|
"chapter": 100,
|
|
|
"overall_score": 85,
|
|
|
"pass": true,
|
|
|
- "issues": [
|
|
|
+ "hard_violations": [],
|
|
|
+ "soft_suggestions": [
|
|
|
{
|
|
|
- "type": "WEAK_HOOK",
|
|
|
- "severity": "high",
|
|
|
+ "id": "SOFT_HOOK_STRENGTH",
|
|
|
+ "severity": "medium",
|
|
|
"location": "章末",
|
|
|
- "description": "钩子强度不足",
|
|
|
- "suggestion": "将‘回去休息了’改为悬念/危机"
|
|
|
+ "description": "钩子强度为weak，建议提升至medium",
|
|
|
+ "suggestion": "将'回去休息了'改为悬念/危机",
|
|
|
+ "can_override": true,
|
|
|
+ "allowed_rationales": ["TRANSITIONAL_SETUP", "CHARACTER_CREDIBILITY"]
|
|
|
}
|
|
|
],
|
|
|
+ "issues": [],
|
|
|
"metrics": {
|
|
|
"hook_present": true,
|
|
|
- "hook_type": "期待钩",
|
|
|
+ "hook_type": "渴望钩",
|
|
|
"hook_strength": "medium",
|
|
|
"prev_hook_fulfilled": true,
|
|
|
"new_expectations": 2,
|
|
|
- "pattern_repeat": false,
|
|
|
- "next_chapter_reason": "读者想知道云芝找萧炎什么事"
|
|
|
- }
|
|
|
+ "pattern_repeat_risk": false,
|
|
|
+ "micropayoffs": ["能力兑现", "认可兑现"],
|
|
|
+ "micropayoff_count": 2,
|
|
|
+ "is_transition": false,
|
|
|
+ "next_chapter_reason": "读者想知道云芝找萧炎什么事",
|
|
|
+ "debt_balance": 0.0
|
|
|
+ },
|
|
|
+ "override_eligible": true
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-## 检查项与权重
|
|
|
+---
|
|
|
|
|
|
-| 检查项 | 权重 | 问题类型 |
|
|
|
-|--------|------|----------|
|
|
|
-| 章末钩子存在 | 30% | NO_HOOK (critical) |
|
|
|
-| 钩子强度适当 | 20% | WEAK_HOOK (high) |
|
|
|
-| 上章钩子兑现 | 20% | UNFULFILLED_HOOK (high) |
|
|
|
-| 模式不重复 | 15% | PATTERN_REPEAT (medium) |
|
|
|
-| 新增期待≤2个 | 15% | TOO_MANY_EXPECTATIONS (low) |
|
|
|
+## 一、约束分层
|
|
|
|
|
|
-## 钩子强度分级
|
|
|
+### 1.1 Hard Invariants（硬约束）
|
|
|
|
|
|
-| 强度 | 适用场景 | 示例 |
|
|
|
+> **违反 = MUST_FIX，不可申诉跳过**
|
|
|
+
|
|
|
+| ID | 约束名称 | 触发条件 | severity |
|
|
|
+|----|---------|---------|----------|
|
|
|
+| HARD-001 | 可读性底线 | 读者无法理解"发生了什么/谁/为什么" | critical |
|
|
|
+| HARD-002 | 承诺违背 | 上章明确承诺在本章完全无回应 | critical |
|
|
|
+| HARD-003 | 节奏灾难 | 连续N章无任何推进（N由profile决定） | critical |
|
|
|
+| HARD-004 | 冲突真空 | 整章无问题/目标/代价 | high |
|
|
|
+
|
|
|
+**Hard Violation 输出**:
|
|
|
+```json
|
|
|
+{
|
|
|
+ "id": "HARD-002",
|
|
|
+ "severity": "critical",
|
|
|
+ "location": "全章",
|
|
|
+ "description": "上章钩子'敌人即将到来'完全未在本章提及",
|
|
|
+ "must_fix": true,
|
|
|
+ "fix_suggestion": "在开头或中段回应敌人威胁"
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+### 1.2 Soft Guidance（软建议）
|
|
|
+
|
|
|
+> **违反 = 可申诉，但需记录 Override Contract 并承担债务**
|
|
|
+
|
|
|
+| ID | 约束名称 | 默认期望 | 可Override |
|
|
|
+|----|---------|---------|-----------|
|
|
|
+| SOFT_HOOK_STRENGTH | 钩子强度 | 题材profile baseline | ✓ |
|
|
|
+| SOFT_HOOK_TYPE | 钩子类型 | 匹配题材偏好 | ✓ |
|
|
|
+| SOFT_MICROPAYOFF | 微兑现数量 | ≥ profile.min_per_chapter | ✓ |
|
|
|
+| SOFT_PATTERN_REPEAT | 模式重复 | 避免连续3章同型 | ✓ |
|
|
|
+| SOFT_EXPECTATION_OVERLOAD | 期待过载 | 新增期待 ≤ 2 | ✓ |
|
|
|
+
|
|
|
+**Soft Suggestion 输出**:
|
|
|
+```json
|
|
|
+{
|
|
|
+ "id": "SOFT_MICROPAYOFF",
|
|
|
+ "severity": "medium",
|
|
|
+ "location": "全章",
|
|
|
+ "description": "本章微兑现0个，题材要求≥1",
|
|
|
+ "suggestion": "添加能力兑现或认可兑现",
|
|
|
+ "can_override": true,
|
|
|
+ "allowed_rationales": ["TRANSITIONAL_SETUP", "ARC_TIMING"]
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 二、钩子类型扩展（v5.3）
|
|
|
+
|
|
|
+### 2.1 完整钩子类型
|
|
|
+
|
|
|
+| 类型 | 标识 | 驱动力 |
|
|
|
+|------|------|--------|
|
|
|
+| 危机钩 | Crisis Hook | 危险逼近，读者担心 |
|
|
|
+| 悬念钩 | Mystery Hook | 信息缺口，读者好奇 |
|
|
|
+| 情绪钩 | Emotion Hook | 强情绪触发（愤怒/心疼/心动） |
|
|
|
+| 选择钩 | Choice Hook | 两难抉择，读者想知道选择 |
|
|
|
+| 渴望钩 | Desire Hook | 好事将至，读者期待 |
|
|
|
+
|
|
|
+### 2.2 钩子强度
|
|
|
+
|
|
|
+| 强度 | 适用场景 | 特征 |
|
|
|
|------|---------|------|
|
|
|
-| **strong** | 卷末、关键转折、大冲突前 | “门外站着的人，让萧炎瞳孔骤缩” |
|
|
|
-| **medium** | 普通剧情章 | “云芝说有事找他” |
|
|
|
-| **weak** | 过渡章、铺垫章 | “明天还有很多事要做” |
|
|
|
+| **strong** | 卷末/关键转折/大冲突前 | 读者必须立刻知道 |
|
|
|
+| **medium** | 普通剧情章 | 读者想知道，但可等 |
|
|
|
+| **weak** | 过渡章/铺垫章 | 维持阅读惯性 |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 三、微兑现检测（v5.3 新增）
|
|
|
+
|
|
|
+### 3.1 微兑现类型
|
|
|
+
|
|
|
+| 类型 | 识别信号 |
|
|
|
+|------|---------|
|
|
|
+| 信息兑现 | 揭示新信息/线索/真相 |
|
|
|
+| 关系兑现 | 关系推进/确认/变化 |
|
|
|
+| 能力兑现 | 能力提升/新技能展示 |
|
|
|
+| 资源兑现 | 获得物品/资源/财富 |
|
|
|
+| 认可兑现 | 获得认可/面子/地位 |
|
|
|
+| 情绪兑现 | 情绪释放/共鸣 |
|
|
|
+| 线索兑现 | 伏笔回收/推进 |
|
|
|
+
|
|
|
+### 3.2 检测规则
|
|
|
+
|
|
|
+1. 扫描正文识别微兑现
|
|
|
+2. 按题材profile检查数量是否达标
|
|
|
+3. 过渡章可降级要求
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 四、模式重复检测
|
|
|
+
|
|
|
+### 4.1 检测范围
|
|
|
+- 钩子类型：最近3章
|
|
|
+- 开头模式：最近3章
|
|
|
+- 爽点模式：最近5章
|
|
|
|
|
|
-## 评分规则
|
|
|
-- 85+ 分: PASS
|
|
|
-- 70-84 分: PASS with warnings
|
|
|
-- <70 分: FAIL
|
|
|
+### 4.2 风险等级
|
|
|
+- **warning**: 连续2章同型
|
|
|
+- **risk**: 连续3章同型
|
|
|
+- **critical**: 连续4+章同型
|
|
|
|
|
|
-## 执行步骤
|
|
|
+---
|
|
|
+
|
|
|
+## 五、Override Contract 机制
|
|
|
+
|
|
|
+### 5.1 何时可Override
|
|
|
+
|
|
|
+当 `soft_suggestions` 中的建议无法遵守时，可提交 Override Contract：
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "constraint_type": "SOFT_MICROPAYOFF",
|
|
|
+ "constraint_id": "micropayoff_count",
|
|
|
+ "rationale_type": "TRANSITIONAL_SETUP",
|
|
|
+ "rationale_text": "本章为铺垫章，下章将有大爽点",
|
|
|
+ "payback_plan": "下章补偿2个微兑现",
|
|
|
+ "due_chapter": 101
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+### 5.2 rationale_type 枚举
|
|
|
+
|
|
|
+| 类型 | 描述 | 债务影响 |
|
|
|
+|------|------|---------|
|
|
|
+| TRANSITIONAL_SETUP | 铺垫/过渡需要 | 标准 |
|
|
|
+| LOGIC_INTEGRITY | 剧情逻辑优先 | 减少 |
|
|
|
+| CHARACTER_CREDIBILITY | 人物可信度优先 | 减少 |
|
|
|
+| WORLD_RULE_CONSTRAINT | 设定约束 | 减少 |
|
|
|
+| ARC_TIMING | 长线节奏安排 | 标准 |
|
|
|
+| GENRE_CONVENTION | 题材惯例 | 标准 |
|
|
|
+| EDITORIAL_INTENT | 作者主观意图 | 增加 |
|
|
|
+
|
|
|
+### 5.3 债务与利息
|
|
|
+
|
|
|
+- 每个Override产生债务（量由题材profile的debt_multiplier决定）
|
|
|
+- 每章债务累积利息（默认10%/章）
|
|
|
+- 超过due_chapter未偿还，债务变为overdue
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 六、执行步骤
|
|
|
+
|
|
|
+### Step 1: 加载配置
|
|
|
+1. 读取题材Profile
|
|
|
+2. 读取上章钩子/模式记录
|
|
|
+3. 检查当前债务状态
|
|
|
+
|
|
|
+### Step 2: Hard Invariants 检查
|
|
|
+1. 检查可读性（关键信息完整性）
|
|
|
+2. 检查上章钩子兑现
|
|
|
+3. 检查节奏停滞
|
|
|
+4. 检查冲突存在
|
|
|
+
|
|
|
+**任何 Hard Violation → 立即标记 MUST_FIX**
|
|
|
+
|
|
|
+### Step 3: 钩子分析
|
|
|
+1. 识别章末钩子类型
|
|
|
+2. 评估钩子强度
|
|
|
+3. 对比题材偏好
|
|
|
+
|
|
|
+### Step 4: 微兑现扫描
|
|
|
+1. 识别章内微兑现
|
|
|
+2. 统计数量和类型
|
|
|
+3. 对比题材要求
|
|
|
+
|
|
|
+### Step 5: 模式重复检测
|
|
|
+1. 获取最近N章模式
|
|
|
+2. 检测钩子类型重复
|
|
|
+3. 检测开头模式重复
|
|
|
+
|
|
|
+### Step 6: Soft Guidance 评估
|
|
|
+1. 汇总所有软建议
|
|
|
+2. 标注可Override的建议
|
|
|
+3. 列出允许的rationale类型
|
|
|
+
|
|
|
+### Step 7: 生成报告
|
|
|
+1. 计算总分
|
|
|
+2. 输出结构化JSON
|
|
|
+3. 提供修复建议
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 七、评分规则
|
|
|
+
|
|
|
+### 7.1 Hard Violations
|
|
|
+- 任何 Hard Violation → 直接 FAIL
|
|
|
+- 必须修复后重新审核
|
|
|
+
|
|
|
+### 7.2 Soft Score（无Hard Violation时）
|
|
|
+
|
|
|
+| 得分 | 结果 |
|
|
|
+|------|------|
|
|
|
+| 85+ | PASS |
|
|
|
+| 70-84 | PASS with warnings |
|
|
|
+| 50-69 | CONDITIONAL（可通过Override）|
|
|
|
+| <50 | FAIL |
|
|
|
+
|
|
|
+### 7.3 Soft 得分计算
|
|
|
+
|
|
|
+| 检查项 | 权重 | 问题类型 |
|
|
|
+|--------|------|----------|
|
|
|
+| 章末钩子存在 | 25% | NO_HOOK |
|
|
|
+| 钩子强度适当 | 15% | WEAK_HOOK |
|
|
|
+| 微兑现达标 | 20% | LOW_MICROPAYOFF |
|
|
|
+| 模式不重复 | 15% | PATTERN_REPEAT |
|
|
|
+| 新增期待≤2个 | 10% | EXPECTATION_OVERLOAD |
|
|
|
+| 钩子类型匹配题材 | 15% | TYPE_MISMATCH |
|
|
|
+
|
|
|
+---
|
|
|
|
|
|
-1. **识别章末钩子**
|
|
|
- - 判断是否存在未闭合问题/危险逼近/信息反转
|
|
|
- - 标注类型与强度
|
|
|
+## 八、与 Data Agent 的交互
|
|
|
|
|
|
-2. **检查上章钩子兑现**
|
|
|
- - 读取 `chapter_meta[N-1].hook`
|
|
|
- - 判断本章是否接住或回应（直接推进/部分回应/完全忽略）
|
|
|
+审核完成后，由 Data Agent 执行：
|
|
|
|
|
|
-3. **新增期待计数**
|
|
|
- - 统计本章新抛出的“未解问题/悬念点”数量（建议 ≤2）
|
|
|
+1. **保存章节追读力元数据**
|
|
|
+ ```python
|
|
|
+ index_manager.save_chapter_reading_power(ChapterReadingPowerMeta(...))
|
|
|
+ ```
|
|
|
|
|
|
-4. **模式重复检测**
|
|
|
- - 对比 `chapter_meta[N-1..N-3].pattern`
|
|
|
- - 若本章开头/钩子类型与最近章重复，记为风险
|
|
|
+2. **处理 Override Contract**（如有）
|
|
|
+ ```python
|
|
|
+ index_manager.create_override_contract(OverrideContractMeta(...))
|
|
|
+ index_manager.create_debt(ChaseDebtMeta(...))
|
|
|
+ ```
|
|
|
|
|
|
-5. **输出“读者下章动机”**
|
|
|
- - 用一句话说明读者为什么点下一章
|
|
|
+3. **计算利息**（每章）
|
|
|
+ ```python
|
|
|
+ index_manager.accrue_interest(current_chapter)
|
|
|
+ ```
|
|
|
|
|
|
---
|
|
|
|
|
|
-## 成功标准
|
|
|
+## 九、成功标准
|
|
|
|
|
|
-- 章末钩子存在且强度匹配场景
|
|
|
-- 上章钩子有回应（直接/间接）
|
|
|
-- 新增期待不超过 2 个
|
|
|
-- 模式重复率低（最近 3 章避免同型）
|
|
|
-- 输出清晰的“下章动机”
|
|
|
+- [ ] 无 Hard Violations
|
|
|
+- [ ] Soft Score ≥ 70（或有有效Override）
|
|
|
+- [ ] 章末钩子存在且类型明确
|
|
|
+- [ ] 微兑现数量达标（或有Override）
|
|
|
+- [ ] 无连续3章以上同型
|
|
|
+- [ ] 输出清晰的"下章动机"
|
lingfengQAQ