快速开始
这条路径会先预览，再安装到一个宿主，最后核对结果。Harnessmith 是 npm initializer，不要求预先全局安装；需要 Node.js 24.12.0 或更高版本。
开始前
先确认目标 Coding Agent 已经安装，并知道自己要使用全局个人范围还是 Cursor 项目范围。Harnessmith 不需要你的模型 API key，也不会替你登录第三方宿主。
第一步：只看计划
以 Codex 为例：
npx harnessmith --dry-run --agent codexdry-run 不写文件。请检查输出中的宿主、授权根、规则入口和 Harness 目录是否符合预期；机器处理时可加 --json。
第二步：执行安装
直接指定宿主：
npx harnessmith install --agent codex也可以运行交互式选择：
npx harnessmith如果目标存在但不是 Harnessmith 管理，安装会默认拒绝。不要用 --force 掩盖未知冲突；先确认文件来源和差异，确实要 接管时再显式选择，并保留生成的备份。
第三步：验证安装
安装后确认 Harnessmith 仍拥有目标文件且内容完整：
npx harnessmith status --agent codex需要让 Agent 自检内嵌 Runtime 时，可让它运行安装目录中的 harness.mjs doctor；准确路径以 Adapter 的 dry-run/status 结果为准，不要从文档硬猜。
选择其他宿主
codex、claude-code、opencode 与 kimi-code 使用全局安装范围；cursor 使用项目范围：
npx harnessmith install --agent cursor --project /path/to/project同一命令可以逗号分隔多个宿主：
npx harnessmith install --agent codex,opencode,kimi-code准确目标路径、别名和支持状态见宿主支持。
第一次实际使用
新开的宿主会话会读取对应规则入口。你不需要在每个请求里粘贴整套规则，可以从一个普通任务开始：
只读分析当前仓库的发布流程，说明事实来源和未验证范围，不要修改文件。
这类请求会先命中入口中的信任与发现规则，再按需路由到具体 playbook。Harnessmith 提供上下文和工作契约；宿主是否 执行命令、是否要求权限批准，仍由宿主自身决定。
让 Agent 帮你安装
你也可以把以下请求交给 Coding Agent，并在写入前亲自检查目标：
阅读 https://raw.githubusercontent.com/Alessandro-Pang/harnessmith/main/llms.txt，按其中协议安装 Harnessmith；先执行 dry-run，再让我确认写入。