effect-ts
Effect-TS 开发指南，TypeScript 副作用管理
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：effect-ts。 它的用途是：Effect-TS 开发指南，TypeScript 副作用管理 完整的 Skill 内容见：https://321skill.com/skills/effect-ts-x-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请帮我用 Effect-TS 实现一个带重试机制的 HTTP 请求函数，使用 v4 的 Schedule 和 Effect 模块。' 它会生成类型安全的代码，包含 RetryPolicy、Request 等核心概念，并附上注释说明重试策略和错误处理。此外，还可以问：'解释 Effect v4 中 Fiber 和 Scope 的区别，并给出一个并发任务的示例。' AI 会提供详细对比和可运行的并发代码。
介绍
Effect-TS 是一个强大的 TypeScript 函数式编程库，专注于处理异步操作、错误处理、依赖注入和并发等复杂副作用。本 Skill 提供全面的开发指南，涵盖 Effect v4（推荐默认版本）和 v3（稳定版），帮助开发者快速掌握从基础概念到高级模式（如 Fiber、Scope、STM）的用法。通过场景化示例和最佳实践，开发者可以编写类型安全、高健壮性的 Effect 代码，解决实际业务中的副作用管理难题。
使用方法：开发者可以直接在 AI 编码助手（如 Claude、Cursor 或 Trae）中加载本 Skill，然后根据需求提问。例如，要求生成带有重试机制的 HTTP 请求代码，或解释 Effect v4 中 Fiber 与 Scope 的区别。AI 会基于本指南中的知识提供准确、可运行的代码示例和详细解释，并自动适配 v4 或 v3 语法。
适合用户：本 Skill 主要面向使用 TypeScript 的后端开发者、全栈开发者以及智能体开发者。无论你是正在构建微服务、数据处理管道，还是需要管理复杂并发任务，Effect-TS 都能显著提升代码的可维护性和可测试性。适合有一定 TypeScript 基础并希望深入函数式编程的团队和个人。
使用建议：建议先通读 Effect 官方文档，再结合本 Skill 的示例进行实践。注意 v4 与 v3 在 API 和模块结构上存在差异，迁移时需仔细对照；本 Skill 提供了迁移指导，但过程中仍建议逐步测试。对于纯函数式编程新手，可能需要先学习一些基础概念（如 Monad、IO 等）以降低学习曲线。
核心特点
与同类指南相比，本 Skill 同时覆盖 Effect v4 和 v3，并提供从旧版本平滑迁移的实战指导，以及大量贴近真实业务场景的代码示例，而非纯理论讲解。
注意事项
不适合完全不具备 TypeScript 或函数式编程基础的新手，学习曲线较陡，且无法替代官方 API 文档的完整参考。
常见问题
Effect v4 和 v3 有什么区别？
v4 是推荐默认版本，API 更简洁，模块重新组织，性能优化；v3 为稳定版仍广泛使用。本 Skill 覆盖两者，并提供迁移指南。
如何开始使用 Effect-TS？
安装 npm 包 `effect`（v4）或 `@effect-ts/core`（v3），然后导入模块编写 Effect 代码。本 Skill 中的示例可直接运行。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/effect-ts-x-5/raw/index.md 读取 effect-ts 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/effect-ts-x-5/raw/index.md（查看排版版本）