用途：这是一个面向 fp-ts 的实用函数式编程（FP）工作流技能，去学术化、不涉及范畴论，聚焦真正能改善代码的常见模式。适用于初次接触 fp-ts、编写处理可空值/错误/异步的 TypeScript 代码、希望在不增加学术负担的前提下写出更易维护的函数式代码，以及把命令式代码重构为函数式风格。
主要能力：围绕五个核心模式展开——pipe 按阅读顺序串联操作；Option 处理可空值链，替代 null/undefined 检查；Either 让错误显式化，用返回值代替抛异常；map 在不拆包的情况下转换容器内值；flatMap 串联可能失败的步骤。资料还提到 TaskEither（可失败的异步操作，替代 Promise + try/catch）与 Validation（收集全部错误而非首个即停）。附带快速改进技巧，如用 pipe + fold 替代嵌套三元、用 tryCatch 替代 try-catch、用 Option 替代 undefined 返回、用结构化类型替代错误字符串。
使用方式：先确认用户目标与范围，阅读概览与来源文件（metadata.json、ORIGIN.md），再按需加载真正影响结果的参考、示例或脚本，执行上游工作流并保持来源边界清晰，最后对照上游预期验证结果。示例调用形式为 @fp-ts-pragmatic-v2 处理任务。
适用场景：TypeScript 项目中处理可空值、错误与异步流程；重构命令式代码；代码评审时提供可审计的来源与文件选择说明。
限制：资料强调若函数式编程让代码更难读就不要使用，FP 是工具而非教条；使用任何模式前先问“初级开发者能看懂吗”。具体安装命令、依赖版本、平台与收费信息暂未提供。