svharness 0.15.11 → 0.15.13

package/README.md

@@ -38,6 +38,10 @@ svharness build --config svharness.config.yaml --yes
 # 全自动模式 —— 资料整理 → 构建 → 审查 → 优化，支持断点续跑
 svharness auto --work-dir . --auto-approve -y
 
+# 需求包专项 —— 在 requirements 资料目录直接运行（推荐）
+cd ./requirements && svharness auto_pack_req --yes
+# 或指定资料包根：svharness auto_pack_req ./req-pack --yes
+
 # 一行式 —— 跳过交互，直接生成
 svharness build --harness-name my-app --arch android-compose --agent qoder --yes
 
@@ -65,6 +69,8 @@ svharness start-agent --work-dir .
 
 **`svharness auto`**：无人值守构建入口。工作目录可以是已有 `<name>-harness/`（从 `.harness-build-state.yaml` 断点续跑），也可以是资料包根（自动检测 `baseline/`、`requirements/`、`references/`、`extra-skills/` 后先执行 build）。配置示例见 `auto/templates/auto.config.example.yaml`。
 
+**`svharness auto_pack_req`**：需求包专项入口（独立于 `auto`）。**无参数时默认把当前目录当作工作目录**；若当前目录本身是 requirements 资料夹（含 doc/md/pdf 等，目录名任意），则自动视为输入并在**上级目录**创建 harness。也支持传入资料包根（含 `requirements/` 子目录）或已有 harness 根。仅执行 S30 + S40，三维度质量闭环直到综合分 **严格大于** 9.5。配置示例见 `auto/templates/auto-pack-req.config.example.yaml`（`auto_pack_req:` 节）。详细设计见 [`auto/auto-harness-detail-design.md` §2.2.1](./auto/auto-harness-detail-design.md#221-svharness-auto_pack_req-需求包专项)。
+
 生成完成后，在你的 Agent IDE 中说：
 - "运行 harness-build-skills-main"或"harness-build-skill-orchestrator"即可开始逐步填充内容；
 - 构建完成后在目标项目中说"应用 harness-apply-skills-main 完成 xxx 功能开发"即可调用 harness。
@@ -234,6 +240,8 @@ svharness wizard
 | `convert` | 对应 `svharness convert` |
 | `doctor` | 对应 `svharness doctor` |
 | `wiki` | 对应 `svharness wiki` |
+| `auto` | 对应 `svharness auto` |
+| `auto_pack_req` | 对应 `svharness auto_pack_req`（需求包 S40 专项） |
 
 `build` 节除路径外，可写人类可读说明（仅写入配置文件，供团队阅读）：
 
@@ -289,7 +297,7 @@ svharness build \
 | `--convert-endpoint <url>` | 可选 | build 自动 convert 使用的 markitdown 服务基址（支持逗号分隔 failover）；省略时读 `SVHARNESS_MARKITDOWN_ENDPOINT` | `http://markitdown.desaysz.site` |
 | `--convert-concurrency <n>` | 可选 | build 自动 convert 并发上传数 | `3` |
 | `--convert-max-file-mb <n>` | 可选 | build 自动 convert 单文件大小上限（MB） | `50` |
-| `--convert-timeout-sec <n>` | 可选 | build 自动 convert 请求超时秒数 | `120` |
+| `--convert-timeout-sec <n>` | 可选 | build 自动 convert 请求超时秒数 | `900`（15 分钟） |
 | `--convert-force` | 可选 flag | build 自动 convert 覆盖同名 `.md`（否则按 `-1/-2` 追加） | `false` |
 | `--force` | 可选 flag | 覆写已存在的 harness 目录；同时允许覆盖已注入的 build skills/rules 与项目根 `AGENTS.md` / `CLAUDE.md`（默认遇到已存在文件会跳过） | `false` |
 | `-y, --yes` | 可选 flag | 跳过所有提示，采用默认值 | `false` |
@@ -540,7 +548,7 @@ svharness convert --verbose --yes
 | `--endpoint <url>` | 云端 `markitdown_serve` 基址；**逗号分隔**可配置 failover；省略时读 `SVHARNESS_MARKITDOWN_ENDPOINT` | `http://markitdown.desaysz.site` |
 | `--concurrency <n>` | 并发上传数 | `3` |
 | `--max-file-mb <n>` | 单文件大小上限（MB），本地 + 服务端双重限流 | `50` |
-| `--timeout-sec <n>` | 单请求超时秒数 | `120`（2 分钟） |
+| `--timeout-sec <n>` | 单请求超时秒数 | `900`（15 分钟） |
 | `--type <type>` | 目标子目录：`requirements`（正式需求）\| `references`（参考资料） | `requirements` |
 | `--force` | flag，覆盖已存在同名 `.md`（默认自动追加 `-1`、`-2` 后缀） | `false` |
 | `--split-sheets-suffix <suffix>` | xlsx/xls 按 sheet 拆分的子目录后缀 | `_split` |
@@ -586,6 +594,102 @@ convert-failures.json
 
 完整契约、fallback chain、Docker 部署见 [markitdown_serve/README.md](./markitdown_serve/README.md)；模块设计见 [tmp/svharnessbuild-detail-design.md §4.10](../tmp/svharnessbuild-detail-design.md#410-文档转换convert-命令--markitdown_serve-远端服务)。
 
+### `auto` —— 全自动构建 harness（无人值守）
+
+一条命令完成资料整理 → S10~S80 构建 → S85 七维评审 → 优化循环，直到综合分 ≥ 目标分后 S90 封存。
+
+```bash
+svharness auto [workdir] [options]
+```
+
+工作目录可以是已有 `<name>-harness/`（断点续跑），也可以是资料包根（自动检测后先 build）。
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `--work-dir <path>` | 工作目录 | 当前目录 |
+| `--config <path>` | 配置文件（`auto:` 节） | `svharness.config.yaml` |
+| `--target-score <score>` | 目标综合评分 | `9.5` |
+| `--max-optimize-rounds <n>` | 最大优化轮数 | `10` |
+| `--max-phase <phase>` | 只运行到此阶段即停止（如 `S40` 会跳过评审） | — |
+| `--auto-approve` / `-y, --yes` | 无人值守 | `autoApprove` 默认 `true` |
+| `--dry-run` | 打印 prompt，不调用 Agent | `false` |
+
+配置示例：`auto/templates/auto.config.example.yaml`
+
+### `auto_pack_req` —— 需求包全自动条目化（S40 专项）
+
+独立于 `auto`，专门用于需求文档条目化 + 质量闭环，**不污染**完整 harness 构建流程。
+
+```bash
+# 推荐：在 requirements 资料目录直接运行（目录名任意）
+cd ./requirements
+svharness auto_pack_req --yes
+
+# 或指定资料包根 / harness 根
+svharness auto_pack_req [workdir] [options]
+```
+
+**工作目录解析**（`[workdir]` 可省略，默认当前目录）：
+
+| 当前/指定目录 | 行为 |
+|---------------|------|
+| 本身是 requirements 资料夹（含文档文件，目录名任意） | 视为 `--requirements` 输入，在**上级目录**创建 `<name>-harness/` |
+| 资料包根（含 `requirements/` 等子目录） | 在目录内自动检测并创建 harness |
+| 已有 harness 根（或恰好一个 `*-harness/`） | 重置 S40，重做条目化 |
+| 多个 `*-harness/` | 报错，须显式指定路径 |
+
+**内置默认**：`targetScore=9.5`（须**严格大于**）、`maxOptimizeRounds=10`、`sampleCount=7`、`autoApprove=true`、`yes=true`
+
+**评分模型**：
+
+```
+综合分 = 机械门禁 × 0.40 + 对抗验证 × 0.30 + 抽样验证 × 0.30
+```
+
+| 维度 | 权重 | 说明 |
+|------|------|------|
+| 机械门禁 | 40% | `verify --strict` + `doctor --mode requirements --strict` 全通过；任一失败机械分=0 |
+| 对抗验证 | 30% | 独立 Reviewer Agent 逐 block 挑刺（禁止读 Builder 自评） |
+| 抽样验证 | 30% | 从 `requirements/md` 随机抽 N 片段，反向追溯 yaml 产物是否可支撑开发 |
+
+**通过条件**（AND）：`综合分 > targetScore` + 硬门禁全通过 + `critical_count=0`
+
+**两种入口**：
+
+| 模式 | 检测条件 | 行为 |
+|------|----------|------|
+| 资料包新建 | 无 `harness.yaml` | `runMaterialsPrepAndBuild` → S30+S40 |
+| 已有 harness 重做 | 存在 `harness.yaml` | 重置 `S40=PENDING` → 只跑 S40 |
+
+**主要参数**：
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `--requirements <path>` | 需求文档路径 | 自动检测 |
+| `--target-score <score>` | 目标综合评分（须严格大于） | `9.5` |
+| `--max-optimize-rounds <n>` | 最大优化轮数 | `10` |
+| `--sample-count <n>` | 抽样验证片段数 | `7` |
+| `--config <path>` | 配置文件（`auto_pack_req:` 节） | — |
+| `--dry-run` | 打印 S40 + 三维度评审 prompt | `false` |
+
+**典型用法**：
+
+```bash
+cd ./requirements && svharness auto_pack_req --yes
+svharness auto_pack_req ./req-pack --yes
+svharness auto_pack_req ./my-app-harness --requirements ./docs --yes
+svharness auto_pack_req --config auto-pack-req.config.yaml --dry-run
+```
+
+**产物**（不执行 S90）：
+
+- `requirements/yaml/*.yaml`、`requirements/coverage-report.yaml`
+- `auto-review/第N轮需求自评报告.md`、`第N轮对抗评审.md`、`第N轮抽样验证报告.md`
+- `auto-review/auto-score.json`、`auto-review/pack-req-complete.json`
+
+配置示例：`auto/templates/auto-pack-req.config.example.yaml`  
+详细设计：[`auto/auto-harness-detail-design.md` §2.2.1](./auto/auto-harness-detail-design.md#221-svharness-auto_pack_req-需求包专项)
+
 ### `wiki` —— 对任意代码工程生成 baseline wiki（v0.15+）
 
 独立子命令，**不依赖 harness 生命周期**，直接对任意代码工程目录就地扫描生成 wiki。与 `build` 内置 wiki 共用同一 repowiki 核心，但不拷贝 code、不创建 harness 骨架。

package/auto/auto-harness-detail-design.md

@@ -1,6 +1,6 @@
 # auto-harness 详细设计方案
 
-> **文档定位**：`svharness auto` 模式的完整设计书，面向本系统的开发者与维护者。  
+> **文档定位**：`svharness auto` 与 `svharness auto_pack_req` 模式的完整设计书，面向本系统的开发者与维护者。  
 > **上级文档**：`svharnessbuild/README.md`（CLI 总体规范）、`svharnessbuild/tmp/svharnessbuild-detail-design.md`（SDD）。  
 > **参照工程**：[snarktank/ralph](https://github.com/snarktank/ralph)（外循环思路）。  
 > **版本**：v2.6（2026-06-26，任意错误不中断 + CostTracker 超限兜底优化）  
@@ -309,6 +309,105 @@ async function resolveHarnessRoot(workDir: string): Promise<string | null> {
 
 > `harness.yaml` 通常位于 `<work-dir>/<name>-harness/harness.yaml`，而非项目根直接子级。`--work-dir` 可指向资料包根或 harness 根；Orchestrator 先执行上述解析再进入主循环。
 
+### 2.2.1 `svharness auto_pack_req` — 需求包专项
+
+> **定位**：独立于 `svharness auto` 的 preset 命令，内部固定 `scope=requirements`，不暴露 `--scope` CLI 参数。复用 `AutoOrchestrator` + `PhaseRunner`，不新建 orchestrator 类。
+
+#### 命令形态
+
+```bash
+# 推荐：在 requirements 资料目录直接运行（目录名任意）
+cd ./requirements && svharness auto_pack_req --yes
+
+# 或指定资料包根 / harness 根
+svharness auto_pack_req [workdir] [options]
+```
+
+实现入口：`src/commands/auto-pack-req.ts` → `resolveAutoPackReqWorkContext()` → 注入 preset opts → 调用 `runAuto()`。
+
+#### 工作目录解析（`[workdir]` 可省略）
+
+无参数时默认 `process.cwd()`，按以下优先级识别：
+
+| 当前目录 | 行为 |
+|----------|------|
+| harness 根（或恰好一个 `*-harness/`） | 重置 S40，重做条目化 |
+| 资料包根（含 `requirements/`、`baseline/` 等子目录） | 在目录内自动检测并 `build` |
+| **requirements 资料夹**（含 doc/md/pdf 等，**目录名任意**） | 将当前目录固定为 `--requirements` 输入，在**上级目录**创建 `<name>-harness/` |
+| 其它 | 按资料包根处理（与 `auto` 一致） |
+
+示例：在 `req-pack/requirements/` 内执行 `svharness auto_pack_req --yes`，等价于在 `req-pack/` 执行并指定 `--requirements ./requirements`。
+
+#### 内置默认（可被 CLI / 配置覆盖）
+
+| 参数 | 默认值 |
+|------|--------|
+| `scope` | `requirements`（内部固定） |
+| `targetScore` | `9.5`（通过条件为**严格大于**） |
+| `maxOptimizeRounds` | `10` |
+| `sampleCount` | `7` |
+| `autoApprove` / `yes` | `true` |
+
+配置文件节：`auto_pack_req:`（示例见 `auto/templates/auto-pack-req.config.example.yaml`）。
+
+#### 两种入口
+
+| 模式 | 检测 | 行为 |
+|------|------|------|
+| 资料包新建 | `resolveHarnessRoot(workDir)` 为 null | `runMaterialsPrepAndBuild` → 仅跑 `S30_convert_docs` + `S40_extract_requirements` |
+| 已有 harness 重做 | 存在 `harness.yaml` | `resetS40ForRerun()` 将 `S40_extract_requirements.status=PENDING`，不动 S50~S90 |
+
+阶段白名单（`SCOPE_PHASES.requirements`）：
+
+```typescript
+['S30_convert_docs', 'S40_extract_requirements']
+```
+
+#### 三维度质量闭环
+
+```
+综合分 = 机械门禁分 × 0.40 + 对抗验证分 × 0.30 + 抽样验证分 × 0.30
+```
+
+| 维度 | 权重 | 实现 |
+|------|------|------|
+| 机械门禁 | 40% | `runMechanicalGates({ scope: 'requirements' })`：`verify --strict` + `doctor --mode requirements --strict`；任一失败机械分=0 |
+| 对抗验证 | 30% | ACP + `S40-adversarial-review.md`；禁止读 Builder 自评报告 |
+| 抽样验证 | 30% | `auto-sample-trace.ts` 生成 `sample-fragments.json` + ACP + `S40-sample-trace.md` 反向追溯 |
+
+每轮评审流程（`runReqPackReview`）：
+
+1. 机械门禁
+2. `writeSampleFragmentsFile()` — 从 `requirements/md` 随机抽 N 片段
+3. Builder 自评 — `S40-review.md`（产出 gap 表供优化，**不计入**综合分权重）
+4. 对抗验证 — `S40-adversarial-review.md`
+5. 抽样验证 — `S40-sample-trace.md`
+6. `computeReqPackScore()` 加权 → 写 `auto-review/auto-score.json`
+
+**通过条件**（AND）：
+
+- `composite_score > targetScore`
+- `gate_pass === true`（verify=0、doctor=0、critical=0）
+- 不执行 `finalizeAutoHarness`（S90）；改为写 `auto-review/pack-req-complete.json`
+
+#### 优化循环 scope 隔离
+
+- `SCOPE_ALLOWED_PHASES.requirements` 仅含 `S40_extract_requirements`
+- `invalidateDownstream` 在 requirements scope 下**不调用**（避免 S50+ 标 OUTDATED）
+- 优化 prompt 仍复用 `optimize-plan.md` / `optimize-implement.md`
+
+#### 关键文件
+
+| 类型 | 路径 |
+|------|------|
+| CLI 入口 | `src/commands/auto-pack-req.ts` |
+| 三维度评审 | `src/lib/auto-req-pack-review.ts` |
+| 抽样生成 | `src/lib/auto-sample-trace.ts` |
+| 评分公式 | `src/lib/score-aggregator.ts` → `computeReqPackScore` |
+| 完成标记 | `src/lib/auto-pack-req-finalize.ts` |
+| Prompt | `auto/templates/phase-prompts/S40-review.md` 等 |
+| Rubric | `auto/templates/requirements-review-rubric.yaml` |
+
 ### 2.3 典型运行输出
 
 ```
@@ -391,7 +490,7 @@ program
   .option('--no-force',              '禁用自动 force（目标目录存在时不覆盖）')
   // === 质量与流程控制 ===
   .option('--target-score <score>',  '目标综合评分（默认 9.5）', '9.5')
-  .option('--max-optimize-rounds <n>','最大优化轮数（默认 5）', '5')
+  .option('--max-optimize-rounds <n>','最大优化轮数（默认 10）', '10')
   .option('--checkpoint <phase>',    '到达此阶段前暂停等待人工确认（如 S85）')
   .option('--max-phase <phase>',     '只运行到此阶段即停止（调试用）')
   .option('--dry-run',               '打印各阶段 prompt 和命令，不实际执行')
@@ -712,7 +811,7 @@ class CostTracker {
 **默认建议**（v2.6 提升）：
 
 - `--max-total-calls 100`（约 $30–$100 API 成本，覆盖完整构建+多轮优化）
-- `--max-optimize-rounds 5`（默认值不变）
+- `--max-optimize-rounds 10`（默认值）
 
 ### 4.5 完成标记协议
 
@@ -2259,7 +2358,7 @@ auto:
   
   # 质量目标
   targetScore: 9.5
-  maxOptimizeRounds: 5
+  maxOptimizeRounds: 10
   mechanicalWeight: 0.30       # 机械指标占综合分比例（默认 30%）
   reviewWeight: 0.70           # 评审 Agent 占综合分比例（默认 70%）
   
@@ -2801,3 +2900,36 @@ if (autoRepair) { tryAutoRepair(); }                      ← 在循环外
 mark SKIPPED + writeBuildState + continue                 ← 在循环外
 ```
 
+---
+
+## 附录：v2.7 实现修订记录（auto_pack_req）
+
+新增 `svharness auto_pack_req` 命令，作为 `auto` 的 preset 包装，专门服务 S40 需求条目化三维度质量闭环。
+
+| # | 文件 | 修订内容 | 类型 |
+|---|------|---------|------|
+| 1 | `src/commands/auto-pack-req.ts` | 新增 preset 入口；已有 harness 时 `resetS40ForRerun` | 新增 |
+| 2 | `src/index.ts` | 注册 `auto_pack_req [workdir]` 子命令 | 新增 |
+| 3 | `src/types/auto-types.ts` | `AutoScope`、`SampleFragment`、`ReqPackScoreSnapshot` 等 | 新增 |
+| 4 | `src/lib/auto-orchestrator.ts` | `scope=requirements` 走 `runReqPackReview` + `finalizeReqPack` | 增强 |
+| 5 | `src/lib/phase-runner.ts` | `SCOPE_PHASES` 白名单 | 增强 |
+| 6 | `src/lib/gate-checker.ts` | requirements scope 使用 `doctor --mode requirements` | 增强 |
+| 7 | `src/lib/score-aggregator.ts` | `computeReqPackScore` 三维度公式 | 新增 |
+| 8 | `src/lib/auto-req-pack-review.ts` | 机械 + 自评 + 对抗 + 抽样评审编排 | 新增 |
+| 9 | `src/lib/auto-sample-trace.ts` | 从 md 随机抽片段写 `sample-fragments.json` | 新增 |
+| 10 | `src/lib/auto-optimize.ts` | requirements scope 仅允许重跑 S40 | 增强 |
+| 11 | `auto/templates/phase-prompts/S40-*.md` | 三维度评审 prompt | 新增 |
+| 12 | `auto/templates/requirements-review-rubric.yaml` | 评审契约 SSOT | 新增 |
+| 13 | `auto/templates/auto-pack-req.config.example.yaml` | 配置示例 | 新增 |
+
+```
+auto_pack_req 与 auto 关系：
+
+svharness auto_pack_req
+  └── runAutoPackReq() 注入 scope=requirements preset
+        └── runAuto() → AutoOrchestrator
+              ├── PhaseRunner（S30+S40 only）
+              ├── runReqPackReview()（三维度）
+              └── finalizeReqPack()（非 S90）
+```
+

package/auto/skills/svharness/SKILL.md

@@ -169,7 +169,7 @@ svharness auto [--work-dir <path>] [options]
 | `--arch <arch>` | 架构模板 | `android-compose` |
 | `--harness-name <name>` | harness 名称（资料包模式必填） | — |
 | `--target-score <score>` | 目标综合评分 | `9.5` |
-| `--max-optimize-rounds <n>` | 最大优化轮数 | `5` |
+| `--max-optimize-rounds <n>` | 最大优化轮数 | `10` |
 | `--auto-approve` | 自动通过表单门禁 | `false` |
 | `-y, --yes` | 跳过所有交互确认 | `false` |
 | `--max-total-calls <n>` | ACP 调用次数上限 | `30` |
@@ -193,6 +193,49 @@ svharness auto --config auto.config.yaml --auto-approve
 
 **首次运行自动注入**：首次执行 `svharness auto` 时，CLI 会自动将 `svharness` skill 注入到 `~/.claude/skills/svharness/`，使 Claude Code 能识别 `/svharness` 命令。之后可在任意项目中对 Agent 说"自动构建 harness"触发。
 
+### `svharness auto_pack_req` — 需求包全自动条目化（S40 专项）
+
+独立于 `auto` 命令，专门用于需求文档条目化 + 三维度质量闭环，不污染完整 harness 构建流程。
+
+```bash
+# 推荐：在 requirements 资料目录直接运行（目录名任意）
+cd ./requirements && svharness auto_pack_req --yes
+
+svharness auto_pack_req [workdir] [options]
+```
+
+**工作目录**：无参数时默认当前目录。若当前目录本身是 requirements 资料夹（含 doc/md/pdf 等），自动视为输入并在上级目录创建 harness。
+
+**内置默认**：`targetScore=9.5`（须**严格大于**）、`maxOptimizeRounds=10`、`sampleCount=7`、`autoApprove=true`、`yes=true`
+
+**评分模型**：
+```
+综合分 = 机械门禁 × 0.40 + 对抗验证 × 0.30 + 抽样验证 × 0.30
+```
+
+| 维度 | 说明 |
+|------|------|
+| 机械门禁 | `verify --strict` + `doctor --mode requirements --strict` 全通过 |
+| 对抗验证 | 独立 Reviewer Agent 逐 block 挑刺（不读 Builder 自评） |
+| 抽样验证 | 从 `requirements/md` 随机抽 N 片段反向追溯 yaml 产物 |
+
+**两种入口**：
+- **资料包新建**：目录下无 `harness.yaml` → 创建 harness → S30+S40
+- **已有 harness 重做**：检测到 `harness.yaml` → 重置 S40=PENDING → 只跑 S40
+
+**典型用法**：
+
+```bash
+cd ./requirements && svharness auto_pack_req --yes
+svharness auto_pack_req ./req-pack --yes
+svharness auto_pack_req ./existing-harness --requirements ./docs --yes
+svharness auto_pack_req --dry-run
+```
+
+配置模板：`auto/templates/auto-pack-req.config.example.yaml`（`auto_pack_req:` 节）
+
+**产物**：`requirements/yaml/`、`auto-review/pack-req-complete.json`（不执行 S90 封存）
+
 ### `svharness shell` — Windows 右键菜单和别名管理
 
 ```bash

package/auto/templates/auto-pack-req.config.example.yaml

@@ -0,0 +1,29 @@
+version: 1
+
+defaults:
+  yes: true
+  verbose: false
+
+auto_pack_req:
+  workDir: .
+  harnessName: my-req-pack
+  goal: "描述此需求包的条目化目的"
+  arch: documents
+  agent: claude-code
+
+  requirements: ./requirements
+
+  targetScore: 9.5
+  maxOptimizeRounds: 10
+  sampleCount: 7
+  autoApprove: true
+
+  acpMode: auto
+  acpTimeoutMs: 600000
+  maxRetriesPerPhase: 2
+  maxTotalCalls: 100
+  budgetUsd: null
+  costAlertThreshold: 5
+
+  convertEndpoint: "http://markitdown.desaysz.site"
+  dryRun: false

package/auto/templates/auto.config.example.yaml

@@ -23,7 +23,7 @@ auto:
 
   # 质量目标与流程控制。
   targetScore: 9.5
-  maxOptimizeRounds: 5
+  maxOptimizeRounds: 10
   maxPhase: null
   checkpoint: null
   autoApprove: true

package/auto/templates/phase-prompts/S40-adversarial-review.md

@@ -0,0 +1,31 @@
+你是**独立**的需求审计 Agent（未参与 S40 条目化构建）。当前任务：对 {{HARNESS_ROOT}} 执行第 {{ROUND}} 轮对抗性验证。
+
+## 硬约束（违反则任务失败）
+- **禁止读取** `auto-review/第{{ROUND}}轮需求自评报告.md` 及任何 Builder 自评内容。
+- 仅基于源文档与产物独立审查。
+
+## 项目上下文
+- 构建目的：{{AUTO_GOAL}}
+- 机械门禁：doctor exit={{DOCTOR_EXIT}}，verify exit={{VERIFY_EXIT}}
+
+## 审查方法
+1. 读取 `requirements/_work/structure-index.json`，逐 block 对照 `requirements/yaml/*.yaml`。
+2. 挑刺重点：
+   - 遗漏条目（block 无对应 requirement 且无合理 waived）
+   - `source_excerpt` 缩略或占位语（「见上文」「同前」）
+   - `description` 信息缩减（条件/数值/枚举/时序丢失）
+   - waived 条目缺少 `aggregation_reason`
+3. 读取 `{{HARNESS_ROOT}}/auto/requirements-review-rubric.yaml` 中 adversarial 维度。
+
+## 产出要求
+1. 写入 `{{HARNESS_ROOT}}/auto-review/第{{ROUND}}轮对抗评审.md`。
+2. frontmatter 必须包含：
+   - `round: {{ROUND}}`
+   - `score.adversarial.coverage`（0-10）
+   - `score.adversarial.fidelity`（0-10）
+   - `score.adversarial.completeness`（0-10）
+   - `score.adversarial.average`（三项平均，0-10）
+   - `issues`（数组，每项含 severity/category/description/unit_id 或 block_id）
+   - `critical_count`（issues 中 severity=critical 的数量）
+3. 正文列出发现的问题清单。
+4. 输出末尾：`<AUTO_SIGNAL>ADV_REVIEW_DONE</AUTO_SIGNAL>`。

package/auto/templates/phase-prompts/S40-review.md

@@ -0,0 +1,22 @@
+你是 harness 构建 Agent。当前任务：对 {{HARNESS_ROOT}} 执行第 {{ROUND}} 轮 S40 需求自评。
+
+## 项目上下文
+- 构建目的：{{AUTO_GOAL}}
+- 机械门禁：doctor exit={{DOCTOR_EXIT}}，verify exit={{VERIFY_EXIT}}，文件齐全度={{FILE_COMPLETENESS_PCT}}%
+
+## 评审契约
+1. 读取 `{{HARNESS_ROOT}}/auto/requirements-review-rubric.yaml`。
+2. 仅评审 **requirements** 维度（不评 wiki/specs/references 等）。
+3. 检查 `requirements/yaml/*.yaml`、`requirements/coverage-report.yaml`、`requirements/_work/verify-gaps.json`。
+
+## 产出要求
+1. 写入 `{{HARNESS_ROOT}}/auto-review/第{{ROUND}}轮需求自评报告.md`。
+2. frontmatter 必须包含：
+   - `round: {{ROUND}}`
+   - `score.dimensions.requirements`（0-10）
+   - `gates.doctor_exit` / `gates.verify_exit` / `gates.file_completeness_pct`
+   - `gate_pass`（布尔）
+   - `critical_count`
+   - `modifications_required`
+3. 正文必须包含「修改建议汇总」表（优先级 | 阶段 | 问题 | 建议动作），供优化 Agent 读取。
+4. 输出末尾：`<AUTO_SIGNAL>REQ_REVIEW_DONE</AUTO_SIGNAL>`。

package/auto/templates/phase-prompts/S40-sample-trace.md

@@ -0,0 +1,26 @@
+你是需求抽样验证 Agent。当前任务：对 {{HARNESS_ROOT}} 执行第 {{ROUND}} 轮反向追溯抽样验证。
+
+## 项目上下文
+- 构建目的：{{AUTO_GOAL}}
+- 抽样片段文件：{{SAMPLE_FRAGMENTS_PATH}}
+
+## 验证方法（Sample-based Reverse Trace）
+1. 读取 `{{SAMPLE_FRAGMENTS_PATH}}` 中的 `fragments[]`。
+2. 对每个片段，在 `requirements/yaml/*.yaml` 中**反向查找**对应条目。
+3. 对每个片段评三个子维度（0-10）：
+   - **traceability**：能否找到对应 `unit_id`
+   - **fidelity**：`source_excerpt` 是否覆盖片段关键信息（条件/数值/枚举/时序）
+   - **usability**：`description` + `acceptance` 是否足以支撑开发者直接实现功能
+4. 读取 `{{HARNESS_ROOT}}/auto/requirements-review-rubric.yaml` 中 sample_trace 维度。
+
+## 产出要求
+1. 写入 `{{HARNESS_ROOT}}/auto-review/第{{ROUND}}轮抽样验证报告.md`。
+2. frontmatter 必须包含：
+   - `round: {{ROUND}}`
+   - `score.sample_trace.traceability`（所有片段平均，0-10）
+   - `score.sample_trace.fidelity`（0-10）
+   - `score.sample_trace.usability`（0-10）
+   - `score.sample_trace.average`（三项平均，0-10）
+   - `score.sample_trace.items`（数组，每项含 fragment_id、found_unit_id、traceability、fidelity、usability、note）
+3. 正文含逐片段验证明细表。
+4. 输出末尾：`<AUTO_SIGNAL>SAMPLE_TRACE_DONE</AUTO_SIGNAL>`。

package/auto/templates/requirements-review-rubric.yaml

@@ -0,0 +1,79 @@
+# requirements-review-rubric.yaml — auto_pack_req 三维度评审契约
+version: "1.0"
+
+scope: requirements
+
+dimensions:
+  - id: requirements
+    weight_composite: 0.0
+    title: Builder 自评（requirements 维度）
+    role: gap_generation
+    questions:
+      - 需求文档是否充分解析？覆盖率是否 100%？
+      - source_excerpt 是否保真？有无压缩导致细节丢失？
+      - unit_id / source_anchor 是否可索引？
+    evidence_hints:
+      - requirements/coverage-report.yaml
+      - requirements/yaml/*.yaml
+      - requirements/_work/verify-gaps.json
+
+  - id: adversarial
+    weight_composite: 0.30
+    title: 对抗性验证
+    role: scoring
+    questions:
+      - 逐 block 对照 structure-index，是否有遗漏条目？
+      - source_excerpt 是否缩略或使用占位语？
+      - description 是否缩减了条件/数值/枚举/时序？
+      - waived 条目是否有 aggregation_reason？
+    sub_scores:
+      - coverage
+      - fidelity
+      - completeness
+    evidence_hints:
+      - requirements/_work/structure-index.json
+      - requirements/yaml/*.yaml
+
+  - id: sample_trace
+    weight_composite: 0.30
+    title: 抽样反向追溯验证
+    role: scoring
+    questions:
+      - 随机源文档片段能否在 yaml 中找到 unit_id？
+      - source_excerpt 是否覆盖片段关键信息？
+      - description + acceptance 是否足以支撑功能开发？
+    sub_scores:
+      - traceability
+      - fidelity
+      - usability
+    evidence_hints:
+      - auto-review/sample-fragments.json
+      - requirements/md/*.md
+      - requirements/yaml/*.yaml
+
+mechanical_gate:
+  weight_composite: 0.40
+  checks:
+    - svharness requirements verify --strict exit 0
+    - svharness doctor --mode requirements --strict exit 0
+    - coverage_ratio == 1
+    - critical_count == 0
+
+pass_criteria:
+  composite_score_gt: 9.5
+  gate_pass: true
+  critical_count: 0
+
+modification_summary_columns:
+  - priority
+  - phase
+  - problem
+  - action
+  - status
+
+outputs:
+  self_review: "auto-review/第{n}轮需求自评报告.md"
+  adversarial: "auto-review/第{n}轮对抗评审.md"
+  sample_trace: "auto-review/第{n}轮抽样验证报告.md"
+  score_snapshot: auto-review/auto-score.json
+  complete_marker: auto-review/pack-req-complete.json

package/dist/commands/auto-pack-req.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAutoPackReq = runAutoPackReq;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const config_1 = require("../config");
+const logger_1 = require("../utils/logger");
+const auto_state_1 = require("../lib/auto-state");
+const auto_pack_req_context_1 = require("../lib/auto-pack-req-context");
+const auto_1 = require("./auto");
+const PACK_REQ_DEFAULTS = {
+    scope: 'requirements',
+    targetScore: 9.5,
+    maxOptimizeRounds: 10,
+    autoApprove: true,
+    yes: true,
+    sampleCount: 7,
+};
+async function runAutoPackReq(positionalWorkdir, opts, cmd) {
+    const loaded = (0, config_1.loadConfig)({ configPath: opts.config });
+    const autoSection = loaded?.config.auto_pack_req ?? loaded?.config.auto;
+    const merged = {
+        ...(0, config_1.mergeAutoOptions)(opts, autoSection, loaded?.config.defaults, cmd),
+        ...PACK_REQ_DEFAULTS,
+        ...opts,
+        scope: 'requirements',
+        targetScore: opts.targetScore ?? autoSection?.targetScore ?? PACK_REQ_DEFAULTS.targetScore,
+        maxOptimizeRounds: opts.maxOptimizeRounds ?? autoSection?.maxOptimizeRounds ?? PACK_REQ_DEFAULTS.maxOptimizeRounds,
+        sampleCount: opts.sampleCount ?? autoSection?.sampleCount ?? 7,
+        autoApprove: opts.autoApprove ?? true,
+        yes: opts.yes ?? true,
+    };
+    const workCtx = await (0, auto_pack_req_context_1.resolveAutoPackReqWorkContext)(positionalWorkdir, merged.workDir, merged.requirements);
+    const runOpts = {
+        ...merged,
+        ...(workCtx.requirementsPath ? { requirements: workCtx.requirementsPath } : {}),
+    };
+    if (workCtx.harnessRoot) {
+        logger_1.logger.info(`[auto_pack_req] 检测到已有 harness：${workCtx.harnessRoot}，将重做 S40`);
+        await resetS40ForRerun(workCtx.harnessRoot);
+    }
+    else if (workCtx.mode === 'requirements-cwd') {
+        logger_1.logger.info(`[auto_pack_req] 当前目录识别为 requirements 输入：${workCtx.requirementsPath}`);
+        logger_1.logger.info(`[auto_pack_req] 将在上级目录创建 harness：${workCtx.workDir}`);
+    }
+    else {
+        logger_1.logger.info('[auto_pack_req] 资料包模式：将创建 harness 并执行 S30+S40');
+    }
+    await (0, auto_1.runAuto)(workCtx.workDir, runOpts, cmd);
+}
+async function resetS40ForRerun(harnessRoot) {
+    const statePath = node_path_1.default.join(harnessRoot, '.harness-build-state.yaml');
+    if (!(await fs_extra_1.default.pathExists(statePath)))
+        return;
+    const state = await (0, auto_state_1.readBuildState)(harnessRoot);
+    if (!state.phases.S40_extract_requirements)
+        return;
+    state.phases.S40_extract_requirements = {
+        ...state.phases.S40_extract_requirements,
+        status: 'PENDING',
+    };
+    delete state.phases.S40_extract_requirements.outdated_reason;
+    state.current_phase = 'S40_extract_requirements';
+    state.next_action = 'auto_pack_req 已重置 S40，等待重新条目化';
+    await (0, auto_state_1.writeBuildState)(harnessRoot, state);
+    logger_1.logger.success('已重置 S40_extract_requirements 为 PENDING');
+}