@openprd/cli 0.1.11 → 0.1.19

package/.openprd/changes/pm-human-in-the-loop/tasks.md

@@ -0,0 +1,306 @@
+# 任务
+
+- [x] T001.01 评审生成的 spec 覆盖
+  - type: governance
+  - done: 生成的 agent-requirements spec 符合 PRD 意图
+  - verify: openprd change . --validate --change pm-human-in-the-loop
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: governance
+  - evidence-plan: openprd change . --validate --change pm-human-in-the-loop
+  - upgrade-reason: 治理任务以结构校验、评审确认和变更状态证据为主
+  - execution-mode: serial
+  - parallel-group: governance
+  - write-scope: .openprd/changes/**, .openprd/**
+  - owner-role: main-agent
+  - local-verify: openprd change . --validate --change pm-human-in-the-loop
+  - integration-owner: main-agent
+
+- [x] T001.02 接通界面入口、导航与页面挂载
+  - type: implementation
+  - deps: T001.01
+  - done: 用户可以从正确入口进入对应界面，页面挂载与状态收尾已经接通。 涉及: 改动集中在 src/standards.js、src/quality.js、src/openspec/change-lifecycle.js、s 等 2 项。
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.02 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: visual-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: parallel-workers
+  - parallel-group: surface
+  - write-scope: src/cli/**, src/**, test/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.02 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.03 补齐日志、诊断与可观测性信号
+  - type: implementation
+  - deps: T001.02
+  - done: 关键阶段日志和诊断信号已经保留，后续排查可以直接定位到断点。 涉及: 改动集中在 src/standards.js、src/quality.js、src/openspec/change-lifecycle.js、s。
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.03 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: implementation
+  - write-scope: src/**, test/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.03 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.04 实现guide 命令基于工作区状态推断 7 步流程位置
+  - type: implementation
+  - deps: T001.03
+  - done: 已完成：guide 命令基于工作区状态推断 7 步流程位置
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.04 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: visual-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: parallel-workers
+  - parallel-group: domain
+  - write-scope: src/**, test/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.04 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.05 实现review.html 渲染 stepper
+  - type: implementation
+  - deps: T001.04
+  - done: 已完成：review.html 渲染 stepper
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.05 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: surface
+  - write-scope: src/cli/**, src/**, test/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.05 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.06 实现canvas /api/review-directions 返回方向元数据与图片
+  - type: implementation
+  - deps: T001.05
+  - done: 已完成：canvas /api/review-directions 返回方向元数据与图片
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.06 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: api-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: contracts
+  - write-scope: src/**, test/**, docs/basic/backend-structure.md
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.06 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.07 实现canvas 前端导入方向卡片组
+  - type: implementation
+  - deps: T001.06
+  - done: 已完成：canvas 前端导入方向卡片组
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.07 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: visual-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: parallel-workers
+  - parallel-group: implementation
+  - write-scope: src/**, test/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.07 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.08 打通主流程闭环：PM 打开终端或让 Agent 运行 openprd guide，看到 7 步流程和当前位置，按提示进入下一步 等 3 项
+  - type: implementation
+  - deps: T001.07
+  - done: 主流程关键节点已经打通，用户可以按预期从入口走到结果收尾。 涉及: PM 打开终端或让 Agent 运行 openprd guide，看到 7 步流程和当前位置，按提示进入下一步 等 3 项。
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.08 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: user-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: serial
+  - parallel-group: integration
+  - write-scope: src/**, test/**, docs/basic/**
+  - owner-role: main-agent
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.08 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.09 验证在 openprd 自身仓库通过单元测试与 standards/quality/run verify；用 Codex CLI 在本地跑一个桌面任务实测新流程效果并留下证据
+  - type: verification
+  - deps: T001.08
+  - done: 已验证：在 openprd 自身仓库通过单元测试与 standards/quality/run verify；用 Codex CLI 在本地跑一个桌面任务实测新流程效果并留下证据
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.09 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.09 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.10 回归非功能约束：不新增外部依赖 / guide 与画布 API 只读工作区状态，不写状态
+  - type: verification
+  - deps: T001.09
+  - done: 非功能约束已经回归确认。 涉及: 不新增外部依赖 / guide 与画布 API 只读工作区状态，不写状态。
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.10 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: visual-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.10 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.11 回归非功能约束：全部文案用 PM 能看懂的普通语言
+  - type: verification
+  - deps: T001.10
+  - done: 非功能约束已经回归确认。 涉及: 全部文案用 PM 能看懂的普通语言。
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.11 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.11 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.12 回归边界条件与失败处理：边界情况：工作区还没有任何需求版本时 guide 显示第 1 步并给出起步动作 等 3 项
+  - type: verification
+  - deps: T001.11
+  - done: 边界条件与失败处理已经回归确认。 涉及: 边界情况：工作区还没有任何需求版本时 guide 显示第 1 步并给出起步动作 等 3 项。
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.12 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.12 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.13 验证成本与额度护栏
+  - type: verification
+  - deps: T001.12
+  - done: 已验证免费、试用或低权限用户不能绕过额度、并发、频率或总量限制
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.13 --evidence-required
+  - test-layer: integration, security
+  - test-size: medium
+  - test-scope: security
+  - evidence-plan: 正向路径 + 越权、额度、并发或敏感信息负向验证
+  - upgrade-reason: 触达权限、安全、成本或滥用边界，需要至少集成级证据
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.13 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.14 验证滥用与越权路径
+  - type: verification
+  - deps: T001.13
+  - done: 已覆盖重复请求、并发请求、越权身份和异常恢复等负向场景
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.14 --evidence-required
+  - test-layer: integration, security
+  - test-size: medium
+  - test-scope: security
+  - evidence-plan: 正向路径 + 越权、额度、并发或敏感信息负向验证
+  - upgrade-reason: 触达权限、安全、成本或滥用边界，需要至少集成级证据
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.14 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.15 验证成本监控、报警和止损
+  - type: verification
+  - deps: T001.14
+  - done: 已确认用量或成本信号、报警阈值和人工/自动止损动作可执行
+  - verify: openprd tasks . --change pm-human-in-the-loop --item T001.15 --evidence-required
+  - test-layer: integration, security
+  - test-size: medium
+  - test-scope: security
+  - evidence-plan: 正向路径 + 越权、额度、并发或敏感信息负向验证
+  - upgrade-reason: 触达权限、安全、成本或滥用边界，需要至少集成级证据
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change pm-human-in-the-loop --item T001.15 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.16 维护 docs/basic 项目基础文档
+  - type: documentation
+  - deps: T001.15
+  - done: 已检查 docs/basic 是否缺失或因本次需求、流程、结构、依赖、产品行为变化而过期；若涉及后端、脚本、Agent 或工具链变更，已同步评估 CLI 与 API 接入面，并在 backend-structure.md 中记录事实或不适用原因；需要更新的基础文档已同步
+  - verify: openprd standards . --verify
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: docs
+  - evidence-plan: openprd standards . --verify
+  - upgrade-reason: 文档任务以标准校验和人工审查证据为主
+  - execution-mode: parallel-workers
+  - parallel-group: docs
+  - write-scope: docs/basic/**, README*.md
+  - owner-role: worker
+  - local-verify: openprd standards . --verify
+  - integration-owner: main-agent
+
+- [x] T001.17 更新文件说明书和文件夹 README
+  - type: documentation
+  - deps: T001.16
+  - done: 本次变更涉及的文件说明书和文件夹 README 已检查；缺失的已补齐，过期的已更新
+  - verify: openprd standards . --verify
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: docs
+  - evidence-plan: openprd standards . --verify
+  - upgrade-reason: 文档任务以标准校验和人工审查证据为主
+  - execution-mode: parallel-workers
+  - parallel-group: docs
+  - write-scope: docs/basic/**, README*.md
+  - owner-role: worker
+  - local-verify: openprd standards . --verify
+  - integration-owner: main-agent
+
+- [x] T001.18 运行 OpenPrd spec 校验
+  - type: governance
+  - deps: T001.17
+  - done: 生成的 change 通过 OpenPrd 校验
+  - verify: openprd change . --validate --change pm-human-in-the-loop
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: governance
+  - evidence-plan: openprd change . --validate --change pm-human-in-the-loop
+  - upgrade-reason: 治理任务以结构校验、评审确认和变更状态证据为主
+  - execution-mode: serial
+  - parallel-group: governance
+  - write-scope: .openprd/changes/**, .openprd/**
+  - owner-role: main-agent
+  - local-verify: openprd change . --validate --change pm-human-in-the-loop
+  - integration-owner: main-agent

package/.openprd/changes/test-strategy-router/.openprd.yaml

@@ -0,0 +1,2 @@
+schema: openprd.change.v1
+generatedFrom: v0003

package/.openprd/changes/test-strategy-router/design.md

@@ -0,0 +1,65 @@
+# 设计
+
+## 背景
+
+用户希望 OpenPrd 在测试阶段帮助项目建立分层测试体系，让不同大小和风险的需求获得合适的验证强度，并沉淀到任务、质量报告和 agent skill 中。
+
+## 目标
+
+- 新增测试策略分流器，按风险和证据成本推荐单元测试、集成测试、端到端测试、人工审查、预演、视觉对比或专项验证组合。
+- 让 OpenSpec 任务、循环测试报告和质量报告能展示本轮验证计划、执行证据和豁免理由。
+- 把测试分流接入生成的 skills、AGENTS 指引和 OpenPrd 质量评估，而不是另起一套平行门禁。
+
+## 范围
+
+- 新增 OpenPrd 测试策略分流指引。
+- 扩展 OpenSpec 任务元数据，支持测试层级、测试规模、验证范围、风险或证据计划等验证字段。
+- 扩展任务生成，根据需求分流、主流程、非功能、边界和失败路径给出默认测试策略。
+- 扩展质量评估执行环境和 HTML 报告，展示单元、集成、端到端、人工、专项验证证据的覆盖情况。
+- 扩展循环阶段性测试报告，让单任务执行记录选择的测试策略和证据路径。
+- 更新 README、基础文档和相关测试。
+
+## 约束
+
+- OpenPrd 是基于 Node.js 的命令行工具，测试使用 node --test。
+- 现有质量评估、循环、OpenSpec 任务、Agent 指引生成和 README 已有验证相关职责，需要在原有链路上扩展。
+- 标准 skill 变更会影响 Codex、Claude 和 Cursor 生成物。
+- 不得把外部方法论中的比例当成未经项目确认的硬性合规要求。
+- 不得让测试证据包含密钥、令牌、个人信息或完整敏感日志。
+- 涉及微信小程序验证时仍必须使用 weapp-dev-mcp，不能仅靠普通端到端文字声明。
+- 依赖现有 openprd-quality、openprd-requirement-intake、openprd-harness 和 Agent 指引生成机制。
+- 依赖 .openprd/quality/evidence、.openprd/harness/test-reports、coverage、tests/reports 等证据源。
+- 外部方法论参考 Martin Fowler 测试金字塔、Google 测试规模和端到端测试建议、Kent C. Dodds 测试奖杯以及 Thoughtworks Agent 反馈信号。
+
+## 业务护栏
+
+- 成本来源: E2E、真实浏览器、小程序、visual-compare、性能或极端数据测试会增加本地执行时间和排队成本。
+- 成本来源: 默认新增能力不引入第三方服务调用或联网依赖；只有项目已有测试命令要求时才使用对应工具。
+- 额度限制: 第一版测试策略以 advisory 和证据提示为主，不把固定比例作为硬性阻断。
+- 额度限制: 大型或慢速测试必须有风险理由、执行范围和替代证据说明。
+- 额度限制: 缺少本次执行证据时不能宣称已验证。
+- 滥用防护: 不允许用旧日志、空测试、脚本存在或截图存在冒充本次测试证据。
+- 滥用防护: 不允许把 70/20/10 当成硬指标诱导无意义单测或过度 E2E。
+- 滥用防护: 测试豁免必须记录原因和风险。
+- 监控信号: quality JSON/HTML 报告展示各测试层级的能力、执行证据、缺口和豁免理由。
+- 监控信号: loop test report 记录任务级 test-layer、test-size、test-scope、verify command 和 evidence。
+- 监控信号: run --verify 汇总 quality 的 productionReady 与测试证据缺口。
+- 报警阈值: 必测层级缺少本次执行证据时显示 needs-evidence。
+- 报警阈值: 任务触碰权限、成本、安全、用户主路径、发布或外部依赖却未升级验证时显示需关注。
+- 报警阈值: 检测到大量 E2E 但缺少单测或集成/契约测试时提示倒金字塔风险。
+- 止损动作: 发现证据不足时要求补测、补证据或记录明确豁免原因。
+- 止损动作: 慢测试或 flaky 测试不能反复重跑掩盖，需要记录风险并建议拆出更稳定的中间层验证。
+- 止损动作: 涉及小程序运行态时回到 weapp-dev-mcp 实测，不允许普通文字替代。
+
+## 风险与开放问题
+
+- 假设: 多数项目可以通过命令名、目录名、依赖和任务元数据推断测试层级。
+- 假设: 用户更需要最小足够证据，而不是固定比例或形式化覆盖率。
+- 假设: 新增字段以 advisory 起步，比一开始强阻断更容易兼容历史项目。
+- 风险: 过度分流可能增加用户和 Agent 的流程负担。
+- 风险: 规则太硬会导致过度 E2E 或无意义单测。
+- 风险: 规则太松又可能被 Agent 用旧证据或空测试绕过。
+- 风险: 不同技术栈对 integration、component、contract、e2e 的定义不一致。
+- 问题: 测试策略字段命名最终使用 test-layer、test-size、test-scope，还是使用 evidence-plan 或 test-strategy。
+- 问题: 第一版是否只做提示报告，还是对缺少本次证据的必测层级直接阻断。
+- 问题: 是否需要新增 CLI 子命令 openprd test-strategy，或仅作为 skill、质量评估和任务能力存在。

package/.openprd/changes/test-strategy-router/proposal.md

@@ -0,0 +1,45 @@
+# OpenPrd 测试策略分流器
+
+## 背景与原因
+
+OpenPrd 现在有质量门禁和验证证据机制，但缺少能按需求风险分流单元测试、集成测试、端到端测试、人工审查和专项验证的统一机制，导致测试要求不够可解释、证据不够结构化。
+
+## 变更内容
+
+- 新增 OpenPrd 测试策略分流指引。
+- 扩展 OpenSpec 任务元数据，支持测试层级、测试规模、验证范围、风险或证据计划等验证字段。
+- 扩展任务生成，根据需求分流、主流程、非功能、边界和失败路径给出默认测试策略。
+- 扩展质量评估执行环境和 HTML 报告，展示单元、集成、端到端、人工、专项验证证据的覆盖情况。
+- 扩展循环阶段性测试报告，让单任务执行记录选择的测试策略和证据路径。
+- 更新 README、基础文档和相关测试。
+- 新增测试策略分流指引，定义风险驱动的证据矩阵和需求分流后的默认验证建议。
+- OpenSpec 任务支持测试层级、测试规模、验证范围等测试策略元数据，并在校验中校验取值。
+- 任务生成时根据实现、主流程闭环、验收、非功能、边界和失败模式推导默认测试策略。
+- 质量评估检测测试命令、测试目录、证据来源和激活任务，输出测试策略矩阵。
+- 循环提示和完成报告展示本任务测试策略、执行命令、结果和证据路径。
+- Agent 指引、README 和基础文档同步说明测试分流流程。
+- OpenPrd 生成的任务支持测试策略元数据，并保留现有完成条件和验证命令行为兼容。
+- 新增 openprd-test-strategy skill 或等价的标准指引，并被 Codex、Claude、Cursor 生成物引用。
+- 质量评估报告包含测试策略矩阵，不把固定比例作为硬阻断。
+- 本地测试覆盖任务元数据解析、任务生成、质量检测、循环报告和生成 skill 更新。
+
+## 能力范围
+
+- `agent-requirements`: OpenPrd 测试策略分流器 需求。
+
+## 影响范围
+
+- 主要用户: 使用 OpenPrd 交付需求并依赖 Agent 自测的开发者
+- 主要用户: 维护 OpenPrd quality、loop、tasks 和 agent guidance 的 OpenPrd maintainer
+- 成本来源: E2E、真实浏览器、小程序、visual-compare、性能或极端数据测试会增加本地执行时间和排队成本。
+- 成本来源: 默认新增能力不引入第三方服务调用或联网依赖；只有项目已有测试命令要求时才使用对应工具。
+- 额度限制: 第一版测试策略以 advisory 和证据提示为主，不把固定比例作为硬性阻断。
+- 额度限制: 大型或慢速测试必须有风险理由、执行范围和替代证据说明。
+- 额度限制: 缺少本次执行证据时不能宣称已验证。
+- 依赖: 依赖现有 openprd-quality、openprd-requirement-intake、openprd-harness 和 Agent 指引生成机制。
+- 依赖: 依赖 .openprd/quality/evidence、.openprd/harness/test-reports、coverage、tests/reports 等证据源。
+- 依赖: 外部方法论参考 Martin Fowler 测试金字塔、Google 测试规模和端到端测试建议、Kent C. Dodds 测试奖杯以及 Thoughtworks Agent 反馈信号。
+- 风险: 过度分流可能增加用户和 Agent 的流程负担。
+- 风险: 规则太硬会导致过度 E2E 或无意义单测。
+- 风险: 规则太松又可能被 Agent 用旧证据或空测试绕过。
+- 风险: 不同技术栈对 integration、component、contract、e2e 的定义不一致。

package/.openprd/changes/test-strategy-router/specs/agent-requirements/spec.md

@@ -0,0 +1,16 @@
+## 新增需求
+
+### 需求：OpenPrd 测试策略分流器
+OpenPrd 现在有质量门禁和验证证据机制，但缺少能按需求风险分流单元测试、集成测试、端到端测试、人工审查和专项验证的统一机制，导致测试要求不够可解释、证据不够结构化。
+
+#### 场景：主流程成功
+- **当** 用户提出需求后，OpenPrd 先做需求分流，再由测试策略分流器给出最低验证组合和升级条件。
+- **则** OpenPrd 生成的任务支持测试策略元数据，并保留现有完成条件和验证命令行为兼容。
+
+#### 场景：边界情况保持可见
+- **当** 小改动触碰权限、数据写入、命令行或接口契约、生成物或用户主路径时，需要从单元测试升级到集成测试或端到端测试。
+- **则** 产品应保持该情况明确可见，以支持实现和验证
+
+#### 场景：失败模式得到处理
+- **当** Agent 用旧日志、空测试或脚本存在冒充本次证据时，质量评估应提示缺少当前执行证据。
+- **则** 产品应提供有边界且可评审的结果

package/.openprd/changes/test-strategy-router/task-events.jsonl

@@ -0,0 +1 @@
+{"version":1,"at":"2026-05-30 12:23:48","changeId":"test-strategy-router","action":"advance","taskId":"T001.01","taskTitle":"评审生成的 spec 覆盖","ok":true,"verify":null,"evidence":null,"notes":"T001.01 评审覆盖已人工复核：proposal/design/spec/tasks 已生成并匹配 v0003 PRD；openprd change --validate 的结构检查通过，但命令整体因既有 unrelated standards 文件说明书债务返回失败，债务路径包括 feishu-webhook-bridge-workspace、hyperframes-product-intro-case 和 tools/glm_coding_plan_installer.py，非本 change spec/task 覆盖问题。"}

package/.openprd/changes/test-strategy-router/tasks.md

@@ -0,0 +1,132 @@
+# 任务
+
+- [x] T001.01 评审生成的 spec 覆盖
+  - type: governance
+  - done: 生成的 agent-requirements spec 符合 PRD 意图
+  - verify: openprd change . --validate --change test-strategy-router
+
+- [ ] T001.02 接通界面入口、导航与页面挂载
+  - type: implementation
+  - deps: T001.01
+  - done: 用户可以从正确入口进入对应界面，页面挂载与状态收尾已经接通。 涉及: 依赖现有 openprd-quality、openprd-requirement-intake、openprd-harness 和 Agent 。
+  - verify: openprd run . --verify
+
+- [ ] T001.03 实现新增测试策略分流指引，定义风险驱动的证据矩阵和需求分流后的默认验证建议
+  - type: implementation
+  - deps: T001.02
+  - done: 已完成：新增测试策略分流指引，定义风险驱动的证据矩阵和需求分流后的默认验证建议
+  - verify: openprd run . --verify
+
+- [ ] T001.04 实现OpenSpec 任务支持测试层级、测试规模、验证范围等测试策略元数据，并在校验中校验取值
+  - type: implementation
+  - deps: T001.03
+  - done: 已完成：OpenSpec 任务支持测试层级、测试规模、验证范围等测试策略元数据，并在校验中校验取值
+  - verify: openprd run . --verify
+
+- [ ] T001.05 实现任务生成时根据实现、主流程闭环、验收、非功能、边界和失败模式推导默认测试策略
+  - type: implementation
+  - deps: T001.04
+  - done: 已完成：任务生成时根据实现、主流程闭环、验收、非功能、边界和失败模式推导默认测试策略
+  - verify: openprd run . --verify
+
+- [ ] T001.06 实现质量评估检测测试命令、测试目录、证据来源和激活任务，输出测试策略矩阵
+  - type: implementation
+  - deps: T001.05
+  - done: 已完成：质量评估检测测试命令、测试目录、证据来源和激活任务，输出测试策略矩阵
+  - verify: openprd run . --verify
+
+- [ ] T001.07 实现循环提示和完成报告展示本任务测试策略、执行命令、结果和证据路径
+  - type: implementation
+  - deps: T001.06
+  - done: 已完成：循环提示和完成报告展示本任务测试策略、执行命令、结果和证据路径
+  - verify: openprd run . --verify
+
+- [ ] T001.08 实现Agent 指引、README 和基础文档同步说明测试分流流程
+  - type: implementation
+  - deps: T001.07
+  - done: 已完成：Agent 指引、README 和基础文档同步说明测试分流流程
+  - verify: openprd run . --verify
+
+- [ ] T001.09 打通主流程闭环：用户提出需求后，OpenPrd 先做需求分流，再由测试策略分流器给出最低验证组合和升级条件 等 3 项
+  - type: implementation
+  - deps: T001.08
+  - done: 主流程关键节点已经打通，用户可以按预期从入口走到结果收尾。涉及: 用户提出需求后，OpenPrd 先做需求分流，再由测试策略分流器给出最低验证组合和升级条件 等 3 项。
+  - verify: openprd run . --verify
+
+- [ ] T001.10 验证OpenPrd 生成的任务支持测试策略元数据，并保留现有完成条件和验证命令行为兼容
+  - type: verification
+  - deps: T001.09
+  - done: 已验证：OpenPrd 生成的任务支持测试策略元数据，并保留现有完成条件和验证命令行为兼容
+  - verify: openprd run . --verify
+
+- [ ] T001.11 验证新增 openprd-test-strategy skill 或等价的标准指引，并被 Codex、Claude、Cursor 生成物引用
+  - type: verification
+  - deps: T001.10
+  - done: 已验证：新增 openprd-test-strategy skill 或等价的标准指引，并被 Codex、Claude、Cursor 生成物引用
+  - verify: openprd run . --verify
+
+- [ ] T001.12 验证质量评估报告包含测试策略矩阵，不把固定比例作为硬阻断
+  - type: verification
+  - deps: T001.11
+  - done: 已验证：质量评估报告包含测试策略矩阵，不把固定比例作为硬阻断
+  - verify: openprd run . --verify
+
+- [ ] T001.13 验证本地测试覆盖任务元数据解析、任务生成、质量检测、循环报告和生成 skill 更新
+  - type: verification
+  - deps: T001.12
+  - done: 已验证：本地测试覆盖任务元数据解析、任务生成、质量检测、循环报告和生成 skill 更新
+  - verify: openprd run . --verify
+
+- [ ] T001.14 回归非功能约束：新增能力必须保持现有任务文件和旧 change 兼容，缺少测试策略字段时给出默认推导或提示 等 2 项
+  - type: verification
+  - deps: T001.13
+  - done: 非功能约束已经回归确认。涉及: 新增能力必须保持现有任务文件和旧 change 兼容，缺少测试策略字段时给出默认推导或提示 等 2 项。
+  - verify: openprd run . --verify
+
+- [ ] T001.15 回归非功能约束：报告文案面向普通用户，避免把内部实现细节直接写成用户说明 等 2 项
+  - type: verification
+  - deps: T001.14
+  - done: 非功能约束已经回归确认。涉及: 报告文案面向普通用户，避免把内部实现细节直接写成用户说明 / 质量结论以本次执行证据为准，脚本存在只能说明具备能力。
+  - verify: openprd run . --verify
+
+- [ ] T001.16 回归边界条件与失败处理：边界情况：小改动触碰权限、数据写入、命令行或接口契约、生成物或用户主路径时，需要从单元测试升级到集成测试或端到端 等 7 项
+  - type: verification
+  - deps: T001.15
+  - done: 边界条件与失败处理已经回归确认。涉及: 边界情况：小改动触碰权限、数据写入、命令行或接口契约、生成物或用户主路径时，需要从单元测试升级到集成测试或端到端测试 等 7 项。
+  - verify: openprd run . --verify
+
+- [ ] T001.17 验证成本与额度护栏
+  - type: verification
+  - deps: T001.16
+  - done: 已验证免费、试用或低权限用户不能绕过额度、并发、频率或总量限制
+  - verify: openprd run . --verify
+
+- [ ] T001.18 验证滥用与越权路径
+  - type: verification
+  - deps: T001.17
+  - done: 已覆盖重复请求、并发请求、越权身份和异常恢复等负向场景
+  - verify: openprd run . --verify
+
+- [ ] T001.19 验证成本监控、报警和止损
+  - type: verification
+  - deps: T001.18
+  - done: 已确认用量或成本信号、报警阈值和人工/自动止损动作可执行
+  - verify: openprd run . --verify
+
+- [ ] T001.20 维护 docs/basic 项目基础文档
+  - type: documentation
+  - deps: T001.19
+  - done: 已检查 docs/basic 是否缺失或因本次需求、流程、结构、依赖、产品行为变化而过期；若涉及后端、脚本、Agent 或工具链变更，已同步评估 CLI 与 API 接入面，并在 backend-structure.md 中记录事实或不适用原因；需要更新的基础文档已同步
+  - verify: openprd standards . --verify
+
+- [ ] T001.21 更新文件说明书和文件夹 README
+  - type: documentation
+  - deps: T001.20
+  - done: 本次变更涉及的文件说明书和文件夹 README 已检查；缺失的已补齐，过期的已更新
+  - verify: openprd standards . --verify
+
+- [ ] T001.22 运行 OpenPrd spec 校验
+  - type: governance
+  - deps: T001.21
+  - done: 生成的 change 通过 OpenPrd 校验
+  - verify: openprd change . --validate --change test-strategy-router

package/.openprd/changes/verify-boundaries-and-historical-refresh/.openprd.yaml

@@ -0,0 +1,2 @@
+schema: openprd.change.v1
+generatedFrom: v0001

package/.openprd/changes/verify-boundaries-and-historical-refresh/design.md

@@ -0,0 +1,28 @@
+# 设计
+
+## 背景
+
+历史项目的运行校验正在被参考目录噪音阻塞，需要尽快恢复运行上下文和运行校验的可信度。
+
+## 目标
+
+- 让主验证只关注当前项目源码和当前实现门禁
+- 让历史项目刷新后默认获得更干净的校验体验
+
+## 范围
+
+- 调整 run context 与 run verify 对 discovery 的纳入规则
+- 调整 standards/source-manual 默认对明显外部参考目录的处理策略
+- 为历史项目执行 openprd fleet 更新与必要回填
+
+## 约束
+
+- 待补充
+
+## 业务护栏
+
+- 待补充
+
+## 风险与开放问题
+
+- 问题: 本次只收敛默认边界，不自动猜测每个历史项目全部外部参考目录清单；如果某些项目还需要更细的目录级归类，仍由维护者显式确认和补充

package/.openprd/changes/verify-boundaries-and-historical-refresh/proposal.md

@@ -0,0 +1,23 @@
+# Verify 边界与历史项目刷新
+
+## 背景与原因
+
+修复 OpenPrd 校验边界，避免外部参考目录和参考调研状态污染主验证，并刷新历史项目生成物。
+
+## 变更内容
+
+- 调整 run context 与 run verify 对 discovery 的纳入规则
+- 调整 standards/source-manual 默认对明显外部参考目录的处理策略
+- 为历史项目执行 openprd fleet 更新与必要回填
+- 运行上下文与运行校验的默认结果不再把参考调研状态或明显外部参考目录当成主门禁噪音
+- 历史项目刷新后生成物能承接这次边界修复
+- 对需要人工确认的外部参考目录仍保留显式 `classify-external` 路径
+
+## 能力范围
+
+- `agent-requirements`: Verify 边界与历史项目刷新 需求。
+
+## 影响范围
+
+- 主要用户: 维护 OpenPrd 的 Agent 工程师
+- 主要用户: 使用 OpenPrd 管理历史项目的项目维护者

package/.openprd/changes/verify-boundaries-and-historical-refresh/specs/agent-requirements/spec.md

@@ -0,0 +1,16 @@
+## 新增需求
+
+### 需求：Verify 边界与历史项目刷新
+修复 OpenPrd 校验边界，避免外部参考目录和参考调研状态污染主验证，并刷新历史项目生成物。
+
+#### 场景：主流程成功
+- **当** 维护者运行 `openprd run . --context` 或 `openprd run . --verify` 时，只看到当前项目主验证状态；仓库中存在 `research`、`toolkit-sources`、`marketplace-candidates` 等参考目录时，默认不会被当成本项目源码说明书缺口直接淹没结果；维护者可以继续按需显式运行 `classify-external`。
+- **则** 默认运行上下文与运行校验结果不再把参考调研状态或明显外部参考目录当成主门禁噪音
+
+#### 场景：边界情况保持可见
+- **当** 出现边界情况
+- **则** 产品应保持该情况明确可见，以支持实现和验证
+
+#### 场景：失败模式得到处理
+- **当** 参考调研状态仍然混入运行上下文或运行校验
+- **则** 产品应提供有边界且可评审的结果