effect-index
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseEffect 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 examples → Patterns 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 failures → Errors & Retries + retry-based-on-specific-errors.mdx
- Resource-safe streaming → Streams & Pipelines + stream-manage-resources.mdx
- Graceful shutdown → Queues & Background + execute-long-running-apps-with-runfork.mdx
- Service layer design → Layers & Services + model-dependencies-as-services.mdx
- HTTP server setup → HTTP & Routing + build-a-basic-http-server.mdx
- Schema validation → Config & Schema + define-contracts-with-schema.mdx
- Testing with mocks → Testing & 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 . Every Effect skill now includes a "Local Source Reference" section with:
docs/effect-source/- Key source files for that skill's domain
- Example grep commands to find implementations
- Workflow for searching before coding
重要提示:在实现前务必先搜索本地Effect源码
完整的Effect源码位于。每个Effect Skill现在都包含一个“本地源码参考”部分,内容包括:
docs/effect-source/- 该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.tsbash
grep -F "Effect.gen" docs/effect-source/effect/src/Effect.tsWorkflow Reminder
工作流提醒
- Read the relevant skill (from decision tree above)
- Review the skill's "Local Source Reference" section
- Search the Effect source code for the API you need
- Study the implementation and types
- Write your code based on real implementations
See CLAUDE.local.md for complete source reference guide
- 阅读相关Skill(来自上方的决策树)
- 查看该Skill的“本地源码参考”部分
- 在Effect源码中搜索你需要的API
- 研究实现和类型定义
- 基于真实实现编写代码
完整的源码参考指南请查看CLAUDE.local.md
References
参考资料
- Agent Skills overview: Introducing Agent Skills
- Skills guide: Claude Code Skills Documentation
- Local Patterns Hub: ../effect-patterns-hub/SKILL.md (130+ patterns)
- Pattern Documentation: ../../docs/effect-patterns/
- AGENTS.md: ../../AGENTS.md (Effect best practices for AI agents)
- EffectPatterns (upstream source): PaulJPhilp/EffectPatterns
- 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