Token导航 LogoToken导航TokenDH.com
研究检索只读github未标认证来源可访问许可证需确认审计通过

types-as-sets类型作为集合

Agent Skill

types-as-sets 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

192

周安装

8

GitHub Stars

2

下载量

64
CodexClaudeCursorGemini CLI

安装说明

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

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

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

请帮我安装这个 Agent Skill:types-as-sets(类型作为集合)
来源仓库:https://github.com/marius-townhouse/effective-typescript-skills
仓库路径:skills/types-as-sets
安装命令:
npx skills add https://github.com/marius-townhouse/effective-typescript-skills --skill types-as-sets
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

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

skills.shnpx skills
npx skills add https://github.com/marius-townhouse/effective-typescript-skills --skill types-as-sets

简介

用于查找、检索和筛选相关信息,支持基于关键词快速定位候选结果。

  • 适用于 Codex、Claude、Cursor、Gemini CLI 中的研究检索类任务场景。
  • 通过 GitHub 安装,使用 npx skills add 命令从 marius-townhouse/effective-typescript-skills 仓库添加技能。
  • 安装前应检查权限范围和维护状态,确认是否涉及联网或文件读写操作。
  • types-as-sets 属于研究检索类 Skill,可作为该场景下的辅助能力补充。

SKILL.md

Think of Types as Sets of Values

Overview

A type is a set of possible values. Assignability means subset.

Understanding types as sets helps you reason about unions, intersections, extends, and never. This mental model makes TypeScript's behavior intuitive.

When to Use This Skill

  • Confused why A & B has MORE properties than A or B
  • Don't understand why extends means "subset"
  • Reasoning about union and intersection types
  • Working with never or unknown types
  • Debugging "not assignable to" errors

The Iron Rule

ALWAYS think "subset" when you see "extends" or "assignable to".

Remember:

  • Union (|) = larger set (union of domains)
  • Intersection (&) = smaller set (intersection of domains)
  • extends = "is a subset of"
  • never = empty set (no values)
  • unknown = universal set (all values)

Detection: The "Assignability" Confusion

If you're confused by assignability errors, think in terms of sets:

type AB = 'A' | 'B';
type AB12 = 'A' | 'B' | 12;

const ab: AB = 'A';        // OK: 'A' is in {'A', 'B'}
const ab12: AB12 = ab;     // OK: {'A', 'B'} ⊆ {'A', 'B', 12}

declare let twelve: AB12;
const back: AB = twelve;   // Error!
// {'A', 'B', 12} is NOT a subset of {'A', 'B'}

The Set Theory Mental Model

TypeScript to Set Theory Translation

TypeScriptSet TheoryMeaning
never∅ (empty set)No values
Literal type "A"Single element {A}One value
`T1 \T2`T1 ∪ T2 (union)Values in either
T1 & T2T1 ∩ T2 (intersection)Values in both
unknownUniversal setAll values
extends⊆ (subset)"Is contained in"
"assignable to"⊆ (subset)"Is contained in"

Why Intersection & ADDS Properties

This seems counterintuitive at first:

interface Person { name: string; }
interface Lifespan { birth: Date; death?: Date; }

type PersonSpan = Person & Lifespan;

// PersonSpan has MORE properties, not fewer!
const ps: PersonSpan = {
  name: 'Alan Turing',
  birth: new Date('1912/06/23'),
  death: new Date('1954/06/07'),
};  // OK

Why? Because we're intersecting SETS OF VALUES, not properties.

  • Person = all objects with a name property
  • Lifespan = all objects with birth (and optional death)
  • Person & Lifespan = objects that have BOTH sets of properties

The set of values is SMALLER, but each value has MORE properties.

Why Union | Has FEWER Guaranteed Properties

type K = keyof (Person | Lifespan);
//   ^? type K = never

// No keys are guaranteed on BOTH Person AND Lifespan

The set of values is LARGER, but we can rely on FEWER properties.

The extends Keyword

In TypeScript, extends means "subset of":

interface Vector1D { x: number; }
interface Vector2D extends Vector1D { y: number; }
interface Vector3D extends Vector2D { z: number; }

// Vector3D ⊆ Vector2D ⊆ Vector1D (as sets of values)
// A Vector3D IS-A Vector2D IS-A Vector1D

This also applies to generic constraints:

function getKey<K extends string>(val: any, key: K) { /* ... */ }

// K can be any subset of string:
getKey({}, 'x');                           // OK: 'x' ⊆ string
getKey({}, Math.random() < 0.5 ? 'a' : 'b'); // OK: 'a'|'b' ⊆ string
getKey({}, 12);                            // Error: number ⊄ string

The never Type (Empty Set)

never is the empty set - it contains no values:

const x: never = 12;
//    ~ Type 'number' is not assignable to type 'never'.

// never is useful for exhaustiveness checking
function assertNever(x: never): never {
  throw new Error('Unexpected value: ' + x);
}

The unknown Type (Universal Set)

unknown is the universal set - all values are assignable to it:

const x: unknown = 'hello';  // OK
const y: unknown = 42;       // OK
const z: unknown = null;     // OK

// But you can't use unknown without narrowing
const str: string = x;  // Error: must narrow first

Arrays vs Tuples

const list = [1, 2];
//    ^? const list: number[]

const tuple: [number, number] = list;
// Error! number[] is not assignable to [number, number]
// Because: there exist number[] that aren't pairs ([], [1], [1,2,3])

The set number[] is NOT a subset of [number, number].

Practical Applications

Understanding Generic Constraints

// T must be a subset of objects with an 'id' property
function getById<T extends { id: string }>(items: T[], id: string): T | undefined {
  return items.find(item => item.id === id);
}

Understanding Conditional Types

// "If A is a subset of B, then X, else Y"
type IsString<T> = T extends string ? true : false;

type A = IsString<'hello'>;  // true ('hello' ⊆ string)
type B = IsString<number>;   // false (number ⊄ string)

Pressure Resistance Protocol

1. "Intersection Should Have Fewer Properties"

Pressure: "A & B should have properties common to both"

Response: We're intersecting sets of VALUES, not properties.

Action: Think: "What objects satisfy BOTH interfaces?"

2. "extends Means Inheritance"

Pressure: "extends is about class inheritance"

Response: In types, extends means "subset of".

Action: Replace "extends" with "is a subset of" when reading.

Red Flags - STOP and Reconsider

  • Thinking & removes properties
  • Thinking | adds properties
  • Confusing extends with classical inheritance
  • Forgetting that object types are "open" (allow extra properties)

Common Rationalizations (All Invalid)

ExcuseReality
"Intersection means common parts"It's about VALUES, not properties
"extends means inherits"In types, it means "is subset of"
"Union has all properties"Union only guarantees common properties

Quick Reference

Type ExpressionSet InterpretationSize
neverEmpty set0 values
"A"Singleton1 value
`"A" \"B"`Union2 values
stringAll strings∞ values
unknownUniversal setAll values
A & BIntersectionUsually smaller
`A \B`UnionUsually larger

The Bottom Line

Types are sets of values. Assignability is subset checking.

Understanding this makes TypeScript's behavior intuitive. extends means "subset of", & intersects value sets (resulting in more required properties), and | unions value sets (resulting in fewer guaranteed properties).

Reference

Based on "Effective TypeScript" by Dan Vanderkam, Item 7: Think of Types as Sets of Values.

适合场景

01

用户想查找某类 Agent Skill 时

02

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

03

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

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

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

能力 4

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

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

平台分布

Codex

37%
按下载量换算24

Claude

28.8%
按下载量换算18

Cursor

17.69%
按下载量换算11

Gemini CLI

9.16%
按下载量换算6

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

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

来源信息

继续浏览同类 Skills