关于 arch-tsdown
arch-tsdown 是基于 starter-ts 的 TypeScript 库模板与指导技能,面向使用 tsdown 构建和发布软件包的开发者,提供以 ESM 为中心的构建与测试工具链实践。
主要功能
- 01tsdown 构建配置
- 02自动生成 .d.ts
- 03pnpm 工作区设置
- 04Vitest 与 ESLint 工具配置
- 05CI 与发布指导
适用场景
- 01启动 TypeScript 库项目
- 02配置软件包导出与类型
- 03设置测试和 CI 发布
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hairyf/ skills --skill arch-tsdown安装后在 Claude Code 中输入/arch-tsdown确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
GENERATION.mdassets/ci.ymlrelease.ymlreferences/best-practices-tsdown.mdcore-ci.mdcore-git-hooks.mdcore-overview.mdcore-package-exports.mdcore-pnpm-workspace.mdcore-release.mdcore-scripts.mdcore-testing.mdcore-tooling.mdcore-tsdown-config.md详细介绍
arch-tsdown 是一个 TypeScript 库起步模板(基于 antfu/starter-ts),使用 tsdown 进行构建。它提供了一套极简、有主见的配置:仅输出 ESM、自动生成 .d.ts、pnpm、Vitest、ESLint,以及可选的 npm Trusted Publisher 用于基于 CI 的发布。
该技能基于 starter-ts(arch-tsdown 源码),生成于 2026-01-30。
推荐实践:
- 构建纯 ESM;在 tsdown 配置中启用
dts和exports - 使用 npm Trusted Publisher 进行发布
- 发布前运行 publint(通过 tsdown 的
publint: true)
核心参考
| 主题 | 描述 | 参考 |
|---|---|---|
| 概览 | 项目目的、结构、何时使用 | core-overview |
| tsdown 配置 | entry、dts、exports、publint | core-tsdown-config |
| 脚本与发布 | build、dev、start、release、npm Trusted Publisher | core-scripts |
| 包导出 | dist 输出、types、exports、sideEffects | core-package-exports |
| pnpm 工作区 | catalogs、版本管理、工作区 | core-pnpm-workspace |
| 工具链 | ESLint、TypeScript、Vitest 配置 | core-tooling |
| Git 钩子 | simple-git-hooks、lint-staged、pre-commit | core-git-hooks |
| CI | GitHub Actions — lint、typecheck、测试矩阵 | core-ci |
| 发布 | Tag 推送、sxzz/workflows、npm Trusted Publisher | core-release |
| 测试 | Vitest、vitest-package-exports、导出快照 | core-testing |
最佳实践
| 主题 | 描述 | 参考 |
|---|---|---|
| tsdown 与包 | ESM、dts、exports、工具链一致性 | best-practices-tsdown |
评论
支持 Markdown