---
name: generate-module-implementation-logic
description: 从 ReadViewSDK 真实源码生成或更新指定模块或场景的入口、调用链、数据流、状态流、渲染流、缓存、持久化、异步回调和异常分支文档。用户要求梳理实现逻辑、调用链、分页或缓存流程时使用；代码风格规范改用对应 code-style Skill。
---

# 生成模块实现逻辑

## 工作流

1. 确定目标模块、用户场景和输出路径；优先复用 `Doc/` 中现有专题或 code reference。
2. 读取目标入口、现有文档，以及 `AGENTS.md` 路由出的架构、API 或测试资料。
3. 用引用搜索沿真实关系追踪：
   - 页面、控制器、协议或服务入口及触发条件
   - 数据模型、状态所有者和线程/队列
   - EPUB 解析/排版/分页/章节窗口，或 PDF Provider/渲染/OCR/标注
   - 内存与磁盘缓存、键、版本、驱逐和恢复
   - 通知、回调、delegate、持久化和跨模块依赖
   - 空值、失败、取消、重试、超时、迟到结果和兼容分支
4. 对关键链路至少双向核验一次：从入口跟到结果，再从结果或回调查回调用方。
5. 区分当前实现、历史兼容层、仅文档中的计划和待确认事实。
6. 增量更新文档，保留正确内容，删除或标记失效链路。
7. 结论引用真实文件、类型和方法；不确定信息明确标为待确认。
8. 文档新增、移动或重命名时同步 `Doc/index.md`。

## 推荐结构

- 适用范围与模块职责
- 入口和主要对象
- 主流程与数据/状态/渲染变化
- 缓存、持久化和并发模型
- 异常、取消、重试和兼容处理
- 维护风险与验证要点

纯文档任务不修改业务代码；源码暴露的缺陷应单独报告，不把建议写成已实现事实。