用途:这是一个 TypeScript 最佳实践技能,在阅读或编辑任何 .ts 或 .tsx 文件时使用。它先应用 type-system-discipline 原则技能,并把该原则落到 TypeScript 语法层面。
主要能力与规则:用带 kind 字面量判别符的判别联合建模变体,使不可能状态无法表示,不用可选字段袋;用 & { readonly __brand: "X" } 品牌化原始类型以防混用,并在创建时校验一次;外部数据视为 unknown,避免 any 关闭类型检查;不使用 as 强制转换,只有校验之后才可转换;收窄层次为判别式 switch > in 运算符 > typeof/instanceof > 用户定义类型守卫 > as;类型守卫必须真正验证断言,命名用 isX 或 hasX;在 default 分支内联 const _exhaustive: never = x; 以便新增变体时编译器报错;优先用 satisfies 而非 as,以在不拓宽字面量类型的前提下校验值;在数据跨界进入处校验,内部信任类型,并参考 boundary-discipline 原则技能;优先使用 Pick/Omit/Parameters/ReturnType/Awaited/typeof 派生类型,再考虑声明新接口;用对象参数代替位置参数以使顺序自解释,但在热路径(逐帧渲染、分词器、解析器)上跳过。
默认输出:只返回结果、阻塞项和所需证据;省略前言、过程叙述、重复上下文、置信度分数和后续追问;除非所需产物或模式要求更多,否则最多五条要点。
示例与限制:示例见 references/patterns.md。资料未提供安装命令、收费、价格、平台或具体效果信息。