---
name: generate-sdk-code-style-doc
description: 基于 ReadViewSDK 当前 EPUB、PDF 和 Demo 源码生成或更新全局代码规范、目录职责、命名、分层、UIKit/SnapKit、并发、缓存、公共 API 与测试约定。用户要求项目级编码规范或更新 Doc/CONVENTIONS.md 时使用；单模块规范改用 generate-module-code-style-doc。
---

# 生成 SDK 全局代码规范

## 工作流

1. 明确输出路径；未指定时增量更新 `Doc/CONVENTIONS.md`。
2. 读取现有目标文档、`Doc/ARCHITECTURE.md`、`Doc/index.md` 和两个 podspec。
3. 从 EPUBCore、EPUBTextRendering、ReaderView、EPUBUI、RDPDFReaderView 与 Demo/UITests 抽样真实源码。
4. 把结论分为：
   - 多模块源码验证的现行约定
   - 仅适用于 EPUB、PDF 或 Demo 的局部模式
   - 明确标记为建议、尚未成为项目事实的待统一项
5. 覆盖目录职责、命名与可见性、公共 API、UIKit/SnapKit、异步与取消、缓存/持久化、错误处理、测试、注释和 CocoaPods 约定。
6. 增量保留仍正确内容，删除失效描述；使用真实路径、类型和方法作为证据。
7. 新增、移动或重命名文档时同步 `Doc/index.md`，最后检查链接和源码一致性。

## 边界

- 不把 EPUB 的局部模式提升为 PDF 的全局规范，反之亦然。
- 不以旧 `.claude/skills` 或过期文档替代当前源码事实。
- 不把个人偏好写成现行规范。
- 文档任务默认不修改业务代码；发现缺陷时单独报告。