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

jarvis/jarvis_code_analysis/checklists/loader.py

@@ -0,0 +1,76 @@
+"""
+Utility module for loading language-specific code review checklists.
+"""
+from typing import Dict, Optional
+
+# Import checklist modules
+from jarvis.jarvis_code_analysis.checklists import (
+    c_cpp, 
+    go, 
+    python, 
+    rust,
+    java,
+    javascript,
+    csharp,
+    swift,
+    php,
+    shell,
+    sql,
+    ruby,
+    kotlin,
+    web,
+    data_format,
+    infrastructure,
+    docs,
+    devops
+)
+
+# Map of language identifiers to their checklist content
+CHECKLIST_MAP = {
+    'c_cpp': c_cpp.CHECKLIST,
+    'go': go.CHECKLIST,
+    'python': python.CHECKLIST,
+    'rust': rust.CHECKLIST,
+    'java': java.CHECKLIST,
+    'javascript': javascript.CHECKLIST,
+    'typescript': javascript.CHECKLIST,  # TypeScript uses the same checklist as JavaScript
+    'csharp': csharp.CHECKLIST,
+    'swift': swift.CHECKLIST,
+    'php': php.CHECKLIST,
+    'shell': shell.CHECKLIST,
+    'sql': sql.CHECKLIST,
+    'ruby': ruby.CHECKLIST,
+    'kotlin': kotlin.CHECKLIST,
+    'html': web.CHECKLIST,
+    'css': web.CHECKLIST,
+    'xml': data_format.CHECKLIST,
+    'json': data_format.CHECKLIST,
+    'yaml': data_format.CHECKLIST,
+    'docker': infrastructure.CHECKLIST,
+    'terraform': infrastructure.CHECKLIST,
+    'markdown': docs.CHECKLIST,
+    'docs': docs.CHECKLIST,
+    'makefile': devops.CHECKLIST,
+    'devops': devops.CHECKLIST,
+}
+
+def get_language_checklist(language: str) -> Optional[str]:
+    """
+    Get the checklist for a specific language.
+    
+    Args:
+        language: The language identifier ('c_cpp', 'go', 'python', 'rust', etc.)
+        
+    Returns:
+        The checklist content as a string, or None if not found
+    """
+    return CHECKLIST_MAP.get(language)
+
+def get_all_checklists() -> Dict[str, str]:
+    """
+    Get all available language checklists.
+    
+    Returns:
+        Dictionary mapping language identifiers to their checklist content
+    """
+    return CHECKLIST_MAP 

jarvis/jarvis_code_analysis/checklists/php.py

@@ -0,0 +1,77 @@
+"""
+PHP language-specific code review checklist.
+"""
+
+CHECKLIST = """
+## PHP 代码审查检查清单
+
+### 代码风格和规范
+- [ ] 是否遵循 PSR 标准 (PSR-1, PSR-12)
+- [ ] 命名约定是否一致 (类、方法、变量)
+- [ ] 是否使用 PHP_CodeSniffer 等工具检查代码风格
+- [ ] 缩进和格式是否一致
+- [ ] 是否使用了最新的 PHP 语法特性
+
+### 安全性
+- [ ] 是否防范 SQL 注入 (使用 PDO 或预处理语句)
+- [ ] 是否防范 XSS 攻击 (输出转义)
+- [ ] 是否防范 CSRF 攻击
+- [ ] 文件上传是否安全处理
+- [ ] 是否使用安全的密码散列 (password_hash)
+- [ ] 是否避免使用有安全隐患的函数 (eval, create_function)
+- [ ] 敏感数据是否加密存储
+- [ ] 会话和 Cookie 是否安全配置
+- [ ] 是否正确进行 HTTPS 配置
+
+### 性能优化
+- [ ] 数据库查询是否优化
+- [ ] 是否使用缓存机制
+- [ ] 循环和数据处理是否高效
+- [ ] 是否避免了内存密集型操作
+- [ ] 是否考虑了代码的可扩展性
+- [ ] 是否使用适当的数据结构
+- [ ] 是否优化了 I/O 操作
+
+### 错误处理
+- [ ] 是否使用异常处理机制
+- [ ] 是否适当捕获和记录错误
+- [ ] 是否提供友好的错误信息
+- [ ] 是否有合适的异常层次结构
+- [ ] 生产环境是否适当配置错误显示
+
+### 面向对象设计
+- [ ] 是否遵循 SOLID 原则
+- [ ] 类的职责是否单一明确
+- [ ] 继承层次是否合理
+- [ ] 是否使用接口定义契约
+- [ ] 类之间的耦合是否最小化
+- [ ] 是否使用设计模式解决复杂问题
+
+### 依赖管理
+- [ ] 是否使用 Composer 管理依赖
+- [ ] 依赖版本是否指定
+- [ ] 是否定期更新依赖以修复安全漏洞
+- [ ] 是否最小化了第三方依赖
+- [ ] composer.json 和 composer.lock 是否同步
+
+### 测试
+- [ ] 是否有单元测试 (PHPUnit)
+- [ ] 测试是否覆盖核心功能和边界条件
+- [ ] 是否使用模拟对象测试依赖
+- [ ] 测试是否可重复执行且彼此独立
+- [ ] 是否有集成测试
+
+### 文档
+- [ ] 公共 API 是否有 PHPDoc 注释
+- [ ] 复杂逻辑是否有注释说明
+- [ ] 是否记录了项目设置和依赖要求
+- [ ] 是否有使用示例
+- [ ] 注释是否与代码同步
+
+### 框架特定检查 (如使用框架)
+- [ ] 是否遵循框架的最佳实践
+- [ ] 是否正确使用 ORM 和数据库迁移
+- [ ] 是否适当使用中间件
+- [ ] 路由定义是否合理
+- [ ] MVC 结构是否清晰
+""" 

jarvis/jarvis_code_analysis/checklists/python.py

@@ -0,0 +1,56 @@
+"""
+Python language-specific code review checklist.
+"""
+
+CHECKLIST = """
+## Python 代码审查检查清单
+
+### 代码风格
+- [ ] 是否遵循 PEP 8 规范
+- [ ] 命名是否符合 Python 约定
+- [ ] 是否有适当的空格和缩进
+- [ ] 是否避免了过长的行
+
+### 类型安全
+- [ ] 是否使用类型注解 (Python 3.6+)
+- [ ] 是否处理了可能的类型不匹配
+- [ ] 复杂参数是否有类型说明
+
+### 异常处理
+- [ ] 是否捕获和处理了异常
+- [ ] 是否使用了合适的异常类型
+- [ ] 是否避免了过于宽泛的 except 子句
+- [ ] 自定义异常是否合理
+
+### 性能
+- [ ] 是否避免了低效的循环和操作
+- [ ] 列表推导式和生成器的使用是否合理
+- [ ] 是否优化了 I/O 操作
+- [ ] 是否合理使用了缓存
+
+### 安全
+- [ ] 是否存在 SQL 注入风险
+- [ ] 是否存在命令注入风险
+- [ ] 密码和密钥是否安全存储
+- [ ] 是否正确验证用户输入
+
+### 依赖管理
+- [ ] 是否明确指定了依赖版本
+- [ ] 是否考虑了版本兼容性
+- [ ] 是否最小化了依赖的数量
+
+### 测试
+- [ ] 是否有单元测试
+- [ ] 测试覆盖率是否合理
+- [ ] 是否处理了边界情况
+
+### 文档
+- [ ] 函数和类是否有文档字符串
+- [ ] 复杂逻辑是否有注释说明
+- [ ] README 是否完整
+
+### 设计
+- [ ] 是否遵循 SOLID 原则
+- [ ] 是否避免了过度工程
+- [ ] 是否实现了适当的抽象
+""" 

jarvis/jarvis_code_analysis/checklists/ruby.py

@@ -0,0 +1,107 @@
+"""
+Ruby-specific code review checklist.
+"""
+
+CHECKLIST = """
+## Ruby 代码审查检查清单
+
+### 代码风格和约定
+- [ ] 代码是否符合 Ruby 代码风格指南 (如 [Ruby Style Guide](https://github.com/rubocop/ruby-style-guide))
+- [ ] 是否使用 RuboCop 进行代码风格检查
+- [ ] 两个空格缩进是否一致
+- [ ] 是否有不必要的空白或者空行
+- [ ] 是否使用了恰当的命名约定 (snake_case 用于方法/变量, CamelCase 用于类/模块)
+- [ ] 是否有不必要的注释或者过时的注释
+- [ ] 代码是否容易理解且符合惯用的 Ruby 风格
+- [ ] 魔法数字是否已提取为有意义的常量
+
+### 类和模块设计
+- [ ] 类和模块是否单一职责
+- [ ] 是否遵循 DRY (Don't Repeat Yourself) 原则
+- [ ] 类的继承结构是否合理
+- [ ] 是否合理使用模块作为 mixin
+- [ ] 是否恰当地使用了模块命名空间
+- [ ] 公共 API 接口是否明确且易于理解
+- [ ] 是否控制了类和模块的大小 (避免过大的类/模块)
+- [ ] 类变量 (@@var) 是否使用恰当 (通常应避免使用)
+
+### 方法和代码块
+- [ ] 方法是否遵循单一职责原则
+- [ ] 方法长度是否合理控制
+- [ ] 方法名是否清晰表达了其功能
+- [ ] 参数数量是否合理 (避免过多参数)
+- [ ] 是否恰当使用了可选参数和关键字参数
+- [ ] 是否恰当使用了代码块和 yield
+- [ ] 闭包使用是否恰当且清晰
+- [ ] 是否恰当使用了方法链 (避免过长的方法链)
+
+### 异常处理
+- [ ] 是否捕获具体的异常类型而非所有异常
+- [ ] 是否提供有意义的错误信息
+- [ ] 资源是否在 ensure 块中正确释放
+- [ ] 是否避免了使用异常控制正常流程
+- [ ] 是否在合适的级别处理异常
+- [ ] 是否有自定义异常类用于特定错误情况
+- [ ] 是否使用了 begin/rescue/ensure/end 代码块的简洁形式
+- [ ] 是否处理了第三方库可能抛出的异常
+
+### 性能考量
+- [ ] 大型集合操作是否高效 (如使用 map, select 而非循环)
+- [ ] 是否避免了 N+1 查询问题
+- [ ] 是否恰当使用了惰性计算
+- [ ] 字符串操作是否高效
+- [ ] 是否通过缓存避免重复计算
+- [ ] IO 和网络操作是否异步或批量处理
+- [ ] 是否避免了内存泄漏
+- [ ] 是否避免了不必要的对象分配
+
+### Rails 特定检查 (如适用)
+- [ ] 模型是否遵循 ActiveRecord 最佳实践
+- [ ] 控制器是否遵循"瘦控制器，胖模型"原则
+- [ ] 是否恰当使用了 Rails 的回调机制
+- [ ] 视图是否避免了业务逻辑
+- [ ] 路由设计是否符合 RESTful 规范
+- [ ] 是否使用了适当的查询优化技术
+- [ ] ActiveRecord 关联是否合理配置
+- [ ] 是否使用了适当的数据库索引
+
+### 安全性
+- [ ] 是否防止了 SQL 注入攻击
+- [ ] 是否防止了跨站点脚本 (XSS) 攻击
+- [ ] 是否防止了跨站请求伪造 (CSRF)
+- [ ] 是否安全处理了用户输入
+- [ ] 是否使用了安全的密码存储方式
+- [ ] 是否正确处理了敏感数据
+- [ ] 是否使用了 HTTPS
+- [ ] 是否防止了不安全的对象反序列化
+
+### 测试
+- [ ] 是否有全面的单元测试
+- [ ] 是否有整合测试
+- [ ] 测试是否覆盖了边缘情况
+- [ ] 测试命名是否清晰表达测试目的
+- [ ] 是否使用了恰当的测试辅助工具 (如 RSpec, Minitest)
+- [ ] 测试是否避免了依赖外部服务
+- [ ] 是否有适当的 fixture 或 factory
+- [ ] 测试是否快速且可靠 (没有随机失败)
+
+### 依赖管理
+- [ ] Gemfile 是否明确指定了版本约束
+- [ ] 是否避免使用过时的 gem
+- [ ] 是否考虑了 gem 的安全更新
+- [ ] 是否最小化了外部依赖
+- [ ] Gemfile.lock 是否包含在版本控制中
+- [ ] 是否注意了依赖冲突问题
+- [ ] 是否适当使用了开发环境和生产环境分组
+- [ ] 是否考虑了使用 Bundler 的 require: false 选项优化加载
+
+### 文档
+- [ ] 是否使用 RDoc/YARD 对公共 API 进行文档化
+- [ ] 是否有清晰的 README 文件
+- [ ] 复杂逻辑是否有代码注释
+- [ ] 是否有必要的开发者文档
+- [ ] 文档是否与代码同步更新
+- [ ] 是否有示例或者教程
+- [ ] 是否有 CHANGELOG 记录变更
+- [ ] API 参数和返回值是否有文档描述
+""" 

jarvis/jarvis_code_analysis/checklists/rust.py

@@ -0,0 +1,58 @@
+"""
+Rust language-specific code review checklist.
+"""
+
+CHECKLIST = """
+## Rust 代码审查检查清单
+
+### 内存安全
+- [ ] 是否避免了不安全代码块 (unsafe)
+- [ ] 如有 unsafe 代码，是否有充分的注释和证明
+- [ ] 生命周期参数是否正确标注
+- [ ] 引用是否遵循借用规则
+
+### 错误处理
+- [ ] 是否正确使用 Result 和 Option 类型
+- [ ] 错误传播操作符 (?) 是否合理使用
+- [ ] 错误类型是否合适
+- [ ] 是否有自定义错误类型
+
+### 并发安全
+- [ ] 可变状态是否受到 Mutex/RwLock 保护
+- [ ] 是否避免了死锁风险
+- [ ] Send/Sync trait 实现是否安全
+- [ ] 是否正确使用原子类型
+
+### 性能
+- [ ] 是否避免了不必要的克隆
+- [ ] 是否合理使用了引用而非所有权转移
+- [ ] 数据结构选择是否高效
+- [ ] 是否合理使用了迭代器
+
+### 代码风格
+- [ ] 是否遵循 Rust 官方风格指南
+- [ ] 命名是否符合 Rust 约定
+- [ ] 代码是否通过 clippy 静态分析
+- [ ] 是否避免了过度使用宏
+
+### API 设计
+- [ ] 公共 API 是否有文档注释
+- [ ] 类型和函数是否遵循最小权限原则
+- [ ] trait 边界是否合理
+- [ ] 泛型参数使用是否合适
+
+### 依赖管理
+- [ ] 是否有明确的版本约束
+- [ ] 是否最小化了依赖数量
+- [ ] 是否避免了有安全问题的依赖
+
+### 测试
+- [ ] 是否有单元测试
+- [ ] 是否测试了错误路径
+- [ ] 是否使用了属性测试 (property testing)
+- [ ] 文档示例是否可执行
+
+### 资源管理
+- [ ] 资源是否通过 Drop trait 正确释放
+- [ ] 是否避免了资源泄漏
+""" 

jarvis/jarvis_code_analysis/checklists/shell.py

@@ -0,0 +1,75 @@
+"""
+Shell/Bash language-specific code review checklist.
+"""
+
+CHECKLIST = """
+## Shell/Bash 代码审查检查清单
+
+### 脚本结构和可读性
+- [ ] 是否有明确的 shebang 行 (#!/bin/bash 或 #!/usr/bin/env bash)
+- [ ] 是否有脚本描述和使用说明
+- [ ] 代码是否有一致的缩进和格式
+- [ ] 函数和代码块是否有注释说明
+- [ ] 命名是否清晰表达意图
+- [ ] 是否使用 shellcheck 等工具检查代码
+
+### 错误处理和调试
+- [ ] 是否设置了 `set -e` 或 `set -o errexit`
+- [ ] 是否适当处理管道失败 (`set -o pipefail`)
+- [ ] 是否处理未声明变量 (`set -u` 或 `set -o nounset`)
+- [ ] 是否有适当的错误消息和日志
+- [ ] 退出代码 (exit codes) 是否一致且有意义
+- [ ] 是否考虑了错误路径和异常情况
+
+### 命令和管道
+- [ ] 复杂管道是否可读和可维护
+- [ ] 是否避免了不必要的命令和处理步骤
+- [ ] 是否考虑了命令失败的情况
+- [ ] 是否避免了不必要的子 shell
+- [ ] 是否正确使用命令替换 ($(...) 而非 `...`)
+
+### 变量和参数
+- [ ] 变量引用是否使用双引号 ("$var" 而非 $var)
+- [ ] 是否避免了全局变量污染
+- [ ] 是否使用有意义的变量名
+- [ ] 是否正确处理特殊字符和空格
+- [ ] 是否验证命令行参数
+- [ ] 是否设置了默认值 (${var:-default})
+- [ ] 常量是否使用大写命名
+
+### 函数
+- [ ] 是否适当使用函数模块化代码
+- [ ] 函数是否有明确的输入和输出
+- [ ] 函数是否有文档说明
+- [ ] 函数是否是幂等的 (可重复运行)
+- [ ] 是否避免了副作用
+- [ ] 返回状态是否明确
+
+### 安全性
+- [ ] 是否安全处理用户输入
+- [ ] 是否避免了命令注入风险
+- [ ] 敏感信息是否安全管理 (不使用明文密码)
+- [ ] 临时文件是否安全创建和清理
+- [ ] 是否正确设置了文件权限
+- [ ] 是否避免了 eval 和其他危险结构
+
+### 可移植性
+- [ ] 是否考虑了不同 shell 的兼容性 (bash, sh, zsh)
+- [ ] 是否避免了系统特定的命令和功能
+- [ ] 是否考虑了路径的可移植性
+- [ ] 是否考虑了不同环境的差异 (Linux, macOS)
+- [ ] 外部依赖是否明确记录
+
+### 性能
+- [ ] 是否避免了不必要的外部命令调用
+- [ ] 循环是否高效
+- [ ] 是否优化了文件 I/O 操作
+- [ ] 是否避免了不必要的重复计算
+- [ ] 是否合理使用并行处理
+
+### 可测试性
+- [ ] 代码是否易于测试
+- [ ] 是否有自动化测试
+- [ ] 测试是否涵盖主要功能和错误路径
+- [ ] 是否可以使用 mock 替换外部依赖
+""" 

jarvis/jarvis_code_analysis/checklists/sql.py

@@ -0,0 +1,72 @@
+"""
+SQL language-specific code review checklist.
+"""
+
+CHECKLIST = """
+## SQL 代码审查检查清单
+
+### 查询设计和可读性
+- [ ] SQL 语句是否格式化和缩进一致
+- [ ] 是否使用有意义的表和列名
+- [ ] 是否有注释说明复杂查询
+- [ ] 是否使用了一致的命名约定
+- [ ] 是否避免了过度复杂的查询
+- [ ] 是否适当使用子查询和公共表表达式 (CTE)
+
+### 性能优化
+- [ ] 是否有合适的索引支持查询
+- [ ] 大表查询是否使用了分页
+- [ ] 是否避免了全表扫描
+- [ ] WHERE 条件是否能有效利用索引
+- [ ] JOIN 操作是否高效
+- [ ] 是否避免了使用 SELECT *
+- [ ] 是否避免了不必要的排序和聚合
+- [ ] 是否使用了适当的索引提示
+- [ ] 大批量操作是否分批处理
+- [ ] 触发器和存储过程是否高效
+
+### 数据完整性和约束
+- [ ] 是否定义了适当的主键
+- [ ] 是否使用了外键约束
+- [ ] 是否添加了适当的 NOT NULL 约束
+- [ ] 是否设置了合理的默认值
+- [ ] 是否使用了检查约束验证数据
+- [ ] 事务是否保持一致性
+
+### 安全性
+- [ ] 是否防范 SQL 注入
+- [ ] 是否使用参数化查询
+- [ ] 权限是否遵循最小权限原则
+- [ ] 敏感数据是否加密存储
+- [ ] 是否限制了查询结果集大小
+- [ ] 是否避免了在查询中使用 SQL 动态构建
+
+### 并发和锁定
+- [ ] 是否考虑了并发访问
+- [ ] 事务范围是否最小化
+- [ ] 是否使用了适当的隔离级别
+- [ ] 是否避免了长时间锁定资源
+- [ ] 是否考虑了死锁问题
+- [ ] 是否处理了锁超时错误
+
+### 可维护性和兼容性
+- [ ] 脚本是否是幂等的 (可重复运行)
+- [ ] 是否有数据库版本控制和迁移策略
+- [ ] 是否考虑了数据库引擎兼容性
+- [ ] 是否有针对各种错误情况的处理
+- [ ] 是否有回滚策略
+- [ ] 模式更改是否安全可靠
+
+### 特定数据库最佳实践
+- [ ] 是否遵循特定数据库引擎的最佳实践
+- [ ] 是否合理使用数据库特有功能
+- [ ] 是否考虑了不同数据库方言的差异
+- [ ] 是否使用了合适的数据类型
+
+### 测试
+- [ ] 是否有针对 SQL 的单元测试
+- [ ] 是否测试了边缘情况
+- [ ] 是否验证了结果集的正确性
+- [ ] 是否测试了性能和负载
+- [ ] 是否有数据恢复测试
+""" 

jarvis/jarvis_code_analysis/checklists/swift.py

@@ -0,0 +1,77 @@
+"""
+Swift language-specific code review checklist.
+"""
+
+CHECKLIST = """
+## Swift 代码审查检查清单
+
+### 代码风格和格式
+- [ ] 是否遵循 Swift API 设计指南
+- [ ] 命名是否清晰明确 (驼峰式命名法)
+- [ ] 是否使用 SwiftLint 等工具进行代码规范检查
+- [ ] 缩进和格式是否一致
+- [ ] 是否避免了过长的函数和过度嵌套
+
+### Swift 语言特性
+- [ ] 是否正确使用可选类型 (Optional)
+- [ ] 是否安全地解包可选值
+- [ ] 是否适当使用类型推断
+- [ ] 是否合理使用值类型和引用类型
+- [ ] 是否正确使用协议和扩展
+- [ ] 是否适当使用属性观察器 (willSet/didSet)
+- [ ] 是否正确使用闭包和逃逸闭包
+- [ ] 是否合理使用 guard 语句和条件提前返回
+
+### 内存管理
+- [ ] 是否避免了循环引用 (使用 weak 或 unowned)
+- [ ] 闭包捕获列表是否正确设置
+- [ ] 是否正确处理委托和通知的生命周期
+- [ ] 是否避免了内存泄漏
+
+### 并发和异步
+- [ ] 是否正确使用 GCD 或 Operation
+- [ ] 是否避免了线程竞争
+- [ ] UI 更新是否在主线程进行
+- [ ] 是否正确处理异步操作的取消和超时
+- [ ] Swift 5.5+ 是否合理使用结构化并发 (async/await)
+
+### 性能优化
+- [ ] 是否避免不必要的计算或对象创建
+- [ ] 集合操作是否高效
+- [ ] 是否避免了过度使用字符串操作
+- [ ] 是否考虑了缓存策略
+- [ ] 是否避免了过度使用计算属性
+
+### 用户界面 (UI)
+- [ ] 约束是否正确设置 (没有冲突或歧义)
+- [ ] 是否考虑了不同屏幕尺寸和方向
+- [ ] 是否遵循人机界面指南 (HIG)
+- [ ] 是否适当使用 SF Symbols 和系统字体
+- [ ] 是否适配了深色模式
+
+### 安全性
+- [ ] 敏感数据是否使用钥匙串存储
+- [ ] 网络请求是否使用 HTTPS
+- [ ] 输入验证是否充分
+- [ ] 是否防范 JSON 解析错误
+- [ ] 是否避免硬编码凭证
+
+### 依赖管理
+- [ ] 第三方依赖是否必要
+- [ ] 依赖版本是否固定
+- [ ] 是否考虑了依赖的维护状态和安全性
+- [ ] 是否最小化了外部依赖
+
+### 测试
+- [ ] 是否有单元测试覆盖核心功能
+- [ ] 是否使用 XCTest 框架进行测试
+- [ ] 是否测试了错误路径和边界条件
+- [ ] UI 测试是否覆盖主要用户流程
+- [ ] 测试是否独立且可重复
+
+### 文档和注释
+- [ ] 是否使用 Xcode 的标记注释 (MARK, TODO, FIXME)
+- [ ] 复杂逻辑是否有注释说明
+- [ ] 公开 API 是否有文档注释
+- [ ] 注释是否与代码保持同步
+""" 

jarvis/jarvis_code_analysis/checklists/web.py

@@ -0,0 +1,97 @@
+"""
+HTML/CSS specific code review checklist.
+"""
+
+CHECKLIST = """
+## HTML/CSS 代码审查检查清单
+
+### HTML 结构和语义
+- [ ] 是否使用了正确的 HTML5 文档类型声明 (<!DOCTYPE html>)
+- [ ] 是否使用了语义化标签 (header, nav, main, section, article, footer 等)
+- [ ] 文档结构是否清晰且符合逻辑
+- [ ] 标题层级 (h1-h6) 是否正确使用且有层次性
+- [ ] 是否正确使用列表元素 (ul, ol, dl) 来组织列表内容
+- [ ] 链接是否有描述性文本 (避免使用 "点击这里" 之类的文本)
+- [ ] 图片是否有适当的 alt 属性
+- [ ] 表单元素是否有关联的 label 标签
+
+### HTML 最佳实践
+- [ ] 是否使用 UTF-8 字符编码
+- [ ] 是否正确设置了视口元标签 (meta viewport)
+- [ ] 是否使用了适当的 SEO 元标签
+- [ ] ID 是否唯一
+- [ ] 类名是否有意义且符合命名约定
+- [ ] 是否避免使用内联样式
+- [ ] 是否有适当的注释说明复杂结构
+- [ ] 是否避免了过度的标签嵌套
+
+### CSS 组织和架构
+- [ ] 是否使用了 CSS 方法论 (如 BEM, OOCSS, SMACSS)
+- [ ] 选择器是否有效且明确
+- [ ] 是否避免过于具体的选择器 (避免过度的嵌套选择器)
+- [ ] 是否有清晰的组件/模块化结构
+- [ ] 样式规则是否按照逻辑分组和排序
+- [ ] 类命名约定是否一致
+- [ ] 是否使用 CSS 变量管理主题和重复值
+- [ ] 是否使用适当的注释分隔不同的样式部分
+
+### CSS 最佳实践
+- [ ] 是否使用了 CSS 重置或归一化 (Normalize.css)
+- [ ] 是否使用响应式设计 (媒体查询)
+- [ ] 是否使用了合适的单位 (rem/em 用于字体大小, 百分比或 vw/vh 用于响应式布局)
+- [ ] 是否设置了合理的盒模型 (box-sizing: border-box)
+- [ ] 是否避免使用 !important
+- [ ] 是否使用了 flexbox 或 grid 进行布局
+- [ ] 颜色和字体是否一致
+- [ ] z-index 管理是否合理
+
+### 性能优化
+- [ ] 是否避免了不必要的标签嵌套和冗余元素
+- [ ] CSS 选择器是否简洁高效
+- [ ] 是否避免使用复杂的选择器
+- [ ] 是否使用了适当的图片格式和优化
+- [ ] 是否为大型网站考虑使用 CSS 分片/代码分割
+- [ ] 是否使用了合适的资源延迟加载策略
+- [ ] 是否最小化了重绘和回流
+- [ ] 是否优化了关键渲染路径
+
+### 可访问性 (A11Y)
+- [ ] 颜色对比度是否符合 WCAG 标准
+- [ ] 是否正确使用了 ARIA 属性
+- [ ] 交互元素是否能够通过键盘访问
+- [ ] 是否有适当的焦点状态样式
+- [ ] 文本是否可调整大小
+- [ ] 动画是否可控制或禁用 (prefers-reduced-motion)
+- [ ] 表单错误是否清晰且易于理解
+- [ ] 是否通过了可访问性测试和验证
+
+### 跨浏览器兼容性
+- [ ] 是否测试了主要浏览器兼容性
+- [ ] 是否使用了适当的浏览器前缀
+- [ ] 是否避免使用尚未广泛支持的特性
+- [ ] 是否有适当的回退方案
+- [ ] 是否使用了适当的 polyfills
+- [ ] 样式和布局是否在不同设备上保持一致
+- [ ] 字体渲染是否考虑了跨平台差异
+- [ ] 是否解决了已知的浏览器特定问题
+
+### CSS 预处理器 (如适用)
+- [ ] 是否合理使用了变量
+- [ ] 是否合理使用了混合 (mixins)
+- [ ] 嵌套规则是否控制在合理深度
+- [ ] 是否使用了 partials/imports 来组织代码
+- [ ] 是否避免了生成过度复杂的 CSS
+- [ ] 函数和操作符是否使用得当
+- [ ] 扩展/继承是否使用得当
+- [ ] 是否避免了重复的代码
+
+### 文档和注释
+- [ ] 复杂的 HTML 结构是否有注释
+- [ ] 是否有足够的 CSS 注释
+- [ ] 是否有设计系统/组件文档
+- [ ] 是否记录了浏览器特定的解决方案和黑客技巧
+- [ ] 是否记录了颜色系统、排版和网格系统
+- [ ] 是否有清晰的 README 或风格指南
+- [ ] CSS 变量是否有适当的命名和注释
+- [ ] 不明显的布局决策是否有解释
+"""