svharness 0.14.18 → 0.15.1

package/README.md

@@ -35,6 +35,9 @@ svharness wizard
 # 配置文件驱动（团队模板 / CI）
 svharness build --config svharness.config.yaml --yes
 
+# 全自动模式 —— 资料整理 → 构建 → 审查 → 优化，支持断点续跑
+svharness auto --work-dir . --auto-approve -y
+
 # 一行式 —— 跳过交互，直接生成
 svharness build --harness-name my-app --arch android-compose --agent qoder --yes
 
@@ -60,6 +63,8 @@ svharness start-agent --work-dir .
 
 **`svharness wizard`**：分步 TUI，支持同时填写**文件路径**与**说明文字**（如 `requirementsNote`），结束时可选「立即执行 / 仅保存配置 / 保存并执行」。
 
+**`svharness auto`**：无人值守构建入口。工作目录可以是已有 `<name>-harness/`（从 `.harness-build-state.yaml` 断点续跑），也可以是资料包根（自动检测 `baseline/`、`requirements/`、`references/`、`extra-skills/` 后先执行 build）。配置示例见 `auto/templates/auto.config.example.yaml`。
+
 生成完成后，在你的 Agent IDE 中说：
 - "运行 harness-build-skills-main"或"harness-build-skill-orchestrator"即可开始逐步填充内容；
 - 构建完成后在目标项目中说"应用 harness-apply-skills-main 完成 xxx 功能开发"即可调用 harness。
@@ -235,6 +240,7 @@ svharness wizard
 | 字段 | 说明 |
 |------|------|
 | `requirementsNote` | 需求文档业务说明 |
+| `goal` | harness 构建目的（写入 harness 目录） |
 | `referencesNote` | 参考资料说明 |
 | `extraSkillsNote` | 额外 skills/rules 说明 |
 
@@ -270,7 +276,8 @@ svharness build \
 | `--save-config [path]` | 可选 | build 成功后把参数写入配置文件 | — |
 | `--harness-name <name>` | ✅ 必填* | harness 名称；可在 `build.harnessName` 中提供 | — |
 | `--name <name>` | ⚠️ 已废弃别名 | 等同 `--harness-name`，下个 minor 版本移除 | — |
-| `--arch <arch>` | 可选 | 架构模板：`android-compose` / `android-xml` / `cpp` / `web-react` / `python` | `android-compose` |
+| `--arch <arch>` | 可选 | 架构模板：`android-compose` / `android-xml` / `cpp` / `web-react` / `python` / `documents` | `android-compose` |
+| `--goal <text>` | 可选 | harness 构建目的（1–2 句话，写入 `harness.yaml` 与 state；最多 500 字符） | — |
 | `--agent <agent>` | 可选 | 目标 Agent IDE：`codechat` / `qoder` / `cursor` / `claude-code` / `opencode` / `codex` / `generic` | `codechat` |
 | `--baseline <path\|url>` | 可选 | 基线来源：本地目录 **或** git 仓库 URL | — |
 | `--requirements <path>` | 可选 | 需求输入路径（文件或目录）；build 阶段**扁平**拷贝到 `requirements/raw/`（不保留源目录里的 `assets/raw/converted_md` 等嵌套），随后自动 convert 到 `requirements/md/`（失败仅告警，不中断 build） | — |
@@ -850,6 +857,13 @@ npm uninstall -g svharness
 | `cpp` | C++17 + CMake | 5 条 `seed-*.md` | 现代 C++ + CMake 规范 |
 | `web-react` | TypeScript + React | 5 条 `seed-*.md` | Hooks + 状态管理规范 |
 | `python` | Python | — | 通用 Python 模板 |
+| `documents` | — | — | 文档型 harness（无代码基线；spec 域为 behavior + interfaces） |
+
+```bash
+# 文档型 harness + 构建目的
+svharness build --harness-name doc-demo --arch documents --agent codechat \
+  --goal "车载 CAN 信号协议文档标准化 harness" --yes --force
+```
 
 > **两层叠拷合并**：`_shared/` 先落盘，`<arch>/` 随后覆盖同名文件。
 > 新增架构只需在 `templates/<new-arch>/skeleton/agent-env/rules/` 下放 3-5 条规则文件，
@@ -1140,7 +1154,7 @@ svharness build --harness-name demo-unknown --arch python --agent codechat `
 - [x] 参数 `--name` → `--harness-name`（保留 `--name` 别名一版本）
 - [x] `--arch` 默认 `android-compose`、`--agent` 默认 `codechat`
 - [x] `build` —— 骨架 + 元文件 + 状态文件 + skill 注入
-- [x] 多架构模板（`android-compose` / `android-xml` / `cpp` / `web-react` / `python`）
+- [x] 多架构模板（`android-compose` / `android-xml` / `cpp` / `web-react` / `python` / `documents`）
 - [x] `_shared/` + `<arch>/` 两层叠拷合并
 - [x] 每个架构自带 3-5 条规则文件（`.mdc` 格式，`alwaysApply: true` 默认启用）
 - [x] `apply` —— 把已构建好的 harness 绑定到目标项目（默认复制模式，`--clone` 兼容保留）