القائمة
YWeb 基础设施模块规范。在使用缓存（@cached）、异常处理（Err/register_exception_handlers）、日志（get_logger）、配置（AppSettings/YAML）、文件存储（本地/OSS/S3）、定时任务（Scheduler）、限流（setup_ratelimit）时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
YWeb DDD 分层架构与 API 设计规范。在创建或修改 API 路由、Service 层、领域模型、DTO 时使用。涵盖瘦 API 原则、服务层拆分、Model 设计、DTO 转换、响应格式等。
YWeb ORM 使用规范。在编写数据库模型定义、CRUD 操作、查询过滤、分页、软删除、事务管理、批量操作、关系定义等数据层代码时使用。基于 SQLAlchemy 的 Active Record 模式。
YWeb 认证授权与权限管理规范。在实现用户登录、JWT Token 处理、权限校验、角色管理、组织架构、OAuth 集成等功能时使用。
YWeb 框架编码总规范。基于 FastAPI + SQLAlchemy 的 Web 框架，采用 Active Record + DDD 分层架构。在编写任何基于 yweb 框架的代码时使用此技能，包括 API 开发、ORM 操作、认证授权、缓存、异常处理等场景。
审查和改进 pytest 测试的真实性，防止 Happy Path、浅层、实现驱动、同义反复等虚假测试；在测试失败时执行先诊断后改码流程。用于测试评审、测试重构、失败排查场景。
YWeb 框架 Pytest 单元测试编写规范。适用于 yweb-core 底层框架本身，以及通过 pip install yweb 安装后基于该框架开发的任何上层应用。涵盖测试目录结构、conftest 编写、fixture 模式、ORM 测试、API 测试、Service 测试、Domain 测试、Mock 策略、异步测试等场景。
| name | yweb-infra |
| description | YWeb 基础设施模块规范。在使用缓存（@cached）、异常处理（Err/register_exception_handlers）、日志（get_logger）、配置（AppSettings/YAML）、文件存储（本地/OSS/S3）、定时任务（Scheduler）、限流（setup_ratelimit）时使用。 |
@cached(ttl=秒数) 装饰器缓存函数返回值@cached(ttl=60, orm_model=Model) 自动将 detached 对象 merge 回当前 Session（load=False，零查询）module.qualname 全限定名，避免同名函数在 Redis 后端下的键冲突；也可手动指定 key_prefix="xxx"cache_invalidator.register(Model, func) 监听 ORM after_update/after_delete 事件
key_extractor(entity) 精确失效，适合 get_user(user_id) 等单实体查询watch_relationships 参数默认 True，自动监听 ManyToMany 集合的 append/remove 事件触发失效yweb-core/docs/11_cache_guide.mdregister_exception_handlers(app) 注册全局异常处理器Err 快捷类抛出业务异常ValueError，不定义自定义异常类yweb-core/docs/05_exception_handling.mdget_logger() 获取日志记录器（自动推断模块名）yweb-core/docs/04_log_guide.mdAppSettings 基础配置类yweb-core/docs/02_config_guide.mdyweb-core/docs/10_storage_guide.mdyweb-core/docs/09_scheduler_guide.mdsetup_ratelimit(app) 一站式初始化@limiter.limit("10/minute") 装饰器get_user_or_ip）Resp.TooManyRequests()）rate_limit_event_bus.subscribe(callback) 可将限流事件记录到数据库AppSettings.ratelimit（RateLimitSettings），环境变量前缀 YWEB_RL_pip install yweb[ratelimit]yweb-core/docs/14_ratelimit_guide.mdyweb-core/docs/01_quickstart.md11_cache_guide.md，重点关注 TTL 设置和失效策略05_exception_handling.md，了解 Err 快捷类和验证约束04_log_guide.md，使用 get_logger() 而非 logging.getLogger()02_config_guide.md，了解 YAML + 环境变量的优先级14_ratelimit_guide.md，了解 setup_ratelimit 初始化和事件订阅