用途:本技能整理了一套具体的 TypeScript 惯用法,使架构原则在编译期即可保证正确性。它只负责 TypeScript 层面的“怎么做”,不重复与语言无关的原则,也不涉及可执行的 lint 配置。
主要能力:错误作为值(预期失败放进返回类型而非抛异常)、用 map/flatMap 组合可失败步骤并统一错误通道、用 traverse 折叠 Result 数组、让签名诚实(约束输入或放宽输出)、先解析后校验(parseX 解析、makeX 构造、isX 断言)、以标签联合表示生命周期状态使非法状态不可表示、围绕单一概念构建内聚模块、用 assertNever 保证穷尽性,以及谨慎对待 any、! 与 as 断言。
使用方式:先阅读目标仓库,若已有 Result/错误类型、解析库、模块布局或测试策略,则沿用而不另起一套;仅在全新项目或无既有约定时采用默认做法。冲突时优先级为:正确性与安全 > 既有约定 > 改进局部设计 > 避免大规模迁移 > 记录取舍。
适用场景:新代码路径、领域建模、边界解析、模块设计与 API 签名设计。
限制:不覆盖深层 Effect 模式;仓库已采用 Effect 时优先 Effect。本资料未提供安装命令、价格或平台信息。