效果服务

📌 Skill 基础信息

• Skill 名称：effect-services
• 简称：Effect 服务创建器
• 来源：社区第三方（beep-effect）
• 运行宿主：Claude-Code CLI
• 核心定位：为 Effect v4 框架提供标准化的服务创建模式，通过类型安全的依赖注入和分层组合来构建可维护的应用程序架构。

🧩 内部核心组成

该 Skill 主要提供 Effect v4 服务创建的最佳实践指南和代码模板，包含以下核心组件：

子Agent集合

【无公开信息】

斜杠命令

【无公开信息】

MCP工具

【无公开信息】

模板文件

提供 Effect v4 服务创建的完整代码模板，包括：

• 身份标识创建模板
• 服务类定义模板
• 构造函数实现模板
• 服务消费模式模板
• 层级组合配置模板

Hooks钩子

【无公开信息】

规则约束

• 禁止使用纯字符串作为服务标识
• 必须使用 IdentityComposer 生成类型安全的标识
• 禁止使用 Context.Tag、Effect.Tag、Effect.Service 或 .Default
• 所有服务方法必须使用命名 Effect.fn

目录结构

【无公开信息】

🛠 安装与启用方式

安装命令：

skills install --user beep-effect/beep-effect

前置依赖：

• Effect v4 框架
• @beep/identity/packages 包

API/工具要求：

• TypeScript 开发环境
• Effect v4 运行时

启动入口：

【无公开信息】

📋 标准工作流

1. 身份标识创建：使用 $PackageNameId.create() 创建唯一服务标识
2. 服务类定义：通过 Context.Service<Self, Shape>() 定义服务接口和实现
3. 构造函数实现：使用 Effect.gen 或 Effect.fn 创建服务实例构造器
4. 层级配置：通过 Layer.effect() 和 Layer.provide() 配置依赖关系
5. 服务消费：在业务逻辑中使用 yield* ServiceName 获取服务实例
6. 应用组合：在入口点使用 Layer.mergeAll() 组合所有服务层级

⚠️ 关键限制、缺陷、注意事项

• 平台限制：仅适用于 TypeScript/JavaScript 环境，依赖 Effect v4 框架
• 学习曲线：需要熟悉 Effect 框架和函数式编程概念
• 项目规模：更适合中大型项目，小型项目可能过度设计
• 生产环境：基于 Apache-2.0 开源协议，可用于生产环境但需充分测试
• 性能考虑：层级组合和依赖注入可能带来一定的运行时开销

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景

• 使用 Effect v4 框架的中大型 TypeScript 项目
• 需要严格类型安全和依赖管理的应用程序
• 追求可测试性和可维护性的项目架构
• 需要明确服务边界和依赖关系的复杂系统

❌ 不适合场景

• 小型简单项目或原型开发
• 不使用 Effect 框架的 JavaScript 项目
• 对函数式编程模式不熟悉的开发团队
• 对运行时性能有极端要求的场景

skills install --user beep-effect/beep-effect