---
name: start-sdk-feature-dev-lite
description: 实现 ReadViewSDK 的单模块功能、Bug 修复、UI 调整、局部重构、编译修复或小范围 CocoaPods 变更，并完成必要验证。作为默认开发入口；跨 EPUB/PDF 模块、改变公共协议或持久化格式、需要迁移回滚或严格执行完整方案时使用 start-sdk-feature-dev。
---

# SDK 轻量开发

## 目标

用最小改动完成边界清晰的任务，形成“实现—验证—交付”闭环。

## 工作流

1. 检查工作区，识别并保留用户已有修改。
2. 定位目标源码、现有相邻模式和 `AGENTS.md` 路由出的文档。
3. 若用户提供方案，完整读取并执行已锁定决定；源码事实使方案不可行时先说明冲突。
4. 明确 In Scope、Out of Scope、成功标准和短执行清单。
5. 按模块边界实施最小修改：
   - EPUB 解析与资源：`Sources/RDEpubReaderView/EPUBCore`
   - EPUB 文本排版：`Sources/RDEpubReaderView/EPUBTextRendering`
   - EPUB 翻页容器：`Sources/RDEpubReaderView/ReaderView`
   - EPUB 成品 UI：`Sources/RDEpubReaderView/EPUBUI`
   - PDF 阅读器：`Sources/RDPDFReaderView`
   - 集成与回归入口：`ReadViewDemo`
6. 自检空值、失败分支、异步乱序、取消语义、主线程、生命周期、Cell 复用、缓存边界、内存警告和可访问性。
7. 检查公共 API、持久化模型、缓存键/版本、资源路径及 podspec 是否被意外改变。
8. 按风险执行构建或定向 UI 测试；编译错误应修复并重试。
9. 代码行为显著变化时更新最接近的 `Doc/` 文档。

## 升级条件

出现以下任一情况时切换到 `start-sdk-feature-dev` 并说明：

- 同时改变 EPUB 与 PDF 阅读器，或改变多个 EPUB 层级的职责。
- 修改宿主可见协议、公共初始化方法或需要兼容迁移。
- 改变持久化格式、缓存架构、分页主流程或跨模块状态流。
- 用户要求逐项执行完整开发方案。

## 交付

最终简洁说明完成内容、关键取舍、主要文件、验证结果、未覆盖风险和同步文档；不强制套固定模板。