effect-ts

为Claude Code设计的Effect TypeScript开发技能,强制所有TypeScript代码使用Effect库。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:effect-ts。
它的用途是:为Claude Code设计的Effect TypeScript开发技能,强制所有TypeScript代码使用Effect库。
完整的 Skill 内容见:https://321skill.com/skills/effect-ts/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我写一个从API获取用户列表的函数。”,它会自动使用Effect的Effect、Schema和Context等服务来构建类型安全、可测试的异步数据流。或者问:“如何优雅地处理这个函数可能抛出的网络错误?”,它会基于ERRORS.md中的模式,提供使用Effect的try/catch或错误通道的解决方案。

介绍

这个Skill旨在解决开发者在TypeScript项目中,希望全面、一致地采用Effect库进行类型安全、可组合编程,但需要反复提示AI或团队成员遵循此规范的痛点。它通过一个强制性的CLAUDE.md文件配置,确保Claude在编写任何TypeScript代码时,都会自动、优先地使用Effect的模式和最佳实践,从而统一团队技术栈,提升代码质量。

使用方式分为两步:首先将Skill文件安装到个人或项目的.claude/skills目录下;其次,也是关键一步,将提供的CLAUDE.md.template模板内容复制到项目根目录的CLAUDE.md文件中。这样,Claude在项目上下文中就会自动启用该Skill。

它非常适合正在或计划全面采用Effect库的TypeScript项目团队,尤其是后端开发、全栈开发以及智能体开发者。对于希望构建高可靠性、强类型、易于测试和依赖注入的应用程序的团队来说,这是一个强有力的辅助工具。

需要注意的是,此Skill通过CLAUDE.md强制生效,因此只应在确实决定全面使用Effect的项目中部署。如果项目仅部分模块使用Effect,或希望灵活选择,则此强制策略可能过于激进,需要谨慎评估。

核心特点

与普通介绍Effect库的文档不同,此Skill通过项目级CLAUDE.md配置,强制Claude在所有TypeScript代码中自动应用Effect,无需每次手动提示,实现了开发规范的“自动化”和“零配置”执行。

注意事项

不适合在仅部分使用Effect或需要混合其他编程范式的TypeScript项目中强制使用。

常见问题

如何让Claude只在特定文件或模块中使用Effect?

此Skill设计为全局强制使用,如需灵活控制,建议不部署CLAUDE.md文件,仅在需要时口头要求Claude使用Effect。

安装后Claude没有使用Effect怎么办?

请检查项目根目录下是否存在CLAUDE.md文件,并确保其内容包含了要求使用Effect的指令。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/effect-ts/raw/index.md 读取 effect-ts 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。