hermes-spec

Hermes-Spec 内核发行包与安装器（OpenSpec effectiveMin，Node 20.19.0+）。

AI Agent：安装/更新/卸载目标仓请读 HERMES-SPEC-AI-INSTALL.md（分场景 TODO + 环境探测，适配各尺寸模型）。

版本发布材料：HERMES-SPEC-RELEASE-DATA.md（量化数据）· HERMES-SPEC-RELEASE-PPT-PROMPT.md（AI 做 PPT 提示词）· release-v061-slides/（Marp 幻灯片预览）

安装 CLI

npm install -g [email protected]
# 或本地包：npm install -g ./hermes-spec-0.2.0.tgz

目标仓接入（0.2.x 推荐）

# 一条龙：全局 OpenSpec 检测/补装 → openspec init → Hermes 全量安装
hermes-spec init --yes --target <target-dir>
hermes-spec doctor --target <target-dir>

分步（与 M1 兼容）：

hermes-spec setup --yes          # 全局补装 OpenSpec CLI（不写目标仓）
openspec init --tools cursor <target-dir>
hermes-spec install --target <target-dir>

0.2.x 行为变化：install 默认 --ensure-openspec=true，缺 OpenSpec CLI 或 openspec/config.yaml 时只输出 guidance 并以 exit 1 退出，不再静默进入 installFull。已有 OpenSpec 的异构仓可正常 install；测试或高级场景可用 --skip-openspec-init。

官方重叠的 6 个 openspec-*-change skill 不由本包下发，由 openspec init 提供；本包仅含 hermes-* / openspec-hermes-* 等 Hermes 专有资产。

问题索引

| 现象 | 建议命令 | |------|----------| | openspec 命令不存在 | hermes-spec setup --yes | | OpenSpec 版本低于 effectiveMin | hermes-spec setup --yes | | 目标仓无 openspec/config.yaml | hermes-spec init --yes --target <dir> | | 只想装 Hermes 资产、跳过 OpenSpec 检测 | hermes-spec install --skip-openspec-init --target <dir> | | 持久记忆未配置（doctor warning） | 在 .hermes-spec/rag.yaml 填写 providerType（Skill 或 MCP）与 providerName | | Node 版本不足 | 升级到 Node ≥ 20.19.0 |

本仓自举（dogfood）

.\scripts\bootstrap-dogfood.ps1

或手动：

npm pack
npm install -g .\hermes-spec-0.2.0.tgz
hermes-spec init --yes --target .
hermes-spec doctor --target .

0.2.x Release Notes

• 新增 hermes-spec setup / hermes-spec init 子命令
• install 默认 --ensure-openspec：缺前置只 guidance（exit 1），不 spawn openspec init
• doctor 输出结构化 guidance[]
• 报告契约 C-2：action 增 setup/init；openspecInitRan；guidance[]
• OpenSpec 版本判定统一为 effectiveMin 单门槛（消除 OPENSPEC_PIN 双轨）

发布

npm run test:all  # 防泄漏门禁 + 全量测试（提交前必跑）
npm pack          # 本地验包
npm publish       # 需配置可写 registry（非只读 mirror）

内网 registry 在 .npmrc 或 publishConfig.registry 中配置。

开发

npm run test:all  # 防泄漏门禁 + 全量测试
npm run test:leak # 仅敏感词防泄漏门禁
npm run hermes:install -- --skip-openspec-init --target /path/to/repo