jarvis-ai-assistant 0.1.138__py3-none-any.whl → 0.1.141__py3-none-any.whl

jarvis/jarvis_code_analysis/checklists/data_format.py

@@ -0,0 +1,82 @@
+"""
+Data format (XML, JSON, YAML) specific code review checklist.
+"""
+
+CHECKLIST = """
+## 数据格式 (XML, JSON, YAML) 代码审查检查清单
+
+### 通用数据格式检查
+- [ ] 文件格式是否有效且符合规范
+- [ ] 是否使用了一致的缩进和格式
+- [ ] 数据结构是否合理清晰
+- [ ] 字段命名是否一致且有意义
+- [ ] 是否避免了重复数据
+- [ ] 是否避免了过度嵌套
+- [ ] 是否有适当的注释 (如格式允许)
+- [ ] 敏感信息是否妥善处理 (避免硬编码凭证)
+
+### JSON 特定检查
+- [ ] JSON 是否符合语法规范 (引号、逗号等)
+- [ ] 是否遵循命名约定 (通常为 camelCase)
+- [ ] 是否使用了适当的数据类型
+- [ ] 是否避免了重复的键名
+- [ ] 是否使用了 JSON Schema 进行验证
+- [ ] 较大的 JSON 文件是否考虑了性能影响
+- [ ] 是否考虑了国际化和字符编码问题
+- [ ] 数组索引是否从0开始 (与其他语言一致)
+
+### XML 特定检查
+- [ ] XML 是否有合法的文档声明
+- [ ] 命名空间是否使用得当
+- [ ] 标签是否正确闭合
+- [ ] 元素名称是否一致且有意义
+- [ ] 属性是否使用得当
+- [ ] 是否提供了 XML Schema 或 DTD
+- [ ] 是否使用了适当的转义字符
+- [ ] 元素和属性选择是否合理 (何时使用元素vs属性)
+
+### YAML 特定检查
+- [ ] 缩进是否一致 (通常为2空格)
+- [ ] 是否正确使用了锚点和别名
+- [ ] 多行字符串格式是否正确 (|, >, 折叠等)
+- [ ] 是否避免了使用制表符
+- [ ] 列表格式是否一致
+- [ ] 是否避免了过度使用复杂的 YAML 特性
+- [ ] 布尔值表示是否一致 (true/false 或 yes/no)
+- [ ] 是否考虑了解析性能问题
+
+### 配置文件特定检查
+- [ ] 配置项是否组织得当
+- [ ] 是否提供了默认值
+- [ ] 是否有文档说明配置项的用途
+- [ ] 敏感配置是否适当保护
+- [ ] 环境特定配置是否分离
+- [ ] 是否避免了过深的嵌套结构
+- [ ] 是否有版本控制策略
+
+### API 定义特定检查 (如 OpenAPI/Swagger)
+- [ ] API 路径是否符合 RESTful 设计原则
+- [ ] 数据模型是否定义清晰
+- [ ] 响应和请求格式是否一致
+- [ ] 是否包含了错误处理信息
+- [ ] 是否提供了足够的文档说明
+- [ ] 版本控制策略是否合理
+- [ ] 安全方案是否定义得当
+
+### 数据交换和互操作性
+- [ ] 是否考虑了向前/向后兼容性
+- [ ] 是否支持扩展 (extensibility)
+- [ ] 日期和时间格式是否标准化 (如 ISO 8601)
+- [ ] 数字格式是否一致 (精度、科学记数法等)
+- [ ] 语言和国际化是否得到支持
+- [ ] 数据大小是否在合理范围内
+- [ ] 是否考虑了不同系统的互操作性
+
+### 安全性
+- [ ] 是否避免了注入漏洞
+- [ ] 是否对外部输入进行验证
+- [ ] 敏感数据是否适当加密或掩码
+- [ ] 是否避免了过度暴露内部数据结构
+- [ ] 序列化/反序列化是否安全
+- [ ] 是否避免了使用有风险的格式特性
+""" 

jarvis/jarvis_code_analysis/checklists/devops.py

@@ -0,0 +1,107 @@
+"""
+DevOps (Makefile, CI/CD) specific code review checklist.
+"""
+
+CHECKLIST = """
+## DevOps (Makefile, CI/CD) 代码审查检查清单
+
+### Makefile 结构与风格
+- [ ] 目标是否清晰且有明确用途
+- [ ] 是否使用了合适的依赖关系
+- [ ] 是否有默认目标和帮助信息
+- [ ] 变量命名是否一致且有意义
+- [ ] 是否使用了适当的变量替换
+- [ ] 是否避免了重复代码
+- [ ] 目标规则是否组织良好并有注释
+- [ ] 是否使用了模式规则和自动变量
+
+### Makefile 最佳实践
+- [ ] 是否使用了.PHONY伪目标
+- [ ] 是否声明了必要的环境变量
+- [ ] 是否使用了适当的错误处理
+- [ ] 是否优化了构建性能
+- [ ] 是否支持并行构建 (-j 选项)
+- [ ] 是否考虑了跨平台兼容性
+- [ ] 是否适当使用了条件逻辑
+- [ ] 是否包含了清理目标
+
+### CI/CD 配置审查
+- [ ] 工作流程是否清晰定义
+- [ ] 是否使用了合适的触发条件
+- [ ] 是否正确定义了环境和依赖
+- [ ] 是否有适当的阶段和步骤划分
+- [ ] 是否实现了合理的并行执行
+- [ ] 是否有适当的缓存策略
+- [ ] 是否处理了错误和恢复机制
+- [ ] 是否包含了适当的通知配置
+
+### 环境管理
+- [ ] 是否明确定义了所需的环境变量
+- [ ] 敏感信息是否安全管理
+- [ ] 是否有环境隔离 (开发/测试/生产)
+- [ ] 是否有版本锁定机制
+- [ ] 是否考虑了可重现性
+- [ ] 是否有适当的环境验证步骤
+- [ ] 是否考虑了可扩展性需求
+- [ ] 依赖管理是否合理
+
+### 自动化构建
+- [ ] 构建步骤是否完整且按顺序
+- [ ] 构建过程是否可重现
+- [ ] 是否包含了必要的验证步骤
+- [ ] 资源使用是否优化
+- [ ] 是否有适当的错误报告
+- [ ] 是否包含了版本控制信息
+- [ ] 构建成品是否明确定义
+- [ ] 是否有适当的构建日志
+
+### 测试自动化
+- [ ] 是否包含了单元测试
+- [ ] 是否包含了集成测试
+- [ ] 是否设置了适当的测试环境
+- [ ] 测试结果是否易于解读
+- [ ] 是否避免了测试之间的依赖
+- [ ] 测试覆盖率是否合理
+- [ ] 是否有失败测试的恢复机制
+- [ ] 测试执行是否优化
+
+### 部署流程
+- [ ] 部署步骤是否明确且按顺序
+- [ ] 是否有回滚机制
+- [ ] 是否使用了蓝绿部署或金丝雀发布
+- [ ] 是否进行了部署前验证
+- [ ] 是否有部署后验证
+- [ ] 是否有适当的权限控制
+- [ ] 是否支持不同环境的部署
+- [ ] 是否有部署拆分或分阶段发布机制
+
+### 安全考虑
+- [ ] 构建和部署脚本是否避免了硬编码凭证
+- [ ] 是否有适当的访问控制
+- [ ] 是否进行了安全扫描
+- [ ] 依赖项是否经过安全审查
+- [ ] 是否避免了注入漏洞
+- [ ] 临时凭证管理是否安全
+- [ ] 是否有安全合规检查
+- [ ] 是否记录了安全相关日志
+
+### 监控和可观测性
+- [ ] 是否包含了健康检查
+- [ ] 是否实现了适当的日志记录
+- [ ] 是否有性能监控
+- [ ] 是否有错误追踪和报警
+- [ ] 是否考虑了可追踪性
+- [ ] 是否有适当的指标收集
+- [ ] 是否考虑了日志聚合
+- [ ] 是否有状态报告机制
+
+### 文档和维护
+- [ ] 是否有清晰的使用文档
+- [ ] 命令和选项是否有描述
+- [ ] 是否记录了关键决策和注意事项
+- [ ] 脚本是否易于维护和扩展
+- [ ] 是否有明确的维护责任
+- [ ] 是否有版本控制和变更历史
+- [ ] 是否有明确的故障排除指南
+- [ ] 依赖关系是否明确记录
+""" 

jarvis/jarvis_code_analysis/checklists/docs.py

@@ -0,0 +1,87 @@
+"""
+Documentation (Markdown, reStructuredText) specific code review checklist.
+"""
+
+CHECKLIST = """
+## 文档 (Markdown, RST) 代码审查检查清单
+
+### 内容质量
+- [ ] 文档是否清晰、准确地描述了主题
+- [ ] 内容是否组织有序且符合逻辑
+- [ ] 是否避免了冗余和重复内容
+- [ ] 技术术语是否使用一致且正确
+- [ ] 是否包含了必要的示例和说明
+- [ ] 是否避免了过于复杂或晦涩的语言
+- [ ] 是否针对目标受众进行了适当调整
+- [ ] 是否没有语法错误和拼写错误
+
+### 文档结构
+- [ ] 标题层级是否清晰合理 (h1, h2, h3等)
+- [ ] 是否使用了适当的目录结构
+- [ ] 是否包含了必要的元数据 (如标题、作者、日期)
+- [ ] 相关内容是否适当分组
+- [ ] 是否使用了适当的断落和分段
+- [ ] 导航链接是否清晰且有效
+- [ ] 是否有总结或结论部分
+- [ ] 文档长度是否适中，避免过长或过短
+
+### Markdown/RST 语法
+- [ ] 是否正确使用了标记语法 (标题、列表、链接等)
+- [ ] 代码块是否使用了正确的格式和语法高亮
+- [ ] 表格是否格式良好且易于阅读
+- [ ] 图片是否有替代文本和适当的说明
+- [ ] 是否正确使用了强调和引用标记
+- [ ] 特殊字符是否正确转义
+- [ ] 是否避免了不必要的行内HTML/RST扩展语法
+- [ ] 是否使用了标准兼容的Markdown/RST语法
+
+### 技术准确性
+- [ ] 代码示例是否准确且可运行
+- [ ] API引用和函数名称是否正确
+- [ ] 版本信息是否最新且准确
+- [ ] 技术概念解释是否准确
+- [ ] 链接是否指向正确的资源
+- [ ] 命令行示例是否完整且可执行
+- [ ] 是否包含了必要的先决条件和环境要求
+- [ ] 故障排除信息是否有效且实用
+
+### 可访问性和可用性
+- [ ] 是否使用了描述性链接文本 (避免"点击这里")
+- [ ] 图片和图表是否有适当的替代文本
+- [ ] 颜色和对比度是否符合可访问性标准
+- [ ] 内容是否可被屏幕阅读器正确解析
+- [ ] 表格是否有适当的表头和描述
+- [ ] 是否避免了仅依赖颜色传递信息
+- [ ] 字体大小和样式是否易于阅读
+- [ ] 是否考虑了国际化和本地化需求
+
+### 文档维护
+- [ ] 是否包含了"最后更新"日期
+- [ ] 是否有明确的版本信息
+- [ ] 是否有贡献指南
+- [ ] 废弃内容是否有明确标记
+- [ ] 是否有明确的维护责任人
+- [ ] 是否建立了文档更新流程
+- [ ] 是否包含了反馈渠道
+- [ ] 是否与代码库保持同步
+
+### SEO和发现性
+- [ ] 标题是否包含关键字
+- [ ] 元描述是否清晰且有信息量
+- [ ] 是否使用了适当的标签和分类
+- [ ] 是否有适当的内部链接
+- [ ] 是否避免了死链接
+- [ ] URL结构是否有意义且稳定
+- [ ] 是否考虑了搜索引擎索引优化
+- [ ] 是否有明确的导航路径
+
+### 文档工具和格式
+- [ ] 是否使用了一致的文档生成工具 (如Sphinx, MkDocs)
+- [ ] 是否遵循了项目文档风格指南
+- [ ] 是否有适当的主题和样式应用
+- [ ] 导出格式是否支持目标平台 (PDF, HTML)
+- [ ] 是否使用了版本控制管理文档
+- [ ] 自动化构建和部署是否配置正确
+- [ ] 是否有预览环境测试文档更改
+- [ ] 是否集成了持续集成/持续部署流程
+""" 

jarvis/jarvis_code_analysis/checklists/go.py

@@ -0,0 +1,52 @@
+"""
+Go language-specific code review checklist.
+"""
+
+CHECKLIST = """
+## Go 代码审查检查清单
+
+### 错误处理
+- [ ] 是否正确检查和处理错误
+- [ ] 是否遵循 Go 的错误处理惯例 (errors.Is, errors.As)
+- [ ] 错误是否有足够的上下文信息
+
+### 并发
+- [ ] goroutine 是否会正常终止
+- [ ] 是否存在竞态条件
+- [ ] channel 使用是否正确
+- [ ] 是否正确使用 sync 包
+- [ ] 是否使用了上下文 (context) 进行超时控制
+
+### 资源管理
+- [ ] defer 是否正确使用
+- [ ] 资源是否被正确关闭
+- [ ] 是否有潜在的资源泄漏
+
+### 性能
+- [ ] 是否避免不必要的内存分配
+- [ ] 切片和映射的容量是否合理
+- [ ] 是否使用了高效的 IO 操作
+- [ ] 大型结构体是否使用指针传递
+
+### 代码风格与最佳实践
+- [ ] 是否遵循官方 Go 代码风格
+- [ ] 命名是否遵循 Go 的约定
+- [ ] 是否避免了不必要的代码重复
+- [ ] 是否正确使用接口
+- [ ] 是否过度使用全局变量
+- [ ] 包的设计是否合理
+
+### 测试
+- [ ] 是否有足够的单元测试
+- [ ] 测试覆盖率是否合理
+- [ ] 表格驱动测试是否得当
+
+### 安全
+- [ ] SQL 注入风险
+- [ ] 命令注入风险
+- [ ] 敏感信息是否安全存储
+
+### 文档
+- [ ] 导出的函数/类型是否有文档注释
+- [ ] 复杂逻辑是否有注释说明
+""" 

jarvis/jarvis_code_analysis/checklists/infrastructure.py

@@ -0,0 +1,98 @@
+"""
+Infrastructure as Code (Docker, Terraform) specific code review checklist.
+"""
+
+CHECKLIST = """
+## 基础设施即代码 (Docker, Terraform) 代码审查检查清单
+
+### Docker 通用检查
+- [ ] Dockerfile 是否遵循最佳实践
+- [ ] 是否使用了适当的基础镜像
+- [ ] 是否最小化了镜像层数
+- [ ] 是否按照依赖稳定性顺序组织指令
+- [ ] 是否移除了不必要的依赖和文件
+- [ ] 是否避免安装调试工具和开发依赖
+- [ ] 镜像标签是否明确 (避免使用 `latest`)
+- [ ] 是否使用了多阶段构建减小镜像大小
+- [ ] 是否设置了适当的工作目录 (WORKDIR)
+
+### Docker 安全检查
+- [ ] 是否以非 root 用户运行容器
+- [ ] 是否限制了容器资源 (CPU, 内存)
+- [ ] 是否避免了将敏感信息硬编码到镜像中
+- [ ] 是否使用了安全扫描工具检查漏洞
+- [ ] 是否设置了适当的文件和目录权限
+- [ ] 是否避免了使用特权模式
+- [ ] 是否移除了不必要的包和工具
+- [ ] 是否在构建时验证下载的软件包
+
+### Docker 优化检查
+- [ ] 是否使用了 .dockerignore 文件
+- [ ] 是否合并了相关命令减少层数
+- [ ] 是否使用了缓存优化构建时间
+- [ ] 是否优化了镜像大小
+- [ ] 是否避免了不必要的环境变量
+- [ ] 是否使用了合适的指令进行健康检查
+- [ ] 是否为应用设置了适当的启动命令
+- [ ] 构建参数和环境变量是否使用恰当
+
+### Docker Compose 检查
+- [ ] 服务配置是否合理
+- [ ] 网络配置是否安全且高效
+- [ ] 卷挂载是否正确
+- [ ] 环境变量是否适当管理
+- [ ] 依赖关系是否明确定义
+- [ ] 资源限制是否设置
+- [ ] 是否使用了版本控制
+- [ ] 是否有适当的重启策略
+
+### Terraform 通用检查
+- [ ] 代码结构是否模块化和可重用
+- [ ] 是否遵循 Terraform 目录结构最佳实践
+- [ ] 变量和输出是否有明确的说明文档
+- [ ] 资源名称是否一致且有意义
+- [ ] 是否避免了硬编码值 (使用变量)
+- [ ] 是否明确指定了 provider 版本
+- [ ] 是否使用了远程状态存储和锁定
+- [ ] 是否遵循命名约定
+
+### Terraform 安全检查
+- [ ] 敏感信息是否使用 Terraform 加密存储
+- [ ] 是否限制了资源的权限和访问范围
+- [ ] 网络安全组/防火墙规则是否遵循最小特权原则
+- [ ] 是否启用了资源日志和监控
+- [ ] 访问密钥和证书是否安全管理
+- [ ] 是否使用循环依赖及其影响
+- [ ] 是否正确使用了 IAM 策略和角色
+- [ ] 是否考虑了数据加密（传输中和静态）
+
+### Terraform 性能和优化
+- [ ] 资源依赖关系是否明确定义
+- [ ] 是否避免了创建不必要的资源
+- [ ] 是否使用了条件表达式优化资源创建
+- [ ] 是否使用了本地值减少重复
+- [ ] 是否合理使用了数据源
+- [ ] 是否使用 count 或 for_each 简化资源创建
+- [ ] 是否优化了资源的创建顺序
+- [ ] 是否考虑了高可用性和灾难恢复
+
+### 基础设施即代码 (IaC) 最佳实践
+- [ ] 是否实现了基础设施版本控制
+- [ ] 是否有适当的变更管理流程
+- [ ] 代码是否通过自动化测试
+- [ ] 是否创建了可重复的环境
+- [ ] 是否使用了不可变基础设施原则
+- [ ] 是否考虑了扩展性需求
+- [ ] 是否有足够的文档
+- [ ] 是否考虑了成本优化
+
+### 云服务提供商特定检查
+- [ ] 是否遵循了云服务提供商的最佳实践
+- [ ] 资源命名是否符合组织规范
+- [ ] 是否设置了适当的资源标签
+- [ ] 是否考虑了区域/可用区策略
+- [ ] 是否有适当的备份和恢复策略
+- [ ] 是否优化了资源成本
+- [ ] 是否考虑了服务限制和配额
+- [ ] 是否正确配置了自动扩展
+""" 

jarvis/jarvis_code_analysis/checklists/java.py

@@ -0,0 +1,66 @@
+"""
+Java language-specific code review checklist.
+"""
+
+CHECKLIST = """
+## Java 代码审查检查清单
+
+### 代码风格和约定
+- [ ] 是否遵循 Java 命名约定 (驼峰式命名法)
+- [ ] 包名是否使用小写字母并使用有意义的名称
+- [ ] 类名是否以大写字母开头
+- [ ] 方法和变量是否以小写字母开头
+- [ ] 常量是否全部大写并用下划线分隔
+- [ ] 代码格式是否一致 (缩进、括号位置等)
+
+### 面向对象设计
+- [ ] 是否遵循 SOLID 原则
+- [ ] 类的职责是否单一明确
+- [ ] 类的继承层次是否合理
+- [ ] 是否使用接口来实现多态
+- [ ] 是否存在过度复杂的类设计
+
+### 异常处理
+- [ ] 是否适当捕获和处理异常
+- [ ] 是否使用特定异常而非通用异常
+- [ ] 是否在 finally 块中正确释放资源
+- [ ] 是否有未处理的检查型异常
+- [ ] 是否使用了 try-with-resources 自动关闭资源
+
+### 线程安全
+- [ ] 共享数据是否有同步保护
+- [ ] 是否存在死锁风险
+- [ ] 是否正确使用 volatile、synchronized、Lock 和 Condition
+- [ ] 是否适当使用了线程安全集合
+- [ ] 是否存在竞态条件
+
+### 性能考量
+- [ ] 是否避免了不必要的对象创建
+- [ ] 集合类使用是否高效
+- [ ] 是否有内存泄漏的风险
+- [ ] 是否考虑了大数据量时的性能问题
+- [ ] I/O 和网络操作是否高效
+
+### 安全性
+- [ ] 是否存在 SQL 注入风险
+- [ ] 是否存在 XSS 和 CSRF 风险
+- [ ] 敏感数据是否加密存储
+- [ ] 是否正确验证用户输入
+- [ ] 是否实施了最小权限原则
+
+### 依赖管理
+- [ ] 是否使用了过时或有安全漏洞的依赖
+- [ ] 是否明确指定了依赖版本
+- [ ] 依赖项是否冗余或过度引入
+
+### 测试
+- [ ] 是否有单元测试覆盖主要功能
+- [ ] 测试边界条件和异常路径
+- [ ] 测试代码是否清晰易懂
+- [ ] 是否使用模拟对象测试外部依赖
+
+### 文档
+- [ ] 公共 API 是否有 JavaDoc 注释
+- [ ] 复杂逻辑是否有注释说明
+- [ ] 注释是否准确且最新
+""" 

jarvis/jarvis_code_analysis/checklists/javascript.py

@@ -0,0 +1,73 @@
+"""
+JavaScript/TypeScript language-specific code review checklist.
+"""
+
+CHECKLIST = """
+## JavaScript/TypeScript 代码审查检查清单
+
+### 代码风格和格式
+- [ ] 是否遵循一致的命名约定 (camelCase、PascalCase)
+- [ ] 是否使用 ESLint/TSLint 进行代码规范检查
+- [ ] 缩进和格式是否一致
+- [ ] 是否避免了过长的函数和过深的嵌套
+
+### 类型安全 (TypeScript)
+- [ ] 是否使用了适当的类型注解
+- [ ] 是否避免了过度使用 any 类型
+- [ ] 是否正确使用接口和类型别名
+- [ ] 泛型使用是否合理
+- [ ] 是否正确处理可能为 null/undefined 的值
+
+### 异步编程
+- [ ] Promise 异常是否被正确捕获和处理
+- [ ] async/await 是否使用得当
+- [ ] 是否避免了回调地狱
+- [ ] 是否正确处理异步操作的竞态条件
+- [ ] 是否合理使用 Promise.all/Promise.race
+
+### 性能优化
+- [ ] 是否避免了不必要的重新渲染
+- [ ] 是否避免了内存泄漏 (闭包、事件监听器等)
+- [ ] 是否适当使用了记忆化和缓存
+- [ ] 循环和数据处理是否高效
+- [ ] 是否避免了过度的DOM操作
+
+### 安全性
+- [ ] 是否防范了 XSS 攻击
+- [ ] 是否防范了 CSRF 攻击
+- [ ] 敏感数据是否安全处理
+- [ ] 是否正确验证用户输入
+- [ ] 是否避免使用 eval 和不安全的 DOM API
+
+### 浏览器兼容性
+- [ ] 是否考虑了目标浏览器的支持程度
+- [ ] 是否使用了适当的垫片 (polyfills)
+- [ ] 是否测试了不同浏览器下的表现
+
+### 模块化和依赖管理
+- [ ] 模块划分是否合理
+- [ ] 是否避免了循环依赖
+- [ ] 依赖版本是否固定
+- [ ] 第三方库使用是否恰当
+- [ ] 是否避免了过度依赖
+
+### 测试
+- [ ] 是否有单元测试覆盖核心功能
+- [ ] 是否测试了组件渲染和交互
+- [ ] 测试用例是否覆盖边界条件
+- [ ] 是否有集成测试和端到端测试
+
+### 可访问性 (对于前端代码)
+- [ ] 是否遵循 ARIA 最佳实践
+- [ ] 是否使用语义化 HTML
+- [ ] 是否支持键盘导航
+- [ ] 颜色对比度是否符合标准
+- [ ] 是否兼容屏幕阅读器
+
+### 可维护性
+- [ ] 代码结构是否清晰
+- [ ] 是否有充分的注释和文档
+- [ ] 复杂逻辑是否抽象成可测试的函数
+- [ ] 是否遵循 DRY 原则
+- [ ] 状态管理是否合理
+""" 

jarvis/jarvis_code_analysis/checklists/kotlin.py

@@ -0,0 +1,107 @@
+"""
+Kotlin-specific code review checklist.
+"""
+
+CHECKLIST = """
+## Kotlin 代码审查检查清单
+
+### 代码风格和约定
+- [ ] 代码是否遵循 Kotlin 官方编码规范
+- [ ] 是否使用工具（如 ktlint、detekt）进行代码风格检查
+- [ ] 格式化是否一致（缩进、空格、换行等）
+- [ ] 命名是否符合 Kotlin 约定（驼峰命名法，常量使用大写）
+- [ ] 是否避免了魔法数字和硬编码字符串
+- [ ] 是否避免使用 !!（非空断言）操作符
+- [ ] 注释是否清晰且及时更新
+- [ ] 文件组织是否合理（每个文件一个类，相关功能分组）
+
+### Kotlin 特性使用
+- [ ] 是否恰当使用扩展函数和属性
+- [ ] 是否有效利用 null 安全操作符（?、?.、?:、!!）
+- [ ] 是否合理使用数据类（data class）
+- [ ] 是否合理使用密封类（sealed class）
+- [ ] 是否恰当使用伴生对象（companion object）
+- [ ] 是否合理使用对象声明（object）
+- [ ] 是否合理使用高阶函数和 lambda 表达式
+- [ ] 是否恰当使用委托属性（properties delegation）
+
+### 面向对象设计
+- [ ] 类的设计是否遵循单一职责原则
+- [ ] 是否恰当使用继承和接口
+- [ ] 是否避免过度使用继承
+- [ ] 是否合理使用抽象类和接口
+- [ ] 是否给类和方法提供适当的可见性修饰符
+- [ ] 构造函数设计是否合理
+- [ ] 是否遵循开闭原则和其他 SOLID 原则
+- [ ] 是否使用组合而非继承（适当情况下）
+
+### 并发和异步编程
+- [ ] 是否正确使用协程（coroutines）
+- [ ] 是否合理使用挂起函数（suspend functions）
+- [ ] 是否恰当处理协程的取消和异常
+- [ ] 是否合理使用协程上下文（CoroutineContext）
+- [ ] 是否合理选择适当的调度器（Dispatchers）
+- [ ] 是否避免共享可变状态或正确保护它
+- [ ] 是否考虑线程安全问题
+- [ ] 是否使用了适当的并发原语（如 Mutex）
+
+### Android 特定检查 (如适用)
+- [ ] 是否正确管理生命周期
+- [ ] 是否避免内存泄漏（如 Context 引用）
+- [ ] UI 组件是否遵循 Material Design 原则
+- [ ] 是否有效使用 ViewModel 和 LiveData
+- [ ] 是否恰当使用 Android KTX 扩展
+- [ ] 是否适当配置了线程（主线程/后台线程）
+- [ ] 是否遵循官方 Android 架构指南
+- [ ] 是否妥善处理配置更改和进程死亡
+
+### 性能优化
+- [ ] 是否避免了昂贵的操作（如在循环中创建对象）
+- [ ] 集合操作是否高效（适当使用序列进行大量元素的处理）
+- [ ] 是否避免了装箱和拆箱开销
+- [ ] 是否优化了闭包和内联函数使用
+- [ ] 是否避免在关键路径上分配过多对象
+- [ ] 是否考虑了惰性初始化（lazy）以优化资源使用
+- [ ] 是否合理缓存计算结果
+- [ ] 是否使用了适当的数据结构和算法
+
+### 依赖管理
+- [ ] 依赖是否声明精确的版本
+- [ ] 是否避免使用过时或不安全的依赖
+- [ ] 是否最小化依赖数量
+- [ ] 是否定期更新依赖以修复安全漏洞
+- [ ] 是否处理了依赖冲突
+- [ ] 是否区分了开发和生产依赖
+- [ ] 是否使用适当的构建系统（Gradle）配置
+- [ ] 是否合理组织和模块化项目结构
+
+### 错误处理
+- [ ] 是否使用了合适的错误处理策略
+- [ ] 是否考虑使用 Result 类型代替异常
+- [ ] 是否创建了自定义异常类型
+- [ ] 是否在适当的级别捕获和处理异常
+- [ ] 是否提供有意义的错误消息
+- [ ] 是否处理了所有可能的错误情况
+- [ ] 是否记录了关键异常
+- [ ] try-catch 块是否尽可能小而聚焦
+
+### 测试
+- [ ] 单元测试是否充分且有意义
+- [ ] 是否使用了适当的测试框架（JUnit、Mockito、MockK）
+- [ ] 测试是否涵盖主要功能和边界条件
+- [ ] UI 测试是否覆盖关键用户流程
+- [ ] 测试代码组织是否清晰
+- [ ] 测试是否避免了不必要的复杂性
+- [ ] 是否进行了性能和内存使用测试（适用时）
+- [ ] 测试是否快速且可靠（无随机失败）
+
+### 文档
+- [ ] 是否使用 KDoc 注释公共 API
+- [ ] 是否有清晰的 README 和项目文档
+- [ ] 是否记录了复杂逻辑
+- [ ] 文档是否与代码同步更新
+- [ ] 是否记录了性能注意事项和限制
+- [ ] API 参数和返回值是否有文档说明
+- [ ] 是否包含了示例代码或用例
+- [ ] 是否维护了 CHANGELOG 记录
+"""