Token导航 LogoToken导航TokenDH.com
中转站排行榜
开发执行命令github未标认证来源可访问许可证需确认审计通过

effect-handbook（效果手册）

Agent Skill

effect-handbook 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

总安装

605

周安装

26

GitHub Stars

公开资料未说明

下载量

212
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息，不托管安装包，也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：effect-handbook（效果手册）
来源仓库：https://github.com/tstelzer/skills
仓库路径：skills/effect-handbook
安装命令：
npx skills add https://github.com/tstelzer/skills --skill effect-handbook
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

skills.shnpx skills
npx skills add https://github.com/tstelzer/skills --skill effect-handbook

简介

effect-handbook 作为本仓库内 Effect 相关知识的索引中心，按意图路由到具体主题文件。

  • 非线性阅读材料，应根据当前任务选择对应章节。
  • 通过 GitHub 安装，使用 npx skills add 命令添加指定仓库的 skill/effect-handbook 路径。
  • 优先查看 topics/schema.md 等具体文件而非全文通读。
  • 适用宿主包括 Codex、Claude、Cursor、Gemini CLI，接入前应确认版本、权限和运行环境要求。

SKILL.md

Effect Handbook

Purpose

Use this as the single source of truth for Effect-related guidance in this repository. Sections are index buckets, not a reading order.

Routing Rules

  • Do not read this handbook linearly.
  • Pick one target file below.
  • Follow See also only if that file is insufficient.
  • Read exactly one: pick one target file first; only follow See also if needed.
  • Top-level routing: intent → exact file path; sections are index buckets, not reading order.

Quick Picks (Task -> File)

  • Work with Schema.Class / TaggedError / decode / encode -> topics/schema.md
  • Handle Option / Either control flow -> topics/option-either.md
  • Batch or cache data fetches with requests -> topics/request-resolver.md
  • Build a CLI command -> sections/20-cli.md
  • Configure CLI options/flags -> topics/cli-options.md
  • Configure CLI positional args -> topics/cli-args.md
  • Build interactive CLI prompts -> topics/cli-prompt.md
  • Define HTTP endpoint + handler -> sections/30-http-server.md
  • Build route-first HTTP app -> topics/http-router.md
  • Derive typed HTTP client -> topics/http-derive-client.md
  • Call external HTTP APIs -> topics/http-client.md
  • Add Swagger/OpenAPI docs -> topics/http-swagger.md
  • Handle multipart upload -> topics/http-multipart.md
  • Implement streaming HTTP endpoint -> topics/http-streaming.md
  • Use FileSystem/Path/Url/Terminal/KeyValueStore/Ndjson/Worker -> sections/40-platform.md
  • NDJSON encode/decode streams -> topics/platform-ndjson.md
  • Worker/WorkerRunner setup -> topics/platform-worker.md
  • Run Stream into platform sink -> topics/platform-stream-sink.md
  • Add typed RPC client/server -> topics/rpc.md
  • Export telemetry with OpenTelemetry -> topics/opentelemetry.md
  • Run SQL queries / transactions / streams -> topics/sql-client.md
  • Configure SQL database drivers -> topics/sql-drivers.md
  • Build schema-backed SQL resolvers -> topics/sql-resolver-schema.md
  • Run SQL migrations -> topics/sql-migrations.md
  • Write Effect tests -> sections/50-testing.md
  • Use @effect/vitest modes -> topics/testing-vitest.md
  • Retry/repeat policy -> topics/schedule-retry.md
  • Stream processing -> topics/stream.md
  • Context/Layer wiring -> topics/layer-context.md
  • Queue producer-consumer -> topics/queue.md
  • HTTP middleware/auth -> topics/http-middleware.md
  • Config/env vars -> topics/config.md

By Domain

  • Core (Effect type, composition, execution, Schema, Option/Either, requests) -> sections/00-foundations.md, sections/10-core-patterns.md, topics/schema.md, topics/option-either.md, topics/request-resolver.md
  • CLI (Command, Options, Args, Prompt) -> sections/20-cli.md
  • HTTP (HttpApi, HttpApiBuilder, HttpRouter, HttpClient) -> sections/30-http-server.md, topics/http-router.md, topics/http-client.md
  • SQL (@effect/sql, drivers, resolvers, migrations) -> topics/sql-client.md, topics/sql-drivers.md, topics/sql-resolver-schema.md, topics/sql-migrations.md
  • Platform (FileSystem, Path, Url, Terminal, KeyValueStore, Ndjson, workers) -> sections/40-platform.md
  • Distributed / observability (@effect/rpc, OpenTelemetry exporters) -> topics/rpc.md, topics/opentelemetry.md
  • Testing (it.effect, it.live, it.scoped, TestClock) -> sections/50-testing.md

By Primitive

  • Schema / Schema.Class / Schema.TaggedError -> topics/schema.md
  • Option / Either -> topics/option-either.md
  • Ref/SynchronizedRef/FiberRef -> topics/refs.md
  • Cause/Exit -> topics/cause-exit.md
  • STM -> topics/stm.md
  • Scope/resource safety -> topics/scope-resource.md
  • Deferred -> topics/deferred.md
  • Semaphore -> topics/semaphore.md
  • Cache -> topics/cache.md
  • Match -> topics/match.md
  • Logger/Metric/tracing -> topics/observability.md
  • Request / RequestResolver -> topics/request-resolver.md
  • Concurrency/fibers/racing -> topics/concurrency.md
  • Latch -> topics/latch.md
  • Stream (async iterables, pagination) -> topics/stream.md
  • Schedule (retry, repeat, backoff) -> topics/schedule-retry.md
  • Layer/Context (dependency injection) -> topics/layer-context.md
  • Queue (producer-consumer, back-pressure) -> topics/queue.md
  • PubSub (broadcast to subscribers) -> topics/pubsub.md
  • HttpApiMiddleware (auth, logging) -> topics/http-middleware.md
  • HttpClient / HttpClientRequest -> topics/http-client.md
  • HttpRouter / HttpServer -> topics/http-router.md
  • HttpApiClient derivation -> topics/http-derive-client.md
  • OpenAPI/Swagger -> topics/http-swagger.md
  • Multipart -> topics/http-multipart.md
  • HTTP streaming -> topics/http-streaming.md
  • NDJSON -> topics/platform-ndjson.md
  • Worker/WorkerRunner -> topics/platform-worker.md
  • Stream + Sink integration -> topics/platform-stream-sink.md
  • RpcGroup / RpcServer / RpcClient -> topics/rpc.md
  • NodeSdk / Otlp -> topics/opentelemetry.md
  • SqlClient / SQL fragments / transactions / streams -> topics/sql-client.md
  • SQL driver layers (PgClient, MysqlClient, SqliteClient, etc.) -> topics/sql-drivers.md
  • SqlResolver / SqlSchema -> topics/sql-resolver-schema.md
  • SQL migrators (PgMigrator, SqliteMigrator, etc.) -> topics/sql-migrations.md
  • Vitest integration -> topics/testing-vitest.md
  • Config (env, typed config) -> topics/config.md

Section Index

  • sections/00-foundations.md — Effect type, creation, composition, run boundaries
  • sections/10-core-patterns.md — Layers, retries, refs, schema-adjacent patterns, concurrency, streams
  • sections/20-cli.md — Command, Options, Args, Prompt, subcommands
  • sections/30-http-server.md — HttpApi, HttpApiEndpoint, HttpApiBuilder
  • sections/40-platform.md — HttpClient, HttpRouter, FileSystem, Path, Url, Terminal, KeyValueStore, Ndjson, workers
  • sections/50-testing.md — it.effect, it.live, it.scoped, TestClock

Topic Index

  • topics/schema.md — Schema models, classes, tagged errors, decode/encode
  • topics/option-either.md — Option/Either control flow and pure error channels
  • topics/refs.md — Ref, SynchronizedRef, FiberRef
  • topics/cause-exit.md — Cause, Exit, failure inspection
  • topics/stm.md — STM transactions, TRef
  • topics/scope-resource.md — Scope, acquireUseRelease, resource safety
  • topics/deferred.md — Deferred, one-shot signaling
  • topics/semaphore.md — Semaphore, bounded concurrency
  • topics/cache.md — Cache, TTL, lookup
  • topics/match.md — Match, exhaustive pattern matching
  • topics/observability.md — Logger, Metric, tracing
  • topics/request-resolver.md — Request batching, dedupe, caching, Effect.request
  • topics/concurrency.md — Concurrency settings, fibers, racing, interruption
  • topics/latch.md — Latch gating and one-way release patterns
  • topics/stream.md — Stream creation, consumption, transformations, combining
  • topics/schedule-retry.md — Retry/repeat with exponential, jittered, custom schedules
  • topics/layer-context.md — Context.Tag, Layer, dependency composition
  • topics/queue.md — Bounded/unbounded queues, offer/take, back-pressure
  • topics/pubsub.md — Broadcast to multiple subscribers, subscribe/publish
  • topics/http-middleware.md — HttpApiMiddleware.Tag, security, provides
  • topics/http-client.md — Outgoing HTTP clients, request/response helpers
  • topics/http-router.md — Route-first apps with HttpRouter/HttpServer
  • topics/http-derive-client.md — Typed client derivation from HttpApi
  • topics/http-swagger.md — Swagger/OpenAPI docs and annotations
  • topics/http-multipart.md — Multipart upload schemas
  • topics/http-streaming.md — Streaming requests and responses
  • topics/platform-ndjson.md — NDJSON pack/unpack and schema channels
  • topics/platform-worker.md — Worker pools and WorkerRunner
  • topics/platform-stream-sink.md — Stream to sink/file integration
  • topics/rpc.md — Typed RPC groups, protocols, client/server layers
  • topics/opentelemetry.md — OpenTelemetry exporters and SDK layers
  • topics/sql-client.md — SqlClient, tagged templates, fragments, transactions, streams
  • topics/sql-drivers.md — SQL driver packages, layers, transforms, driver-specific tags
  • topics/sql-resolver-schema.md — SqlResolver batching and SqlSchema query validation
  • topics/sql-migrations.md — Effect SQL migrator layers and migration files
  • topics/cli-options.md — Full options constructors and combinators
  • topics/cli-args.md — Full args constructors and combinators
  • topics/cli-prompt.md — Interactive prompts and composition
  • topics/testing-vitest.md — it.effect, it.live, it.scoped, TestClock
  • topics/config.md — Config.string/integer, env fallback, nested config

Conventions

  • Section files: What it is | When to use | When not to use | Minimal examples | Common pitfalls | See also
  • Topic files: same structure, compact (~60–120 lines)
  • Paths are relative to this SKILL.md; sections and topics use relative ../ for cross-links

When to Use This Handbook

  • Implementing Effect-based services, CLIs, HTTP APIs, or tests
  • Looking up primitives (Schema, Option, Either, Stream, Schedule, Queue, Layer, Config)
  • Building outgoing HTTP clients or route-first HTTP apps
  • Using request batching / caching or typed RPCs
  • Running SQL queries, transactions, migrations, or database-backed resolvers
  • Resolving common pitfalls (run boundaries, retry layers, auth middleware)
  • Choosing between similar primitives (Queue vs PubSub, Ref vs STM)
  • Debugging Effect execution (run boundaries, fiber interruption, scoped resources)

Package References

  • effect — core runtime
  • @effect/cli — Command, Options, Args, Prompt
  • @effect/platform — HttpApi, HttpClient, HttpRouter, FileSystem, Path, Url
  • @effect/platform-node — NodeContext, NodeHttpServer, NodeRuntime
  • @effect/rpc — typed RPC groups, protocols, middleware
  • @effect/opentelemetry — OTEL SDK and OTLP exporters
  • @effect/vitest — it.effect, it.live, it.scoped
  • @effect/sql — shared SqlClient, statements, schema helpers, resolvers, migrations
  • @effect/sql-pg — PostgreSQL driver
  • @effect/sql-mysql2 — MySQL driver
  • @effect/sql-mssql — Microsoft SQL Server driver
  • @effect/sql-clickhouse — ClickHouse driver
  • @effect/sql-libsql — libSQL driver
  • @effect/sql-d1 — Cloudflare D1 driver
  • @effect/sql-sqlite-node / @effect/sql-sqlite-bun / @effect/sql-sqlite-wasm / @effect/sql-sqlite-react-native / @effect/sql-sqlite-do — SQLite drivers
  • @effect/sql-drizzle / @effect/sql-kysely — SQL ORM/query-builder adapters

Specialized Packages Not Yet Routed In Detail

  • @effect/cluster
  • @effect/workflow
  • @effect/experimental

If one of these appears in a task, consult the reference repo README/examples first; this handbook does not yet have dedicated topic files for them.

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明，方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

Codex

37.33%
按下载量换算79

Claude

29.53%
按下载量换算63

Cursor

18.08%
按下载量换算38

Gemini CLI

8.69%
按下载量换算18

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

执行命令

安装流程涉及命令执行，可能通过 npx skills add https://github.com/tstelzer/skills --skill effect-handbook 联网下载 Skill 或依赖。用户安装前应确认命令来源、仓库内容和执行环境。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源，正式发布前建议补源仓库或其他目录站核验。

来源信息

GitHub 仓库

github.com

/tstelzer/skills

SKILL.md 来源

github.com

/tstelzer/skills/tree/main/skills/effect-handbook

skills-sh

skills.sh

/tstelzer/skills/effect-handbook

继续浏览同类 Skills

更多开发 Skills（21,746）返回 Skills 目录

上一个 Skill

efcore-patterns（efcore 模式）

efcore-patterns 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

effect-schema（效果图式）

effect-schema 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。