产品定位
typesafe-ai-skill 是 TypeSafe 官方发布的 Agent Skill，采用 MIT 协议，仓库地址为 typesafe-ai/skills。它面向 AI 编程助手，核心定位是教助手如何用 TypeSafe 的 System One 模型构建 AI 功能，把一小块 AI 智能当作编程原语来组合，而不是写一长串提示词再解析返回结果。它强调以代码掌控工作流，让模型只在普通代码需要语义理解的位置补上可编程的常识，从而把 AI 能力更自然地融入软件开发过程。

核心功能
Skill 围绕 System One 模型提供实操指南，内容以任务到文档的索引表组织，覆盖理解编程模型、探索可构建场景、准备输入与问题、处理不确定性、编写 API 代码以及升级旧集成等路径。它会引导使用者从期望的用户行为出发，倒推需要哪些判断，把已知规则、计算、精确查表和实际执行保留在代码里，并反复提示以 TypeSafe 在线文档为准，给出 System One 概念、state 与 primitives、confidence、HTTP API 以及 Python 和 JavaScript SDK 等对应文档地址。

技术特点
TypeSafe 的 System One 模型以 Jev 为代表，它接收自然语言与应用状态，直接返回带类型的判断和概率，不生成文本，也不提供推理过程。工作流由代码负责编排，模型只在需要语义理解时提供结构化决策，因此结果更容易被类型系统约束、被程序消费和测试。typesafe-ai-skill 把这种理念整理成可查阅的开发指引，兼容支持 Agent Skill 的编程助手，安装后可以在开发过程中按需查阅官方文档与示例。

适用场景
当某个功能需要可编程的常识，或者原本的提示词加解析步骤可以改造成结构化决策时，适合使用这个 Skill 引导实现。典型场景包括路由分流、排序、信息抽取、结果校验以及交互式体验等。开发者可以让 AI 助手在具体任务中查阅对应文档，理解如何准备输入与问题、处理不确定性并编写 API 代码，也能在升级旧集成时获得迁移思路。它适合希望用 TypeSafe System One 模型构建可靠 AI 功能的团队和个人。