mcpField
A
accurate-environment-model

accurate-environment-model

github.com/marius-townhouse开发643 次安装38 周前更新
代码仓库

关于 accurate-environment-model

这项 TypeScript 技能指导开发者用声明文件描述全局变量、环境变量和平台 API，确保依赖运行环境的代码拥有准确类型。

主要功能

  1. 01用 .d.ts 建模全局类型
  2. 02扩展 window 和 globalThis 类型
  3. 03为环境变量添加类型
  4. 04定义构建时常量

适用场景

  1. 01为应用级配置添加类型
  2. 02声明平台专属全局类型

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/marius-townhouse/effective-typescript-skills --skill accurate-environment-model

安装后在 Claude Code 中输入/accurate-environment-model确认已加载。

详细介绍

为你的环境创建准确的模型

概述

你的 TypeScript 环境包含全局变量、环境变量和特定于平台的 API。使用声明文件（.d.ts）为环境创建准确的类型定义。这可以确保特定于平台的代码和全局变量具有类型安全性。

何时使用此技能

  • 定义全局类型
  • 扩展 window 或 globalThis
  • 为环境变量指定类型
  • 使用构建时常量
  • 配置类型定义

铁律

使用 .d.ts 文件准确建模你的环境。声明代码所依赖的全局变量、window 属性和环境变量。

示例

// types/environment.d.ts
declare global {
  interface Window {
    APP_CONFIG: {
      apiUrl: string;
      version: string;
    };
  }
  
  const BUILD_TIMESTAMP: number;
}

// Usage
console.log(window.APP_CONFIG.apiUrl);
console.log(BUILD_TIMESTAMP);

参考资料

  • Dan Vanderkam 著《Effective TypeScript》第二版
  • 条目 76：为你的环境创建准确的模型

评论

支持 Markdown