用途：面向在 TypeScript 中使用 Effect 库（effect、@effect/schema、@effect/platform）的编写与审查场景，帮助建立结构化错误处理、依赖注入、Fiber 并发与资源安全的心智模型。
主要内容：建议先阅读“Think in Effect: The Paradigm Shift”了解思维模型、重构配方与反模式，再按领域查阅。核心基础含 Getting Started（创建 Effect 类型、管道、生成器、运行效果）、Error Management（类型化错误、恢复、重试、超时）、Core Concepts（请求批处理、配置、运行时）。数据与验证含 Data Types（Option、Either、Cause、Chunk、DateTime、Duration、Exit、Data）与 Schema 基础及进阶。架构与依赖含 Requirements Management（Services、Layers、依赖注入）、Resource Management（Scope）与 State Management（Ref 等）。并发与流含 Concurrency（Fiber、Deferred、PubSub、Queue、Semaphore）、Streams and Sinks、Scheduling。另含 Platform、Observability（日志、指标、追踪）、Testing（TestClock）、Code Style、AI Integration、Micro，以及从 Promises、fp-ts、neverthrow、ZIO 的迁移指南。
使用方式：按所在域读取对应参考文件。资料给出常见模式，如 Effect.succeed、Effect.fail、Effect.try、Effect.tryPromise、Effect.gen，运行用 Effect.runPromise/runPromiseExit/runSync；类型化错误用 Data.TaggedError；服务用 Context.Tag 加 Layer.succeed 并通过 Effect.provide 注入；Schema 用 Schema.Struct 加 decodeUnknownSync；管道用 pipe 或 .pipe。
限制：适用范围限于导入 effect 相关包的代码；具体 API 行为、版本兼容性、性能代价及已知失败点（gotchas.md）本次资料未完整展开，使用时需自行核对。