# @7n/rules 中文文档

规范地址：https://npmcn.com/package/%407n/rules/

版本：1\.118\.11
npm 元数据更新时间：2026-08-30T10:35:44.526Z
中文译文更新时间：2026-11-06T17:24:51.352Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%407n/rules
原文对照：https://npmcn.com/package/%407n/rules/?lang=original
项目主页：https://github.com/nitra/7n-rules#readme
源码仓库：https://github.com/nitra/7n-rules

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

- 包体积（解压后）：7.7 MB，808 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=25
- 运行依赖：15 个
- 首次发布：2026-07-13T13:59:52.219Z
- 最新版本发布：2026-08-30T10:35:44.231Z
- 近 30 天下载量：2598（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：291（近 12 个月 291 个）

## 中文简介

CLI еталонних skills 技能(префікс n-): синк репозиторій репозиторій-lint, конформність-конформність-

## 安装

```sh
npm install @7n/rules
```

也可以使用：`pnpm add @7n/rules`、`yarn add @7n/rules`、`bun add @7n/rules`

## README

# @ 7n/ 规则

光标 `n-` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢.

## {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢

Репозиторій `@7n/rules` 光标 `rules/<id>/`. CLI . . `<id>.mdc` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 **каталогу `rules/` того,з也 `bin/n-rules.js`**时间轴: `npm i` 编号 : `bun add` це `node_modules/@7n/rules/rules/<id>/<id>.mdc`页:1 **`npx @7n/rules`** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 **кеш npx/npm**, \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ (原始内容存档于2018-10-21). HTTP - CDN.

Наприклад,правило `rules/text/text.mdc` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `.cursor/rules/n-text.mdc`。 。 。 .

## Підготовка

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `.n-rules.json` у:

```json
{
  "$schema": "https://unpkg.com/@7n/rules/schemas/n-rules.json",
  "rules": ["npm-module", "text"],
  "skills": ["fix", "lint"]
}
```

校对:Soup

| Назва | Опис |
| --- | --- |
| `npm-module` | \=================================================================================================== (===================================================================== |
| `text` | Текст克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 |
| `k8s` | Kubernetes YAML, Kustomize, kubeconform (英语) |

Щоб,оновіть也 `@7n/rules` у(у)`bun add -d @7n/rules@<версія>` (原始内容存档于2016-10-12). QQ. Поле `version` у `.n-rules.json`说到做到, **ігнорується**。 。 。 .

### . . . . `ignore`

Поле `ignore` у `.n-rules.json` - список(posix-шляхи \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* `check-*.mjs` 唵(引一)валідує(引一)них(二合引一)贺. `node_modules`, (中文(简体) ), `.git`, (中文(简体) ), `dist`, (中文(简体) ), `coverage`, (中文(简体) ), `.turbo`, (中文(简体) ), `.next`· · · · · · `ignore` не.

QQ: 销售商 赫尔姆 -斯,斯,斯,斯:

```json
{
  "$schema": "https://unpkg.com/@7n/rules/schemas/n-rules.json",
  "rules": ["k8s"],
  "ignore": ["dremio/dev/dremio_v2", "postgres-master"]
}
```

### Правило `k8s` -克斯托米兹

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 **`**/k8s`** дотримуйтесь **`rules/k8s/k8s.mdc`** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `.cursor/rules/n-k8s.mdc`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢`node_modules/@7n/rules/rules/k8s/k8s.mdc`) (中文(简体) ).

Коротко:

-   **Kustomize : (原始内容存档于2013-09-29)** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 **`base`**页:1 **基础** відповідає,як也 **备忘**; окремої **`dev/`** . . . . **`base`**. інших. середовищах **覆盖** (часто **`kustomization.yaml`** (原始内容存档于2018-09-29) (中文(简体) ).
-   **命名空间** задається в **`kustomization.yaml`** (单位:千美元)`namespace:`(原始内容存档于2018-09-26) (中文(简体) ) **`metadata.namespace`** у; окремі补 **命名空间** не.
-   У **部署** 说吧 **`resources`** 页:1 **`npx @7n/rules fix k8s`**(三);
-   Рядки в **基础**,############################################################################################################################################################################################################################################################## `# буде замінено через kustomize`。 。 。 .
-   {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 **`base`** / 覆盖 **видаляйте** {\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}你觉得呢.

. . . . . **`k8s.mdc`**; 方案 . . . **`npm/rules/k8s/`**: 联合材料检查 `js/<concern>/check.mjs`,重新制定政策 `policy/<concern>/<name>.rego` (обидва `npx @7n/rules fix k8s`) (中文(简体) ).

### v8rі

Скрипт `scripts/run-v8r.mjs` # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # **`schemas/v8r-catalog.json`** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `npm/schemas/v8r-catalog.json` (原始内容存档于2018-09-28). QQ. Якщо `bunx v8r` напряму,передай `-c`时间轴: `node_modules/@7n/rules/schemas/v8r-catalog.json` або [(单位:公斤)](https://unpkg.com/@7n/rules/schemas/v8r-catalog.json)杰森・斯克马: [n-rules.json (英语)](https://unpkg.com/@7n/rules/schemas/n-rules.json)。 。 。 .

## Запуск

```bash
npx @7n/rules
npx @7n/rules fix
npx @7n/rules fix bun ga

# Керування git-worktree (.worktrees/ + інвентарний файл-опис)
npx @7n/rules worktree add <branch> "<опис>"
npx @7n/rules worktree list
npx @7n/rules worktree remove <branch> [--force]
npx @7n/rules worktree prune
```

Команда `check` 方案 `scripts/` пакету. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你为什么这么觉得 `.n-rules.json`, перед:"зчитування:"也 `$schema`、 якщо відсутнє не не URL URL.

CLI автоматично (команда завантаження правил) `check`:

1.  {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `.n-rules.json` у поточній (із) `$schema` jSON Schema ; файл; уже; уже `$schema`, поле додано або оновлено конфігу конфігу конфігу
2.  Створить `.cursor/rules/`, 翻译 :
3.  {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `rules/<id>/<id>.mdc` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `n-`
4.  {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 **`AGENTS.md`**: повний: `AGENTS.template.md`时 **{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `*.mdc`** у `.cursor/rules/` (відсортовано;секція **`package.json`** кореня (див. `{{#commands}}` (原始内容存档于2018-03-13). q.

## Приклад

```
🔧 @7n/rules — завантаження cursor-правил

📋 Правил до завантаження: 2
  ⬇  npm-module → .cursor/rules/n-npm-module.mdc ... ✅
  ⬇  text → .cursor/rules/n-text.mdc ... ✅
📝 Оновлено AGENTS.md з AGENTS.template.md

✨ Готово: 2 завантажено, 0 з помилками
```

## Структура

```
npm/
├── AGENTS.template.md    # шаблон AGENTS.md для цільових репозиторіїв (потрапляє в npm-архів)
├── rules/                # cursor-правила (підкаталог на правило, див. «Структура одного правила»)
│   ├── npm-module/
│   ├── text/
│   └── ...
├── skills/               # скіли (каталоги <id>/; після синку — .cursor/skills/n-<id>/)
├── scripts/              # CLI-утиліти, спільні runner-и, discovery
└── bin/
    └── n-rules.js       # CLI-скрипт (точка входу)
```

### {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢

Кожне `npm/rules/<id>/` ділиться **технологією** на,три `js/`, (中文(简体) ), `lint/`, (中文(简体) ), `policy/`数字 :

```
npm/rules/<id>/
├── <id>.mdc              # текст правила (після синку — .cursor/rules/n-<id>.mdc)
├── meta.json             # метадані скілу: auto (автоактивація) + worktree
├── js/                  # JS для `npx @7n/rules fix`
│   └── <concern>/
│       ├── check.mjs     # діагностика — повертає список violations
│       ├── check.test.mjs
│       └── autofix.mjs   # опційно — програмний автофікс
├── lint/                 # JS, що живить `bun run lint-<id>` (для правил з канонічним lint-скриптом)
│   ├── lint.mjs          # CLI entry для `n-rules lint-<id>`
│   └── run-*.mjs         # допоміжні runner-и (shellcheck, v8r тощо)
└── policy/               # rego для `npx @7n/rules fix`
    └── <concern>/
        ├── <concern>.rego       # правила (`deny contains msg if …`)
        ├── <concern>_test.rego  # юніт-тести (запускає `bun run lint-rego` → conftest verify)
        └── target.json          # які файли подавати в conftest (single / walkGlob)
```

**Принцип:** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢.

| Що | Канал | Куди |
| --- | --- | --- |
| JS-+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ | `npx @7n/rules fix` (修-канал | `js/<concern>/` |
| JS - 指挥员 | `bun run lint-<id>` через `n-rules lint-<id>` | `lint/` |
| 来 | `npx @7n/rules fix` (修-канал | `policy/<concern>/` |

`js/` 页:1 `policy/` \\ \\ \\ \\ \\ \\ \\`npx @7n/rules fix` ++ 联合核查,+ 重新制定政策,++ **{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢**: 联合来文 `js/`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}然后说 `policy/`。 。 。 . `lint/` 联合来文: `bun run lint-<id>`。 。 。 .

## 女演员们,md

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 **повністю** файл **`AGENTS.md`** ? ? ? ? (? ? ? ?, ? ? ? ? ? ? `.n-rules.json`) (中文(简体) ).

-   **Джерело** . . . . . **`AGENTS.template.md`** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `@7n/rules` ( його; вносять.
-   **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢** - Скрипт зчитує **`.cursor/rules/`** і **{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得怎么样 `.mdc`** {\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}你觉得怎样 `- .cursor/rules/<ім’я>.mdc`。 。 。 `n-`, і - які `.mdc`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢.
-   Редагувати **`AGENTS.md` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢** . . . . . . . . . {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 **`AGENTS.template.md`** у `@7n/rules` {\\fn华文仿宋\\fs16\\1chd1d1d1}好.

## {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢

### {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你还得去吗

1.  Редагуйте **`npm/AGENTS.template.md`**{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 **`files`** у `npm/package.json`, \\ \\ \\ npm (\\ \\ \\ \\ \\ \\ \\ \\ \\ npm `rules/`, (中文(简体) ), `skills/`, (中文(简体) ), `bin/`) (中文(简体) ).
2.  {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? 须须з **`services`** і **`{{name}}`**数字 :

```markdown
{{#services}}
{{name}}
{{/services}}
```

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `{{#services}}` 页:1 `{{/services}}` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `*.mdc` у `.cursor/rules/`; 编辑 `{{name}}` 减分 `- .cursor/rules/n-text.mdc`) (中文(简体) ).

3.  Для **技能** використовуйте **`{{#skills}}` . `{{/skills}}`** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `{{name}}`: рядки : `.cursor/skills/` (див `buildSkillBulletItems` у `bin/n-rules.js`) (中文(简体) ).
    
4.  Для **图标** використовуйте **`{{#commands}}` . `{{/commands}}`**{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 **`package.json`** 页:1 `scripts` . . . . . `lint-*`{\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}你觉得呢 **`npx @7n/rules`** 页:1 **`npx @7n/rules fix`**。 。 。 **`npm/scripts/build-agents-commands.mjs`**。 。 。 .
    
5.  {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `.n-rules.json` виконайте `npx`编号 :`bunx` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `node npm/bin/n-rules.js` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 **`AGENTS.md`** виглядає.
    

### Логіка в CLI

-   Шлях:поруч也 `rules/`时 `…/node_modules/@7n/rules/AGENTS.template.md` після.
-   Оновлення **`AGENTS.md`** виконується **після** циклу,щоб也 `.cursor/rules/` на.
-   Якщо `.cursor/rules/` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `*.mdc`时 `{{#services}}` стає; решта; все; записується **`AGENTS.md`**。 。 。 .
-   Секція **`commands`** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 **`package.json` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢**; якщо; файлу `scripts` відсутній,у也`bun i`,\[CLI\].

## Мета

GIT 光标.

## 常见问题

### @7n/rules 是什么？

CLI еталонних skills 技能\(префікс n-\): синк репозиторій репозиторій-lint, конформність-конформність-

### 如何安装 @7n/rules？

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

### @7n/rules 支持 TypeScript 吗？

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

### @7n/rules 支持 ESM 还是 CommonJS？

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

### @7n/rules 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=25。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @7n/rules 可以商用吗？

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

### @7n/rules 的下载量有多少？

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

### @7n/rules 还在维护吗？

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