SuperAPI AI 工具集

Skill 广场

找到适合任务的 Agent Skill,阅读介绍并复制安装命令。

更新于 11-14 00:15

编程与开发

41,032 个结果

effect core

Effect Core 是 Effect-TS 中基础类型 Effect 的使用技能,用于在编写 TypeScript 时创建、组合和运行 Effect。Effect 表示一个可能以值 A 成功、以错误 E 失败或需要上下文 R 的计算:Effect<Success, Error, Requirements>。核心要点是:Effect 只是对程序的描述,而非已执行的代码,必须显式运行。本技能涵盖从同步值(succeed、fail、sync、try)、异步值(promise、tryPromise)创建 Effect,使用 pipe、map、flatMap、andThen、gen 生成器语法进行顺序组合,以及 runPromise、runPromiseExit、runSync、runSyncExit 等运行方式,另包含 tap、all 等组合操作符、双 API 风格和与 Promise 的对照。资料还要求写任何 Effect 代码前必须阅读并遵循 Code Style 技能。

编程与开发10 次安装

error management

这是一个面向 Effect(TypeScript 库)的错误管理技能,用于指导处理 Effect 中的两类失败:可在编译期类型中追踪的可恢复期望错误(Expected Errors),以及不进入类型签名的运行时缺陷(Defects)。技能覆盖用 Schema.TaggedError 创建类型化错误、用 Effect.fail 触发失败、用 catchAll/catchTag/catchTags/orElse/orElseSucceed 捕获与恢复、用 mapError/mapBoth 转换错误、用 Effect.all(mode: "either")/Effect.partition/Effect.validate 累积错误、用 Effect.die/orDie/sandbox 处理缺陷、用 Cause 与 Match 检查完整失败信息、用 Schedule 重试、用 timeout/timeoutFail 设置超时,以及用 match/matchEffect 进行错误匹配,并给出最佳实践与参考资料位置。

编程与开发10 次安装

observability

本技能用于在 Effect(TypeScript 库)中实现可观测性能力,涵盖结构化日志、指标与分布式追踪三大方面。当用户询问 Effect 日志(Effect logging、Effect.log)、Effect 指标(Effect metrics)、Effect 追踪(Effect tracing、spans、telemetry)、Metric.counter 等相关内容时使用。该技能提供日志分级与结构化注解、日志跨度计时、自定义 Logger,计数器/仪表/直方图/摘要/频率等指标类型与标签化指标,以及创建 span、嵌套 span、添加属性、设置 span 状态、自定义 Tracer 与 OpenTelemetry 集成等用法,并给出组合使用与最佳实践建议。

编程与开发10 次安装

pattern matching

这是 Effect TypeScript 生态中的模式匹配技能,指导开发者用 Effect 的 Match 模块替代命令式控制流,例如 else if 链、嵌套 if、三元运算符、switch/case 以及错误标志判断等。技能覆盖 Match.value 与 Match.type 的基础用法、Match.when 与 Match.whenOr、Match.whenAnd 的条件匹配、Match.tag 对可辨识联合类型的匹配、Match.exhaustive 穷尽检查、Match.orElse 与 Match.orElseAbsurd 的非穷尽处理、Match.not 反向匹配,以及 Schema.is() 作为类型守卫与 Match 结合使用的方式。它还给出从 if/else 与 switch 重构为 Match 的对照示例,处理 Effect 错误、状态机、Option.match 与 Option.flatMap 的取舍,并列出若干强制与推荐的编码规范。适合在 Effect 项目中统一控制流写法的开发者参考。

编程与开发10 次安装

karpathy-guidelines

karpathy-guidelines 是一套面向 LLM 编码行为的行为准则,源自 Andrej Karpathy 对 LLM 编码常见失误的观察,用于减少 LLM 写代码时容易犯的错误。它适用于编写、审查或重构代码的场景,目标是避免过度复杂化、进行外科手术式的精准修改。准则明确说明其权衡:偏向谨慎而非速度,对于琐碎任务需自行判断。内容包含四个部分:一、编码前先思考,明确陈述假设、不确定就提问、存在多种理解时全部列出、有更简单方案要指出、遇到不清楚的地方停下来询问;二、简单优先,只写解决问题所需的最少代码,不做用户未要求的功能、抽象、灵活性或错误处理,200 行能压到 50 行就重写;三、外科手术式修改,只改动必须改动的地方,不顺手“改进”相邻代码、注释或格式,不重构没坏的东西,匹配现有风格,发现无关死代码只提及不删除,仅清理自己改动造成的孤儿引用,判断标准是每一行改动都能直接追溯到用户请求;四、目标驱动执行,把任务转成可验证目标,例如“加校验”变成“先为非法输入写测试再让其通过”,多步任务给出简短计划并列明每步的验证方式。

编程与开发10 次安装