effect-ts
Effect-TS 开发全流程 AI 辅助指南
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：effect-ts。 它的用途是：Effect-TS 开发全流程 AI 辅助指南 完整的 Skill 内容见：https://321skill.com/skills/effect-ts-x-6/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我写一个 Effect-TS v4 的代码，读取 config.json 文件并解析，如果文件不存在则返回默认配置，要求使用 Effect 的 Error 处理。' 它会生成包含 readFile, parseJSON, 以及 fallback 逻辑的完整代码，并标注类型注解。
介绍
Effect-TS 是 TypeScript 生态中强大的函数式编程库，但学习曲线陡峭，且 v3 与 v4 存在 API 差异。本 Skill 旨在解决开发者在编写 Effect-TS 代码时遇到的类型错误、模式选择、版本兼容等问题，提供从入门到实战的一站式指导。
使用时，您可以直接向 AI 描述需求，例如“用 Effect-TS 实现一个带重试的文件读取函数”或“将这段 v3 代码迁移到 v4”。AI 会基于最新的 Effect-TS 文档和最佳实践，生成类型安全、符合惯用法的代码，并解释关键概念。
适合正在使用或计划使用 Effect-TS 的后端、全栈及智能体开发者，尤其是需要维护 v3 旧代码库并逐步迁移到 v4 的团队，以及希望快速掌握 Effect-TS 模式（如 Fiber、Scope、Layer）的学习者。
建议结合官方文档使用，本 Skill 偏向代码生成与调试辅助，不替代完整 API 手册。对于非 Effect-TS 的 FP 库（如 fp-ts），效果有限。
核心特点
同时深度支持 Effect-TS v3 和 v4，自动识别版本并给出对应语法，且提供迁移辅助，而同类工具通常只覆盖单个版本。
注意事项
不适合非 TypeScript 项目或非 Effect-TS 的函数式编程库（如 fp-ts、Zio）。
常见问题
如何用 Effect-TS 处理 HTTP 请求？
使用 Effect 的 HttpClient 模块，或集成 axios/fetch 通过 Effect.promise 包装。
v3 和 v4 的核心区别是什么？
v4 重构了模块结构，引入了 Effect 类型作为核心，并移除了 @effect-ts 命名空间，推荐使用 effect 包。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/effect-ts-x-6/raw/index.md 读取 effect-ts 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/effect-ts-x-6/raw/index.md（查看排版版本）