# @data-matters\.io/agent-harness 中文文档

规范地址：https://npmcn.com/package/%40data-matters.io/agent-harness/

版本：0\.1\.3
npm 元数据更新时间：2026-10-31T20:44:44.691Z
中文译文更新时间：2026-10-31T22:15:46.779Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：183 kB，49 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-10-17T04:34:02.280Z
- 最新版本发布：2026-10-31T20:44:44.530Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

使用Claude代码进行规范驱动开发：将门、任务循环和标准安装到产品存储库中

## 安装

```sh
npm install @data-matters.io/agent-harness
```

也可以使用：`pnpm add @data-matters.io/agent-harness`、`yarn add @data-matters.io/agent-harness`、`bun add @data-matters.io/agent-harness`

## README

# @data-matters.io / agent-harness

Spec-Driven Development with Claude Code，安装到产品存储库中： 完成定义为可执行门，一个任务循环，实现一个 已批准的OpenSpec每个会话更改一个任务，并且标准代理 遵循。

## 安装

准确地固定包，并让项目的安装生成线束。 PNPM拒绝低于其最低发布年龄的版本 发布的第一天，把它列出来 `pnpm-workspace.yaml` 第一。

```yaml
minimumReleaseAgeExclude:
  - '@data-matters.io/agent-harness@<version>'
```

```sh
pnpm add -D -E @data-matters.io/agent-harness
pnpm exec harness init --new --stack nextjs   # or nestjs, vite; --existing for a codebase without tests
```

```json
{ "scripts": { "prepare": "harness install" } }
```

`harness init` 也写 `.github/dependabot.yml`每周的颠簸 只能在2天冷却后使用挽具，所以每次撞击都超过了pnpm的最小值 释放的年龄。 `harness install` 写入生成的文件(`.harness/*.sh`， `.harness/standards/`， `.harness/CLAUDE.harness.md`，克劳德代码停止钩子) 它们一直被忽略，所以它们总是匹配固定的版本。

## 命令

| 命令 | 它是做什么的 |
| --- | --- |
| `harness init` | 第一次采用：项目拥有的和种子文件； `CLAUDE.md`, `.gitignore` 条目 |
| `harness install` | （Re）生成git忽略的文件；幂等 |
| `harness check` | 当生成的文件过期或已编辑，或缺少所需文件时失败 |
| `harness update-files` | 种子文件的三向合并(`.claude/settings.json`， `openspec/config.yaml`)偶然地 |
| `harness pr-scope` | 在不安装项目的情况下，对CI的拉取请求（仅限规范或不规范）进行分类 |

运行 `harness --help` 选项。

## 常见问题

### @data-matters\.io/agent-harness 是什么？

使用Claude代码进行规范驱动开发：将门、任务循环和标准安装到产品存储库中

### 如何安装 @data-matters\.io/agent-harness？

在项目目录运行 npm install @data-matters\.io/agent-harness，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 harness，可以用 npx harness 直接运行。

### @data-matters\.io/agent-harness 支持 TypeScript 吗？

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

### @data-matters\.io/agent-harness 需要什么版本的 Node\.js？

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

### @data-matters\.io/agent-harness 可以商用吗？

@data-matters\.io/agent-harness 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @data-matters\.io/agent-harness 还在维护吗？

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