effect-index

Effect 技能索引

使用此索引快速找到适合你任务的技能。每个条目都链接到一个专注于特定领域的技能，针对编码 Agent 有限的上下文进行了优化。

决策树

• 我需要编写或重构一些 Effect 代码 → 基础知识
• 我需要健壮的错误处理／重试 → 错误与重试
• 我必须并行运行任务／管理 fiber → 并发与 Fiber
• 这是一个数据管道／批处理／背压场景 → 流与管道
• 我需要 DI／服务／层，或测试／生产环境的连接配置 → 层与服务
• 打开文件／套接字／服务并进行清理 → 资源与作用域
• 添加 HTTP 端点／JSON 响应 → HTTP 与路由
• 验证输入／解析配置 → 配置与 Schema
• 基于值的相等性／高性能不可变集合 → 数据结构
• 时间、日志记录、span／追踪 → 时间／追踪／日志记录
• 队列、PubSub、后台工作器 → 队列与后台任务
• 为服务编写测试／模拟 → 测试与模拟
• 查找特定模式或示例 → 模式中心（130 多种模式）

跨技能模式

所有模式现在都可在本地的模式中心（130 多种模式）中找到：

• 重试瞬时故障 → 错误与重试 + retry-based-on-specific-errors.mdx
• 资源安全的流处理 → 流与管道 + stream-manage-resources.mdx
• 优雅关闭 → 队列与后台任务 + execute-long-running-apps-with-runfork.mdx
• 服务层设计 → 层与服务 + model-dependencies-as-services.mdx
• HTTP 服务设置 → HTTP 与路由 + build-a-basic-http-server.mdx
• Schema 验证 → 配置与 Schema + define-contracts-with-schema.mdx
• 使用模拟进行测试 → 测试与模拟 + mocking-dependencies-in-tests.mdx

提示：对于任何“如何……”的问题，请先查看模式中心中的决策树！

本地源代码参考

重要：实现之前务必搜索本地 Effect 源代码

完整的 Effect 源代码位于 docs/effect-source/。现在，每个 Effect 技能都包含一个“本地源代码参考”部分，其中列有：

• 该技能领域的关键源文件
• 用于查找实现的示例 grep 命令
• 编码前进行搜索的工作流

快速访问源代码

• 所有 Effect 软件包：docs/effect-source/
• 核心库：docs/effect-source/effect/src/
• Platform API：docs/effect-source/platform/src/
• SQL：docs/effect-source/sql/src/
• Schema：docs/effect-source/schema/src/

示例：查找 Effect.gen

grep -F "Effect.gen" docs/effect-source/effect/src/Effect.ts

工作流提醒

1. 阅读相关技能（参见上方决策树）
2. 查看技能的“本地源代码参考”部分
3. 在 Effect 源代码中搜索所需的 API
4. 研究实现和类型
5. 根据实际实现编写代码

有关完整的源代码参考指南，请参阅 CLAUDE.local.md

参考资料

• Agent Skills 概览：Introducing Agent Skills
• Skills 指南：Claude Code Skills Documentation
• 本地模式中心：../effect-patterns-hub/SKILL.md（130+ 种模式）
• 模式文档：../../docs/effect-patterns/
• AGENTS.md：../../AGENTS.md（面向 AI Agent 的 Effect 最佳实践）
• EffectPatterns（上游源代码）：PaulJPhilp/EffectPatterns