pi-effect-harness
专为 Effect v4 框架设计的代码测试工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-effect-harness。 它的用途是：专为 Effect v4 框架设计的代码测试工具 完整的 Skill 内容见：https://321skill.com/skills/pi-effect-harness/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用 pi-effect-harness 为这个 Effect 程序写一个测试用例，模拟数据库调用失败的情况。'，它会引导你使用工具提供的 `TestContext` 和 `Effect.gen` 来构建测试，设置模拟的失败层，并验证程序是否按预期抛出了特定错误。
介绍
pi-effect-harness 是一个专门用于编写和测试 Effect v4 代码的工具套件。它解决了开发者在 Effect 生态中进行单元测试、集成测试时，需要手动搭建复杂测试环境和模拟依赖的痛点。
使用该工具时，开发者可以将其作为开发依赖安装，并利用其提供的特定 API 来创建测试用例、模拟 Effect 程序的执行环境，从而方便地验证异步流程、错误处理和资源管理等场景。
它非常适合正在使用或计划使用 Effect v4 函数式编程库的 TypeScript/JavaScript 开发者，特别是那些注重代码健壮性、需要进行严格测试的团队或个人项目。
建议在使用前熟悉 Effect v4 的基本概念。由于它紧密绑定 Effect v4 的特定版本，在升级 Effect 主库时需注意兼容性，并优先参考其官方文档进行配置。
核心特点
这是专门为 Effect v4 的函数式编程模型和运行时特性（如 Fiber、Scope）量身定制的测试工具，而非通用的测试框架。它深度集成了 Effect 的 `TestContext` 和层（Layer）系统，能更原生地模拟和验证 Effect 程序的副作用与依赖。
注意事项
仅适用于 Effect v4 项目，不适用于测试其他框架或普通 JavaScript/TypeScript 代码。
常见问题
pi-effect-harness 和 Jest/Vitest 有什么区别？
它是 Effect v4 的专用测试工具，用于处理 Effect 特有的运行时和副作用，而 Jest/Vitest 是通用测试框架，两者可结合使用。
这个工具支持 Effect v3 吗？
不支持，它是专门为 Effect v4 设计的。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-effect-harness/raw/index.md 读取 pi-effect-harness 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-effect-harness/raw/index.md（查看排版版本）