typescript-style-guide

一套 TS 规范,人和 AI 都照着写,代码更统一

开源 🏷️完全免费 ⚠️ 链接可跳转,访问体验不确定 编程开发 🍴 复刻 37 👀 关注 11
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 785
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源免费,文档站点公开访问

项目预览

typescript-style-guide 项目界面预览图
图片来源:项目官网

项目数据

分类编程开发
开发团队mkosir
定价模式🏷️完全免费
价格说明开源免费,文档站点公开访问
访问状态⚠️ 链接可跳转,访问体验不确定
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型ai,ai-agent,ai-skill,ai-tools,coding-conventions,coding-guidelines,nodejs,reactjs,skill,style-guide,typescipt
GitHub 星标★ 785
上线时间2022-09-18 00:00:00
代码更新2026-09-03
仓库体积13.3 MB
本站数据更新2026-11-09
维护状态维护中
收录时间2026-09-25
浏览次数2

项目介绍

这是一个面向 TypeScript 项目的编码风格与最佳实践指南,同时以 Agent Skill 的形式提供给 AI 编程助手使用。它解决的是团队协作中代码风格不统一、TypeScript 类型使用随意、可维护性差的问题。核心内容包括一套简洁的约定和推荐做法,覆盖类型定义、命名、模块组织、React/Node 场景下的常见写法等,帮助开发者写出更一致、更易读的代码。项目本身用 TypeScript 编写,并打包成 AI Agent 可调用的技能,让 Claude、Cursor 等工具在生成或审查代码时能遵循同一套规范。相比冗长的官方手册,它更精简、更贴近实际工程,适合作为团队规范或 AI 辅助编码的规则来源。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-25 · 当前星标 ★ 785

使用教程

难度:入门 约 10 分钟 部署方式:命令行安装 4 步

环境要求

  • Node.js 18+
  • 一个支持技能的助手

安装与启动步骤

  1. 1交互式安装

    一个 TypeScript 编码风格技能,给助手立规矩。

    npx skills add mkosir/typescript-style-guide
  2. 2选规则集

    安装时会问你要严格还是宽松。

    按提示选择
  3. 3确认已装

    列一下已有技能。

    npx skills ls -g
  4. 4验证生效

    让助手写一段代码,看是否遵守命名与类型约定。

    帮我写一个类型安全的 fetch 封装

如何确认成功

生成的代码符合技能里定义的命名与类型规范。

注意事项

  • 风格类技能能显著减少「每次都要说一遍」的重复。
  • 团队协作时把技能文件一起提交,保证一致。
  • 与已有 lint 规则冲突时以 lint 为准。

核心亮点

  • 同时面向人类开发者和 AI Agent,可作为 Skill 直接接入编码助手
  • 内容精简聚焦,覆盖类型、命名、模块等高频约定,不堆砌理论
  • 用 TypeScript 编写并开源,便于按团队需求 fork 修改

不足之处

  • 规则条目相对有限,复杂项目或大型团队可能需自行扩展
  • 缺少配套的 ESLint/Prettier 自动校验配置,落地依赖人工或额外工具

适用场景

  • 团队制定 TypeScript 编码规范时作为基础模板
  • 给 Cursor、Claude 等 AI 编程助手配置代码风格技能
  • 个人项目或新仓库快速统一 TS 写法,减少风格争论

替代项目

airbnb/javascript、typescript-eslint、google/styleguide

上一篇:Tianshu-harness

下一篇:deepseek-harness-desktop

同类项目推荐

deepwiki-rs 开源

一键生成代码文档,让团队和 AI 秒懂项目

Turn code into clarity. Generate accurate technical docs and AI-ready context in min···

★ 3166 2026-08-09
claude-source-leaked 开源

扒开Claude Code的底裤,看隐藏功能和省钱技巧

Claude Code v2.1.88 source analysis: system prompts, 87 hidden feature flags, cost o···

★ 135 2026-08-09
expand-your-team-with-copilot 开源

在 GitHub 上把 issue 交给 Copilot 代理直接改代码

Let Copilot coding agent tackle your issues directly on GitHub. No coding environmen···

★ 199 2026-11-01
crystal 开源

多个 AI 同时写不同功能,互不干扰齐头并进。

(Crystal is now Nimbalyst) Run multiple Codex and Claude Code AI sessions in paralle···

★ 3129 2026-08-09
Awesome-Vibe-Coding 开源

一站式收藏AI编程神器,快速上手Vibe Coding。

A curated list of coding harnesses, vibe-coding communities, named personal agents, ···

★ 122 2026-08-09
awesome-codex-plugins 开源

找 Codex 插件,看这份精选清单就够了

A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The···

★ 1540 2026-08-09
codex-security 开源

AI 扫代码找漏洞,验证后直接给修复建议

OpenAI's Codex Security CLI and TypeScript SDK for finding, validating, and fixing s···

★ 11335 2026-10-26
craft-anything 开源

拆解任意软件原理,动手复刻自己的版本

Craft Anything: understand how any software works, and craft your own.

★ 23028 2026-11-03
CopilotChat.nvim 开源

在 Neovim 里直接和 Copilot 聊代码,不切窗口

Chat with GitHub Copilot in Neovim

★ 3648 2026-09-15