メニュー
YWeb 基础设施模块规范。在使用缓存（@cached）、异常处理（Err/register_exception_handlers）、日志（get_logger）、配置（AppSettings/YAML）、文件存储（本地/OSS/S3）、定时任务（Scheduler）、限流（setup_ratelimit）时使用。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| 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 初始化和事件订阅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 策略、异步测试等场景。