关于 arch-tsdown-cli
使用 tsdown 创建 TypeScript 命令行包的起步技能，适合需要同时提供库和可执行程序的开发者。它说明 ESM 构建、类型声明生成、测试、检查与发布实践。
主要功能
- 01库与可执行程序双重结构
- 02ESM 构建与类型声明生成
- 03基于 tsx 的开发命令
- 04pnpm、Vitest 与 ESLint 配置
- 05CI 与发布参考
适用场景
- 01启动 TypeScript 命令行包项目
- 02配置开发和生产二进制入口
- 03准备包导出与发布工作流
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/arch-tsdown-cli确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
GENERATION.mdassets/ci.ymlrelease.ymlreferences/best-practices-cli.mdcore-bin-entry.mdcore-ci.mdcore-git-hooks.mdcore-overview.mdcore-package-exports.mdcore-scripts.mdcore-testing.mdcore-tooling.mdcore-tsdown-config.md详细介绍
arch-tsdown-cli 是一个 TypeScript CLI 包起步模板（基于 hairyf/starter-cli），使用 tsdown 进行构建。它提供了一套极简且有明确取向的配置：双入口（library + bin）、仅 ESM 输出、自动生成 .d.ts、通过 tsx 运行 dev bin、pnpm、Vitest、ESLint，以及可选的 npm Trusted Publisher 用于基于 CI 的发布。
该技能基于 starter-cli（arch-tsdown-cli 源码），生成于 2026-01-30。
推荐实践：
- 本地使用 dev bin（tsx），在 publishConfig 中使用 prod bin（dist）
- 构建纯 ESM；启用
dts并为依赖保留external - 使用 npm Trusted Publisher 进行发布
核心参考
| 主题 | 描述 | 参考 |
|---|---|---|
| 概览 | 项目用途、结构、何时使用 | core-overview |
| Bin 入口 | dev 与 prod bin、shebang、tsx | core-bin-entry |
| tsdown 配置 | entry、format、dts、external | core-tsdown-config |
| 脚本与发布 | build、dev、start、release、npm Trusted Publisher | core-scripts |
| 包导出 | dist、bin、publishConfig、files | core-package-exports |
| 工具链 | ESLint、TypeScript、Vitest 配置 | core-tooling |
| Git 钩子 | simple-git-hooks、lint-staged、pre-commit | core-git-hooks |
| CI | GitHub Actions — lint、typecheck、测试矩阵 | core-ci |
| 测试 | Vitest、vitest-package-exports | core-testing |
最佳实践
| 主题 | 描述 | 参考 |
|---|---|---|
| CLI 与包 | bin、ESM、dts、external、发布 | best-practices-cli |
评论
支持 Markdown