# @adbayb/stack 中文文档

规范地址：https://npmcn.com/package/%40adbayb/stack/

版本：3\.6\.0
npm 元数据更新时间：2026-11-05T12:25:02.851Z
中文译文更新时间：2026-11-06T00:03:04.988Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adbayb/stack
原文对照：https://npmcn.com/package/%40adbayb/stack/?lang=original
源码仓库：https://github.com/adbayb/stack

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：235 kB，106 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：13 个
- 首次发布：2023-08-14T11:33:06.746Z
- 最新版本发布：2026-11-05T12:25:02.558Z
- 近 30 天下载量：8553（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：383（近 12 个月 214 个）

## 中文简介

我的意见是 JavaScript 工具链

## 安装

```sh
npm install @adbayb/stack
```

也可以使用：`pnpm add @adbayb/stack`、`yarn add @adbayb/stack`、`bun add @adbayb/stack`

## README

# 堆叠

**我的意见脚手架工具 方便项目建设**

  
  

## \* 特性

`Stack` 允许在 **快点**, (中文(简体) ), **简单** 财务报告和审定财务报表 **有意见** 方式为:

-   针对各类项目(单一用途库,多所图书馆,应用程序等)采取统一的单列驱动和git驱动方式
-   支持多个应用程序模板(目前只有默认模板可用,但其他模板可在后期添加).
-   标准化文件结构,包括可选文件夹创建,例如 `examples`, (中文(简体) ), `packages`,, , , , , , , , .
-   启用所有工程生命周期步骤, 其命令从设置、 检查、 固定、 构建、 测试到版本和发布 .
-   内建配置预设(包括节点/NPM运行时,Git忽略/hooks,), [类型脚本](https://github.com/adbayb/stack/blob/main/stack/configs/typescript/), (中文(简体) ), [氧化剂](https://github.com/adbayb/stack/blob/main/stack/configs/oxlint/), (中文(简体) ), [氧化剂](https://github.com/adbayb/stack/blob/main/stack/configs/oxfmt/),编辑器Config, 翻新, 更改ets, 和 VSCode).
-   用户和贡献者的欢迎环境,不断的集成设置和创建 `README.md`, (中文(简体) ), `CONTRIBUTING.md`,并 GitHub 模板文件(包括发行和拉取请求文件),.
-   具有命令缓存的优化开发环境(如果没有变化,则不需要构建).

  

## 使用量

本节介绍 `stack` 通过走过它的主要命令 :

1+++ 通过 `@adbayb/create` 初始化器 :

```bash
# Npm
npm init @adbayb
# Pnpm
pnpm create @adbayb
```

2QQ 使用可用的命令播放( 已经设置在生成的根中 ) `package.json`:

```bash
# Setup initial requirements (including Git hooks installation)
stack install
# Clean the project
stack clean
# Check code health (static analysis including linters and types)
stack check
# Fix auto-fixable issues
stack fix
# Start the project in production mode
stack start
# Build the project in production mode
stack build
# Build and start the project in development mode
stack watch
# Test the code execution
stack test
# Log, version, and publish package(s)
stack release
```

3,请慢用!

  

## 生态系统

### 可用的配置

-   [@adbayb/stack/克克林特](https://github.com/adbayb/stack/blob/main/stack/configs/oxlint/) 统一各项目之间的逻辑和结构规则.
-   [@adbayb/stack/oxfmt (英语)](https://github.com/adbayb/stack/blob/main/stack/configs/oxfmt/) 统一各项目之间的编码格式.
-   [@adbayb/stack/typescript](https://github.com/adbayb/stack/blob/main/stack/configs/typescript/) 使项目之间的类型检查和处理保持一致.

### 代理技能

`@adbayb/stack` 四号舰 [代理技能](https://agentskills.io/specification) 编码代理 :

-   [软件设计](https://github.com/adbayb/stack/blob/main/stack/skills/software-design/):设计和写出干净,可测试的代码;设计规则和词汇表的单一来源.
-   [软件-审计](https://github.com/adbayb/stack/blob/main/stack/skills/software-audit/): 审计代码或对 `software-design` 规则(取决于 `software-design`) (中文(简体) ).
-   [技能设计](https://github.com/adbayb/stack/blob/main/stack/skills/skill-design/): 设计和写作技能, 并带有一个共享解剖学, 外加代理指令, 如 `AGENTS.md`;写作规则的单一来源.
-   [技能审计](https://github.com/adbayb/stack/blob/main/stack/skills/skill-audit/): 审计和评分技能和代理指示,例如: `AGENTS.md` 反对: `skill-design` 规则(取决于 `skill-design` 和安东尼 `skill-creator` 技术评估.

与 [pnpm 12.11.0 或以后时间](https://pnpm.io/agent-skills),将软件包安装为直接依赖,并批准其技能:

```bash
pnpm add -D @adbayb/stack
pnpm approve
```

如果软件包已经安装, 请运行 `pnpm approve`选择 `@adbayb/stack` - 4种技能都得到批准 `pnpm-workspace.yaml`. pnpm 默认将技能链接到现有的代理技能目录中. 要明确选择目录,请配置:

```yaml
skills:
    dirs:
        - .agents/skills
```

链接使用名称如 `pnpm-@adbayb+stack-software-design`全球安装和 `pnpm dlx` 不连接技能.

对于较旧的pnpm版本或全局安装,从寄存器中安装:

```bash
pnpm dlx skills add adbayb/stack --skill software-design -g
pnpm dlx skills add adbayb/stack --skill software-audit -g
pnpm dlx skills add adbayb/stack --skill skill-design -g
pnpm dlx skills add adbayb/stack --skill skill-audit -g
```

使用 `pnpm dlx` 而不是说 `npx`: repo's (英语) `devEngines` 门只接受 pnpm .

在这个仓库里, `stack/skills/` 是已公布的来源,并且 `.agents/skills` 是一个相对的同义链接,所以本地代理使用相同的文件.

### 已使用技术

-   **静态代码分析**: Oxlint, Oxfmt (英语)
-   **节点软件包管理器**时间轴:
-   **任务协调**页:1
-   **释放**: 更改
-   **测试**: 维特

### 已使用的公约

-   [提交](https://www.conventionalcommits.org/)
-   [脚本](https://conventionalscripts.org/)
-   [文件结构](https://nx.dev/concepts/decisions/folder-structure)
    -   单调第一结构为:
        -   在整个模板中保持一致的文件结构模式(租赁模板熟悉度和登入).
        -   简单示例设置 .
        -   而不是将已出版的软件包与与发展相关的背景、元数据和文物混为一谈.

  

## 建筑

### 项目创建工作流程

```mermaid
flowchart TD
    N("npm init @adbayb"):::strokeWidth -- Runs --> C("@adbayb/create"):::strokeWidth
    C -- Runs --> S("@adbayb/stack create"):::strokeWidth
    S -- "Scaffolds (via template and shared configurations)" --> P("New project"):::strokeWidth
    style C fill:#daf2d7,stroke:#90cf8e
    style S fill:#daf2d7,stroke:#90cf8e
    classDef strokeWidth stroke-width:3px
```

  

## 捐款

我们接受新的贡献,你可以找到更多细节 [这里](https://github.com/adbayb/stack/blob/main/CONTRIBUTING.md)。 。 。 .

  

## 许可证

[麻省理工学院](https://github.com/adbayb/stack/blob/main/LICENSE "License MIT")

## 常见问题

### @adbayb/stack 是什么？

我的意见是 JavaScript 工具链

### 如何安装 @adbayb/stack？

在项目目录运行 npm install @adbayb/stack，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 stack，可以用 npx stack 直接运行。

### @adbayb/stack 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @adbayb/stack 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @adbayb/stack 可以商用吗？

@adbayb/stack 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adbayb/stack 的下载量有多少？

根据 npm 官方下载统计，@adbayb/stack 在 2026/10/05 – 2026/11/03 这 30 天内被下载 8,553 次，日均约 285 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adbayb/stack 还在维护吗？

最新版本 3\.6\.0 发布于 2026/11/05（今天）；至今共发布 383 个版本，其中过去 12 个月发布了 214 个；首次发布于 2023/08/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。