# @bluenyang/reins 中文文档

规范地址：https://npmcn.com/package/%40bluenyang/reins/

版本：0\.2\.0
npm 元数据更新时间：2026-10-28T16:24:30.868Z
中文译文更新时间：2026-11-08T08:51:28.905Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bluenyang/reins
原文对照：https://npmcn.com/package/%40bluenyang/reins/?lang=original
项目主页：https://github.com/bluenyang/reins#readme
源码仓库：https://github.com/bluenyang/reins

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

- 包体积（解压后）：378 kB，95 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2026-10-25T16:53:41.870Z
- 最新版本发布：2026-10-28T16:24:30.463Z
- 近 30 天下载量：3107（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

安装、迁移并更新一种使编码代理在其允许作用范围内的代理设备(harness → ro循环 → 图表).

## 安装

```sh
npm install @bluenyang/reins
```

也可以使用：`pnpm add @bluenyang/reins`、`yarn add @bluenyang/reins`、`bun add @bluenyang/reins`

## README

# 绳子

[한국어](https://npmcn.com/package/%40bluenyang/reins/docs/README.ko.md)

调节安装、迁移和更新寄存器的代理工具:编码代理的作用, a 循环政策、计划检查的交接文件、知识库和大门。 剧本, `reins check`, (中文(简体) ), 在固定点决定循环是否可以继续,所以一个代理留在它的作用之内 给与并按规定行事。 人们决定大门.

它的存在是因为蓝恩阳和克罗夫尔队的十二个仓库 共用一个绳系和 (b) 各机构不参与请求,只举行一次会议,执行和处理问题 法官们,知识在被忽略的空间中消失, 没有停止的规则, 复制 漂移,a 只有克洛德才有的循环 完整列表(P1-P6)为 [文件/提案.md](https://npmcn.com/package/%40bluenyang/reins/docs/proposal.md)。 。 。 .

## 状态

0.1.5版本为npm: `npx @bluenyang/reins <command>`这是计划之一——图 级,仅对生成的供应商文件Claude Code进行核实; 循环和控制级为 刻出在它的0.2。 0.1.3 用 PR → CI → rc 释放流将循环分为舞台技能, 0.1.4 准备大型储存库(释放设置、单重门、迁移修正)和0.1.5 说明哪些规则得到实施,哪些只得到建议,将模式拆分为一组 和每个用户层,并在Ubuntu、Windows和macOS上运行带有22和24号节点的CI。 0.0 (弧) 后加 `reins config`, (中文(简体) ), 用于模型和角色的终端屏幕,作为屏幕询问安装和更新问题。 什麽 每个版本的更改都在 [变动情况](https://npmcn.com/package/%40bluenyang/reins/CHANGELOG.md)接下来是路线图.

管制通过自己的循环:意图001(`reins status`页:1`reins metrics`和 003(违规情况) 每一个都有意图 · · · · 计划 · 门票,支票为T1至T5 通过和Codex做代码审查。 约束其他供应商的作用贯穿其国家贷款机构 (单位:千美元)`codex exec`, (中文(简体) ), `agy -p`)):主要代理称它们跟随: `reins-loop` 技术。 CLI确实如此 尚未自行发送给供应商.

## 梯子

有三层. 每一层都包含下面的一层,分层共享一个来源.

| 级别 | 它有什么东西 |
| --- | --- |
| 绳子 | 在承诺和推力( T2, T4, T6) 时验证器的红线, 生成权限 |
| 循环 | (b) 相同的过渡点和停止条件 |
| 图表 | 所有十二个角色,计划检查的交接文件以及每个角色模型绑定 |

`reins install <tier>` 拿走其中任何一个 第一轮目标是图级;计划 以0.2为单位刻出环路并拉出分层,将所测成本作为输入.

## 如何运作

**角色们.** 有十二:pm, 规划者, pl, 执行者, 检索, 校验工具, 代码审查, qa设计、qa运行、部署、文件和顾问。 每个角色文件都列出了角色不能做的事. 作用 分离不是模型分离:每个角色都可以在一个模型上运行 `bindings.yaml` 指定 a 每一个角色的供应商和模式。 从设计上看,被捆绑在卖主身上的角色,如果没有被发现,就归结为其 倒下,否则就是pm模型,所以所有12个角色都可以单独运行在克洛德身上.

**红线.** 十条规则(C1-C10)适用于每个角色,因为 示例:没有执行“通过”(C1),没有编辑管理的块、政策或角色(C2),没有 编辑自己的许可文件(C3),不读取机密(C4),不绕行钩(C5),不读取密码 push, PR, 合并或释放到部署角色( C6) 之外. 名单在 [文件/设计](https://npmcn.com/package/%40bluenyang/reins/docs/design.md) 第2节. 如何 每一条规则都包含在 [强制执行与建议](https://npmcn.com/package/%40bluenyang/reins/#readme-enforced-versus-advised) 下面:有些被封锁,有些被检查 过渡,有些只是用角色或技能书写.

**验者.** `reins check` 运行在过渡点并打印一个判断。 它没有叫 模型;角色将其判断写入交割文件,由核查人应用.

| 判决 | 退出代码 | 含义 |
| --- | --- | --- |
| 继续 | 0 个 | 继续 |
| 持有 | 10个 | 用户必须回答 |
| 停下来 | 20国 | 无人可修;停站记录地点、原因(从A1到G2)以及如何恢复 |
| 分类 | 30个 | 故障链: pl pm 顾问 用户 |

24站条件 A1-G2 包括不可逆的行动 公开的决定 倒塌的房舍, 重复失败、费用、违反规则和用户中断.

**连锁和两个人类的决定.** 工作通过四个文件进行: `intent.md` → `spec.md` → `plan.md` - 门票。 一个人在两点决定: 用户批准 意图,用户可以否决3至5行的光谱摘要. 其他的都一样 按角色审查。 核查输出被粘贴为所出;裸出"通过"不是通过.

**布局图.**

| 路径 | 承诺 | 持有 |
| --- | --- | --- |
| `AGENTS.md` | 对 | 工具编写的管理区块, 您编写的工程区块 |
| `.agents/` | 对 | `intent/`, (中文(简体) ), `knowledge/`, (中文(简体) ), `harness/` (作用、政策、计划、模板、, `bindings.yaml`, (中文(简体) ), `gates.yaml`, (中文(简体) ), `skills/` |
| `.claude/` | 对 | 从 `.agents/`; 不编辑 |
| `.loctx/` | 无( 已忽略) | 门票、报告、交割 `bus/`, (中文(简体) ), `history/`,本地路线图 |

## 强制执行与建议

并不是每个规则都得到执行。 每个都以三种方式之一举行 `harness/policy/enforcement.yaml` 说到哪,每个规则一行.

-   **封锁**:一个脚本,钩子或权限拒绝在动作发生前停止.
-   **检查**:过渡检查,漂移检查或CI之后接取.
-   **建议**:它只用一个角色或技能来写;代码中没有任何接取.

等级是最强的 真正持有,和 `gap` 栏中显示的是左起角。 Hooks只在安装时才适用,否认规则和代理工具限制只存在于克洛德代码. 规则IDs在 [文件/设计](https://npmcn.com/package/%40bluenyang/reins/docs/design.md) 第2和3节,证据载于 [文件/违规情况](https://npmcn.com/package/%40bluenyang/reins/docs/violations.md)。建议的规则是输入 [0.2 (韩语)](https://npmcn.com/package/%40bluenyang/reins/docs/ROADMAP.md)。 。 。 .

| 编号 | 举行 | 以 | 差额 |
| --- | --- | --- | --- |
| C1 级 | 建议 | `role` | 仅由审查人员判断; 没有发现硬码的通过 |
| C2级 | 封锁 | `hook:pre-commit`, (中文(简体) ), `check:drift` | 仅在安装了钩子时; 编辑本身没有被阻止 |
| C3 数据 | 封锁 | `hook:pre-commit`, (中文(简体) ), `check:drift` | 只有安装了钩子;没有否定规则涵盖.claude/ settings.json本身 |
| C4级 | 封锁 | `deny`, (中文(简体) ), `hook:pre-commit` | Claude Code只; env. \* 是有限列表, 所以像.env. Custom这样的名字没有否定规则; 钩子看见了有阶梯的路径, 不读 |
| 第5类 | 封锁 | `deny`, (中文(简体) ), `gate`, (中文(简体) ), `check:verdict` | 组合或后位形式,如 git 承诺 - nm 不否认 |
| C6 导弹 | 建议 | `role` | 预推会向默认分支( A4) 推出并拒绝规则停止强制和 -- 不验证推出; 任何其他推出、 PR、 合并、 释放或标记没有被屏蔽 |
| C7级 | 建议 | `role` | —— 说 |
| C8级 | 建议 | `role` | —— 说 |
| C9型导弹 | 建议 | `role` | —— 说 |
| C10级 | 建议 | `role` | T2 列出它, 但承诺前检查没有将 diff 与 plan. md 进行比较 |
| A1 对 | 封锁 | `deny`, (中文(简体) ), `hook:pre-push` | 将已公布的标签移动到后人身上,通过祖先的测试 |
| 第2条 | 建议 | `role` | —— 说 |
| 第3条 | 建议 | `role` | —— 说 |
| 页:1 | 封锁 | `hook:pre-push` | 只持有向默认分支的推力; 未检测出离开机器的其他方式 |
| B1级 | 检查 | `check:ticket-start` | —— 说 |
| 页:1 | 建议 | `role` | —— 说 |
| B3级 | 建议 | `role`, (中文(简体) ), `check:ticket-start` | 范围冲突是一个角色的判断; 开票只检查批准链 |
| B4级 | 建议 | `role` | —— 说 |
| B5级 | 建议 | `role` | —— 说 |
| 临1 | 建议 | `role` | —— 说 |
| 临2 | 检查 | `check:ticket-start`, (中文(简体) ), `check:rc-close` | 计划单; diff不与计划单作比较 |
| D1级 | 检查 | `check:verdict` | 未在 rc 1 之前从 rc 之后的 rc 中分辨出 |
| D2级 | 建议 | `role` | 没有内存横行 |
| D3级 | 建议 | `role` | 没有单独运行的比对 |
| D4级 | 封锁 | `gate`, (中文(简体) ), `check:verdict` | 空门输出只是 WARN |
| D5级 | 检查 | `check:verdict` | —— 说 |
| 页:1 | 建议 | `role` | 没有读取预算或符号数 |
| E2级 | 建议 | `role` | 没有读取预算或符号数 |
| E3 数据 | 建议 | `role` | T5 列出它,但没有读取预算或符号数 |
| F1 导弹 | 建议 | `role` | 否认规则阻止了克劳德代码的一些尝试,但没有记录到停止 |
| F2 请检查DATE=中的日期值 (帮助) F2 | 封锁 | `hook:pre-commit`, (中文(简体) ), `check:drift`, (中文(简体) ), `check:ticket-start`, (中文(简体) ), `check:rc-close` | —— 说 |
| F3 联合国 | 建议 | `role` | —— 说 |
| 集团1 | 建议 | `role` | 没有信号处理器, 中断时也没有恢复记录 |
| G2型 | 建议 | `role` | —— 说 |
| T1 电话 | 检查 | `check:ticket-start` | 未执行左侧预算 |
| T2 电话 | 封锁 | `hook:pre-commit` | 仅在安装了钩子时; P2 和 C10 diff 检查不存在 |
| T3 电话 | 检查 | `check:verdict` | —— 说 |
| T4 电话 | 封锁 | `hook:pre-push` | 执行 A1 和默认分支推 (A4); A2, A3, C6 和循环步骤检查不存在 |
| T5型导弹 | 检查 | `check:rc-close` | E3没有执行 |
| T6 电话 | 建议 | `role` | 没有代码运行在中断或违规信号上 |

| 角色 | 封锁 | 检查 | 建议 | 被屏蔽的项目 |
| --- | --- | --- | --- | --- |
| 顾问 | 0 个 | 0 个 | 2个 | —— 说 |
| 代码审查 | 1个 | 0 个 | 2个 | 编辑代码 |
| 部署 | 1个 | 0 个 | 2个 | 强制推出,删除或移动标记,重写主 |
| 文档 | 0 个 | 0 个 | 3个 | —— 说 |
| 执行者 | 0 个 | 0 个 | 页:1 | —— 说 |
| 查询 | 3个 | 0 个 | 0 个 | 写入任何文件; 生成报告或上下文文件; 运行闸门或测试 |
| 规划员 | 0 个 | 0 个 | 3个 | —— 说 |
| 页:1 | 0 个 | 0 个 | 3个 | —— 说 |
| 下午 | 0 个 | 1个 | 2个 | —— 说 |
| qa 设计 | 0 个 | 0 个 | 3个 | —— 说 |
| qa 运行 | 0 个 | 0 个 | 2个 | —— 说 |
| 校验工具 | 0 个 | 2个 | 1个 | —— 说 |
| 预算范围 | 0 个 | 0 个 | 6个 | —— 说 |
|  |  |  |  |  |

这些表格由下列人员提供: `pnpm docs:enforcement` 并测试它们与YAML相等.

## 快开始

在克洛德代码中,安装插件并让它设置寄存器:

```
/plugin marketplace add bluenyang/reins
/plugin install reins@bluenyang
/reins:reins-setup
```

对于Codex,Antigravity,Cursor或平地终端,使用CLI. 它需要22号节点或以后。 从要设置的仓库根中运行它; 仓库 需要至少一项承诺`check` 失败于0. 1.0 中的空历史 :

```sh
npx @bluenyang/reins install graph --dry-run   # show what would be written
npx @bluenyang/reins install graph --mode auto # place files, detect CLIs, take defaults
npx @bluenyang/reins check --drift             # prints "drift: ok" when sources and output match
npx @bluenyang/reins status                    # intents, tickets, bus, last history entry
```

`install` 拒绝第三代或第四代 并指向 `migrate`提出钩子 在安装注释中仅添加 `--hooks`。 。 。 .

安装后, 工作会通过代理: 在克洛德代码运行 `/reins-setup` 曾经,那么 `/reins-intent` 对于每个新请求; Codex, Antigravity and Cursor 读取相同的技能 `.agents/skills/`技能称CLI本身.

努力控制自己: `git clone https://github.com/bluenyang/reins.git`,则 `pnpm install`, (中文(简体) ), `pnpm build`运行 `node cli/dist/reins.js <command>` (见 [捐款额](https://npmcn.com/package/%40bluenyang/reins/CONTRIBUTING.md)) (中文(简体) ).

## 图标

| 命令 | 状态 | 对 |
| --- | --- | --- |
| `install <harness|loop|graph>` | 已执行 | 把绳子放在终端上 `--mode manual` 要求销售商、语言、大门和分目录大门作为屏幕; `--mode manual|auto`, (中文(简体) ), `--hooks`, (中文(简体) ), `--dry-run`, (中文(简体) ), `--json` |
| `migrate <tier>` | 已执行 | 移动已有的吊带或 `.ai/` 工作空间到此布局 |
| `update` | 已执行 | 在不触碰项目部分的情况下重新应用被包装的取接;在终端上显示计划并先问(`--yes` 跳过问题) |
| `config` | 已执行 | 在终端上设置屏幕( i)`models and roles configuration`, (中文(简体) ), `exit`没有终端,它会打印解开的绑定表以及如何修改; `--json` |
| `configure bindings` | 已执行 | `--set role=model ...` 或者说 `--vendors claude,openai`· ; `--disable <role...>` 编号 : `--enable <role...>` 关闭或打开( e)`--local` 仅针对您; pm、 执行者和校验工具无法关闭 ; 没有请求选项 |
| `gate [names...]` | 已执行 | 运行 `gates.yaml` 并保持原始输出 `.loctx/reports/` |
| `status` | 已执行 | 仅可读取 : 牵引、意图、票、公交车和历史 |
| `check` | 已执行 | `--stage ticket-start|pre-commit|verdict|pre-push|rc-close`,或 `--drift` |
| `metrics` | 已执行 | 报告摘要 `.loctx/reports/metrics.jsonl`:按角色、销售商、票和意向、每张票的知情停止计价; `metrics record` 添加角色运行的符号 |
| `recall` | 未执行 | 按症状搜索过去的决定 |
| `doctor` | 未执行 | —— 说 |
| `configure gates` | 已执行 | 列出子目录门建议; `--add <name>...` 把它们附在大门上 雅姆尔 |
| `configure budget|language` | 未执行 | —— 说 |

`install`, (中文(简体) ), `migrate`, (中文(简体) ), `update`, (中文(简体) ), `gate`, (中文(简体) ), `status`, (中文(简体) ), `check` 财务报告和审定财务报表 `metrics` 带 `--json`每一个 `check` 财务报告和审定财务报表 `gate` 运行中还附加一条行到 `.loctx/reports/metrics.jsonl`。 。 。 . `check` 阶段映射到 T1级(`ticket-start`页:1`pre-commit`),T3(`verdict`页:1`pre-push`)和T5类(`rc-close`) (中文(简体) ).

## 技能

10个技能跟随 `SKILL.md` 标准 : `reins-setup` 鞋带, `reins-loop` 进行,八个阶段技能各取一个阶段,可以单独调用.

| 技能 | 使用时间 |
| --- | --- |
| `reins-setup` | 安装指针,或将已有的吊带移动到它上 |
| `reins-roadmap` | 更新公共路线图并选择目标版本 |
| `reins-intent` | 新的请求抵达:问卷和经核准的意图 |
| `reins-spec` | 意向获得批准:接受的规格、计划和票证 |
| `reins-implement` | 罚单已准备好:按承诺单位执行 |
| `reins-review` | 罚单完成:核实、审查和关闭 |
| `reins-test` | 一个版本的所有门票都完成了:情景和构建 |
| `reins-release` | 测试一个版本:PR、CI、合并和rc |
| `reins-retro` | 发布版本:回顾和知识建议 |
| `reins-loop` | a 特性被接受:按顺序调用舞台技能 |

## 路线图

整个计划在 [文档/ROADMAP.md](https://npmcn.com/package/%40bluenyang/reins/docs/ROADMAP.md) (单位:千美元)[한국어](https://npmcn.com/package/%40bluenyang/reins/docs/ROADMAP.ko.md)) (中文(简体) ).

## 文档

-   [文件/提案.md](https://npmcn.com/package/%40bluenyang/reins/docs/proposal.md)问题、目标、要求、成功标准
-   [文件/设计](https://npmcn.com/package/%40bluenyang/reins/docs/design.md):布局,角色,停止条件,文件格式,CLI
-   韩文版: [提案](https://npmcn.com/package/%40bluenyang/reins/docs/proposal.ko.md), (中文(简体) ), [设计](https://npmcn.com/package/%40bluenyang/reins/docs/design.ko.md). 如果英文版和韩文版有分歧,则韩文文件获胜.

## 许可证

麻省理工学院

## 常见问题

### @bluenyang/reins 是什么？

安装、迁移并更新一种使编码代理在其允许作用范围内的代理设备\(harness → ro循环 → 图表\)\.

### 如何安装 @bluenyang/reins？

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

### @bluenyang/reins 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bluenyang\_\_reins 是否存在。

### @bluenyang/reins 支持 ESM 还是 CommonJS？

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

### @bluenyang/reins 需要什么版本的 Node\.js？

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

### @bluenyang/reins 可以商用吗？

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

### @bluenyang/reins 的下载量有多少？

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

### @bluenyang/reins 还在维护吗？

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