effect-index

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Effect Skill Index

Effect Skill索引

Use this as a quick router to the right Skill for your task. Each entry links to a focused Skill optimized for a coding agent’s limited context.
将此用作快速导航工具,帮你为任务选择合适的Skill。每个条目都链接到一个针对编码Agent有限上下文优化的专属Skill。

Decision Tree

决策树

  • I need to write or refactor some Effect code → Foundations
  • I need robust error handling/retries → Errors & Retries
  • I must run things in parallel / manage fibers → Concurrency & Fibers
  • This is a data pipeline / batching / backpressure → Streams & Pipelines
  • I need DI/services/layers or test/live wiring → Layers & Services
  • Opening files/sockets/servers with cleanup → Resources & Scope
  • Add HTTP endpoints / JSON responses → HTTP & Routing
  • Validate inputs / parse config → Config & Schema
  • Value-based equality / high-perf immutable collections → Data Structures
  • Time, logging, spans/tracing → Time/Tracing/Logging
  • Queues, PubSub, background workers → Queues & Background
  • Write tests/mocks for services → Testing & Mocking
  • Looking for specific patterns or examplesPatterns Hub (130+ patterns)
  • 我需要编写或重构Effect代码 → 基础技能
  • 我需要可靠的错误处理/重试机制 → 错误与重试
  • 我必须并行运行任务/管理纤程 → 并发与纤程
  • 这是数据管道/批处理/背压场景 → 流与管道
  • 我需要依赖注入/服务/分层架构或测试/生产环境配置 → 分层与服务
  • 打开文件/套接字/服务器并需要清理资源 → 资源与作用域
  • 添加HTTP端点/JSON响应 → HTTP与路由
  • 验证输入/解析配置 → 配置与Schema
  • 基于值的相等性/高性能不可变集合 → 数据结构
  • 时间、日志、链路追踪 → 时间/追踪/日志
  • 队列、发布订阅、后台任务 → 队列与后台任务
  • 为服务编写测试/模拟 → 测试与模拟
  • 寻找特定模式或示例模式中心(130+种模式)

Cross-Skill Patterns

跨Skill模式

All patterns are now available locally in the Patterns Hub (130+ patterns):
  • Retry transient failuresErrors & Retries + retry-based-on-specific-errors.mdx
  • Resource-safe streamingStreams & Pipelines + stream-manage-resources.mdx
  • Graceful shutdownQueues & Background + execute-long-running-apps-with-runfork.mdx
  • Service layer designLayers & Services + model-dependencies-as-services.mdx
  • HTTP server setupHTTP & Routing + build-a-basic-http-server.mdx
  • Schema validationConfig & Schema + define-contracts-with-schema.mdx
  • Testing with mocksTesting & Mocking + mocking-dependencies-in-tests.mdx
Tip: For any "How do I...?" question, check the Patterns Hub decision tree first!
所有模式现在都可在本地模式中心(130+种模式)中获取:
  • 重试临时故障错误与重试 + 基于特定错误的重试.mdx
  • 资源安全的流处理流与管道 + 流处理资源管理.mdx
  • 优雅关机队列与后台任务 + 使用runfork运行长期应用.mdx
  • 服务层设计分层与服务 + 将依赖建模为服务.mdx
  • HTTP服务器搭建HTTP与路由 + 构建基础HTTP服务器.mdx
  • Schema验证配置与Schema + 用Schema定义契约.mdx
  • 使用模拟进行测试测试与模拟 + 测试中的依赖模拟.mdx
提示:对于任何“如何实现...?”的问题,请先查看模式中心的决策树!

Local Source Reference

本地源码参考

CRITICAL: Always search local Effect source before implementing
The full Effect source code is available at
docs/effect-source/
. Every Effect skill now includes a "Local Source Reference" section with:
  • Key source files for that skill's domain
  • Example grep commands to find implementations
  • Workflow for searching before coding
重要提示:在实现前务必先搜索本地Effect源码
完整的Effect源码位于
docs/effect-source/
。每个Effect Skill现在都包含一个“本地源码参考”部分,内容包括:
  • 该Skill领域的关键源码文件
  • 用于查找实现的grep命令示例
  • 编码前的搜索工作流

Quick Access to Source

快速访问源码

  • All Effect packages:
    docs/effect-source/
  • Core library:
    docs/effect-source/effect/src/
  • Platform APIs:
    docs/effect-source/platform/src/
  • SQL:
    docs/effect-source/sql/src/
  • Schema:
    docs/effect-source/schema/src/
  • 所有Effect包:
    docs/effect-source/
  • 核心库:
    docs/effect-source/effect/src/
  • 平台API:
    docs/effect-source/platform/src/
  • SQL:
    docs/effect-source/sql/src/
  • Schema:
    docs/effect-source/schema/src/

Example: Finding Effect.gen

示例:查找Effect.gen

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

Workflow Reminder

工作流提醒

  1. Read the relevant skill (from decision tree above)
  2. Review the skill's "Local Source Reference" section
  3. Search the Effect source code for the API you need
  4. Study the implementation and types
  5. Write your code based on real implementations
See CLAUDE.local.md for complete source reference guide
  1. 阅读相关Skill(来自上方的决策树)
  2. 查看该Skill的“本地源码参考”部分
  3. 在Effect源码中搜索你需要的API
  4. 研究实现和类型定义
  5. 基于真实实现编写代码
完整的源码参考指南请查看CLAUDE.local.md

References

参考资料