AgentSkillsCN

cats-effect-resource

使用Cats Effect的`Resource`与`IO`，实现Scala资源生命周期管理。适用于定义安全的资源获取与释放、组合资源（包括并行获取），或为文件、流、池、客户端以及后台纤维设计资源安全的API与取消行为。

SKILL.md
--- frontmatter
name: cats-effect-resource
description: Scala resource lifecycle management with Cats Effect `Resource` and `IO`. Use when defining safe acquisition/release, composing resources (including parallel acquisition), or designing resource-safe APIs and cancellation behavior for files, streams, pools, clients, and background fibers.

Cats Effect Resource (Scala)

Quick start

  • •Model each resource with Resource.make or Resource.fromAutoCloseable and keep release idempotent.
  • •Compose resources with flatMap, mapN, parMapN, or helper constructors; expose Resource[F, A] from APIs.
  • •Use Resource at lifecycle boundaries and call .use only at the program edges.
  • •Read references/resource.md for patterns, best practices, and API notes.

Workflow

  1. •Identify acquisition, use, and release steps; decide if acquisition is blocking.
  2. •Implement a Resource[F, A] constructor using the smallest needed typeclass.
  3. •Compose resources into higher-level resources and keep finalizers minimal.
  4. •Decide how cancelation and errors should influence release logic.
  5. •Run with .use at the boundary (IOApp, service startup) and avoid leaking raw A.

Usage guidance

  • •Prefer Resource over try/finally or bracket when composition and cancelation safety matter.
  • •Use IO.blocking (or Sync[F].blocking) for acquisition and release when calling blocking JVM APIs.
  • •For background fibers, use Resource or Supervisor to ensure cleanup on cancelation.

References

  • •Load references/resource.md for API details, patterns, and examples.
  • •For Kotlin/Arrow parallels, see the arrow-resource skill.
  • •Install this skill with npx skills add https://github.com/alexandru/skills --skill cats-effect-resource.