doc schema:编码-harness-doc/v1 doc 类型:产品 权限: 犬类:犬科 分布:仅源 [人-操作者,编码-harness-维护者,编码-代理] 寿命周期 状态:活动 拥有者:编码harness-维护者 创建时间: 2026-06-04 上次审查: 2026-07-31 复议 出席:季度 [产品-表面变化、安装-工作流程变化、释放-合同变化] 影响:小 验证 by: [pnpm docs: lifecycycle] 视乎:[Architche.md,docs/README.md, hand.contract.json]
合成
SynAIpse是一个用于AI辅助存储器工作的小快递管. 有帮助的 一个代理能够理解命名的任务, 采取一个有用的动作, 运行寄存器 证据,并分别报告本地和托管的真相。 这不是代理运行时间 或替代独立审查.
从这里开始
使用匹配当前需要的工作.
| 任务 | 命令 | 结果 |
|---|---|---|
| 东方 | harness next --json | 一个任务第一,只读下一个动作. |
| 诊断 | harness check --json | 快速的局部健康 和可诉失败. |
| 安装 | harness init --minimal --dry-run --json | 一个文件预览, 不写惊喜 . |
| 校验 | harness verify-work --fast | 储物-内存重点证明. |
| 关闭 | harness pr-closeout --pr <number> --json | 分别公关,CI,审查,查找,合并真相. |
这个 CLI 参考 是完整的例行命令 目录。 内部和专家业务被故意不参与 默认行程,并需要指定消费者或任务范围.
安装
在此源检出之外需要时安装已公布的 CLI :
pnpm add -g @brainwav/coding-harness
harness next --json
用于源检出时, 在开发或构建时使用当前树探头 在使用软件包的二进制前:
node --import tsx src/cli.ts next --json
pnpm build
pnpm exec harness next --json
软件包根解决已建 dist/cli.js 消费者的入境点;
导入它为无副作用 。 使用 harness 二进制( 或直接的 CLI)
当您打算执行命令时.
在任何写前预览安装 :
harness init --minimal --dry-run --json
最小安装只创建 harness.contract.json其契约合同
明确不选择CI检查或审查政策;它不推断工作流程,
内存系统,docs站点,钩子,跟踪器,或治理包. 使用
harness contract init --preset standard --force 仅在仓库中
选择更广泛的政策.
校验和关闭
先使用寄存器自己的焦点检查. verify-work --fast 保留
常规执行的本地内存 : 可选模式不会引用它的助手
或守护进程,并且不屏蔽仓库证明。 使用
bash scripts/codex-preflight.sh --stack auto --mode required 仅用于
明确本地记忆诊断或接受道. verify-work --fast
仅报告本地验证。 它没有确定拉动请求的CI,
审查、批准、合并、释放或部署状态.
公关存在后, pr-closeout 报告这些外部通道。 这个
不批准、合并、公布或发布更改.
维护者
读取 一般事务人员(其他职等),则 行政委员会编辑
CLI 参考 是已检查的命令目录;
贡献者验证 拥有更宽的大门.
由 tag 驱动的私有 npm 释放工作流程的靴子绑住寄存器
uv 文物鉴定前的运行时间;地方检查不证明公布.
保持稳定的产品表面小并移动未选的专家能力
常规路径。 将有真相的恢复状态保留在
docs/roadmap/agent-first-status.md
及其每周的粗略输入 harness.contract.json 现在一起.
常规校正保持本地状态或记录 no_system_change 与原因,
检查范围,以及无期限决定;仅促进共同指导
一份相互矛盾的合同,一个跨越安全边界, 重复跨越
独立作品,或需要重用规则的被命名的当前消费者.
索赔边界
本地命令输出和测试只证明他们记录的本地行为. GitHub PR状态, CI, 审查线程, 批准, 合并, 软件包出版, 并释放每个样本,都需要其权威系统的现有证据.