diff --git a/.cursor/rules/test-reports-standard.mdc b/.cursor/rules/test-reports-standard.mdc index f15d906d..8ee51d18 100644 --- a/.cursor/rules/test-reports-standard.mdc +++ b/.cursor/rules/test-reports-standard.mdc @@ -1,6 +1,67 @@ --- -description: 按变更范围选择测试及真实证据要求 +description: 规定项目中所有自动化测试、功能测试、集成测试报告的存放路径与结构标准规范 +globs: ["**/*test*.go", ".doc/test-reports/**/*.md"] alwaysApply: true --- -测试范围、精确产品 PI 入口、环境模型证据和报告格式统一见 [验证契约](../../.doc/ops/2026-09-21-validation-contract.md)。按实际变更选择适用行；报告大小不扩大测试范围。 +# 测试报告规范准则 (Test Reports Standard) + +本仓库严格遵循标准化、可追溯的质量测试管理体系。所有测试报告必须归档于指定的文档目录下，并遵循固定结构。 + +**范围判定**：纯工程规范/文档变更按 [PROJECT.md](../../PROJECT.md) §8 和 [worktree 工作规范](../../.doc/ops/2026-09-21-agent-worktree-workflow.md) 检查链接、规则一致性及 Git 差异；不适用下述产品 PI 全链路与全量 Go 回归要求。报告注明 NOT REQUIRED 及依据，不能记成产品测试 PASS。运行模板、提示词和业务变更不属于此例外。 + +## 一、 测试报告归档路径规范 + +- **统一目录**：所有测试报告必须统一存放于 `.doc/test-reports/` 目录下。 +- **命名规范**：遵循 `YYYY-MM-DD-<模块/功能/版本>-test-report.md` 命名格式。 + - 例如：`.doc/test-reports/2026-09-07-three-branch-intent-framework-test-report.md` +- **证据附件**：运行产物（json/jsonl、workspace 快照、截图）放 `.doc/test-reports/assets//`，**不得**与 `*-test-report.md` 混放在同一层级目录。 + +--- + +## 二、 测试报告固定结构模板 + +每份测试报告必须包含以下核心板块： + +```markdown +# [功能/模块名称] 测试报告 + +## 一、 测试背景 (Background) +- 简述被测功能/特性的产生背景、业务痛点或上一轮测试中发现的缺陷与瓶颈。 + +## 二、 测试目标 (Test Objectives) +- 列举本次测试需要验证的核心功能点、质量指标（如通过率 100%、无流程卡点、非阻塞人机协同等）。 + +## 三、 测试方案与环境 (Test Plan & Environment) +- 测试环境（OS、Go 版本、后端 Stub/Real 模型）； +- 测试层级分层（单元测试、协同集成测试、CLI 真实交互测试）； +- 核心测试用例矩阵设计。 + +## 四、 预期结果 (Expected Results) +- 明确给出各用例输入下的理论判定分支、目标意图、提取槽位、参谋回复风格与状态机流转。 + +## 五、 实际测试结果与判定 (Actual Results & Evaluation) +- 必须包含针对每一个典型测试用例的真实记录： + - **测试输入 (Input)** + - **实际输出 (Actual Output)**：贴出真实的终端/日志输出文本 + - **评价判定 (Evaluation / Verdict)**：PASS / FAIL 标志及判定依据 + - **性能与耗时 (Duration & Latency)** + +## 六、 自动化测试套件汇总 (Test Suite Execution) +- 附带 `go test -v ./...` 全量回归测试输出与通过率统计。 + +## 七、 测试结论与后续优化建议 (Conclusion & Next Steps) +- 总结测试是否达到上线/合并标准，提出后续演进或强化点。 +``` + +--- + +## 三、 执行要求与真实 Agent 交付铁律 + +1. **真实 Agent 交付铁律（红线）**： + - **开发实现阶段**：可以快速使用 `stub` 验证状态机、协议分流、数据落盘与逻辑契约，加速反馈； + - **交付前验收与测试报告生成**：**必须切回真实环境与真实 Agent（`pi-agent` + 实际运行的 `MiniMax-M2.7-highspeed` 容器）进行全链路端到端实测**； + - **严禁**使用 stub 的测试输出作为最终交付报告的验收数据。 +2. **严禁散落存放**：测试报告统一归档至 `.doc/test-reports/` 目录下，禁止散落在根目录或临时沙箱中。 +3. **真实控制台取样**：测试报告中的输入、输出、耗时与判定必须取自实际环境运行的真实控制台输出与日志。 +4. **Git 规范管理**：测试报告伴随对应阶段的 `docs(test)` 或 `test(...)` 规范提交入库。 diff --git a/.doc/archive/ops/2026-09-21-agent-policy-review.md b/.doc/archive/ops/2026-09-21-agent-policy-review.md new file mode 100644 index 00000000..53b59b15 --- /dev/null +++ b/.doc/archive/ops/2026-09-21-agent-policy-review.md @@ -0,0 +1,47 @@ +--- +title: "Agent 规范整体审查" +status: done +created: 2026-09-21 +updated: 2026-09-21 +owner: Codex +branch: feature/agent-policy-review +worktree: .worktrees/agent-policy-review +base_dev_sha: a241e838150f218f3a09d3523f93291b847d45fd +write_scope: [.doc/ops/short-term/2026-09-21-agent-policy-review.md, .doc/archive/ops/2026-09-21-agent-policy-review.md, .doc/audit/2026-09-21-agent-policy-review.md, .doc/ops/CURRENT.md] +mutex: agent-policy-review +deployment: not_required +cleanup: retained-with-reason +--- + +# Agent 规范整体审查 + +## 目标与范围 + +评估生效规范的可完善之处，形成有依据的新增、删除、修改清单。本轮使用 ce-doc-review 的只读审查流程；不修改 AGENTS/PROJECT/客户端规则，不实现锁管理或改业务代码。 + +## 已确定约束 + +- 全部新增修改使用 .worktrees；主目录留给 dev 集成与运行。 +- 锁先统一入口/提交门禁防误改，OS 权限隔离后续实施。 +- 审查不等于实现或部署授权；已有未合入规范收口和 .locks 方案保留原分支。 + +## 步骤 + +1. [x] 启动链、当前 Git、规范与模板盘点。 +2. [x] 一致性、可执行性、范围、安全及故障场景复核。 +3. [x] 核实保留发现，形成增删改建议与实施优先级。 +4. [x] 文档校验、归档、本地提交。 + +## 验收 + +- 每条保留发现有当前源文件或明确缺失证据、实际后果和建议修改。 +- 区分已生效规则、尚待实现工具和未合入草案；不把建议当现状。 +- 未修改主目录跟踪文件、运行锁、服务或用户数据。 + +## 结果与交接 + +- [整体审查](../../audit/2026-09-21-agent-policy-review.md)：10 组增删改建议、2 项安全观察；保留已确定的 worktree 与 L1-first 选择。 +- 五个独立会话内视角已返回；主审核对引用与实际命令/脚本。文档原规则未改，自动化未实施。 +- 检查项：新增文档相对链接、git diff --check；未运行产品测试，不作运行验收声明。 +- 本任务 CURRENT 快照标 done，未占共享集成槽位；本地分支保留供审核，未合入 dev、未 push。 +- 需要执行修改时先按第一批消除冲突，再处理减负及既有工具实现；不要将本报告直接视为已生效规则。 diff --git a/.doc/archive/ops/2026-09-21-agent-workflow-governance-adoption.md b/.doc/archive/ops/2026-09-21-agent-workflow-governance-adoption.md new file mode 100644 index 00000000..f99f28e3 --- /dev/null +++ b/.doc/archive/ops/2026-09-21-agent-workflow-governance-adoption.md @@ -0,0 +1,43 @@ +--- +title: "采纳 Agent worktree 工作规范" +status: done +created: 2026-09-21 +updated: 2026-09-21 +owner: Codex +branch: feature/agent-workflow-governance-plan +worktree: .worktrees/feature-agent-workflow-governance-plan +mutex: agent-workflow-governance +--- + +# 采纳 Agent worktree 工作规范 + +## 授权与范围 + +用户于 2026-09-21 确认“提交吧，之后按这套执行”。延续原治理任务，在原 dev 派生的独立 worktree 内将方案采纳为生效规则，提交并合入本地 dev。仅修改规范、模板和治理记录。 + +本次不将 W1–W4 的自动化开发宣称已完成；它们保留在实施任务中。主目录仍有其他任务未提交改动，使用临时集成 worktree 合入纯文档，不迁移原任务、不改变业务运行态、不 push。 + +## 步骤 + +1. [x] 核对主目录现场、原方案提交与集成槽位。 +2. [x] 同步 AGENTS、PROJECT、Cursor 规则、操作规范与模板。 +3. [x] 文档检查、提交、独立 worktree 合入 dev。 +4. [x] 更新验收/交接及清理状态。 + +## 验收 + +- [x] 单 Agent 主目录开发例外已移除，生效规则可从启动链发现。 +- [x] 创建明确来自 dev；测试提交、共享服务串行、部署及安全清理条件可执行。 +- [x] 自动化能力保持 planned；主目录其他任务未提交改动不被纳入提交。 +- [x] 本地 dev 含本次规范提交；未 push，未重建服务。 + +## 相关链接 + +- [方案](../../remediation/2026-09-21-agent-workflow-governance-plan.md) + +## 结果 + +- 规则提交 `048bbe4a`，验证的合并候选及首次 dev 合入 `83e22a70`。 +- [文档验收](../../test-reports/2026-09-21-agent-workflow-governance-adoption-test-report.md)。 +- 主目录旧任务保留；临时 dev 集成工作区保留到原 owner 可安全切回 dev，见 [交接](../../ops/handoffs/2026-09-21-agent-workflow-governance-plan.md)。 +- 收口提交合入后普通清理本任务和候选工作区，实际结果记录共同 Git 目录的治理操作收据。未 push；deployment=not_required。 diff --git a/.doc/ops/handoffs/2026-09-21-agent-workflow-governance-plan.md b/.doc/ops/handoffs/2026-09-21-agent-workflow-governance-plan.md index 7d645b57..4d9e5a9c 100644 --- a/.doc/ops/handoffs/2026-09-21-agent-workflow-governance-plan.md +++ b/.doc/ops/handoffs/2026-09-21-agent-workflow-governance-plan.md @@ -25,9 +25,9 @@ status: open | 研究 mutex | 已在本 worktree CURRENT 标记 done | | 共享集成槽位 | 本任务分支 CURRENT 登记文档集成；实际操作持 common-dir 下 dev-integration.lock，主目录 CURRENT 保留 | | branch | feature/agent-workflow-governance-plan | -| worktree | .worktrees/feature-agent-workflow-governance-plan | +| worktree | 原任务及候选在收口后按门禁清理；dev 文档入口暂为 `.worktrees/agent-governance-dev-integration` | | 起点 | 本地 dev@15b8a4a8 | -| 合入 / push | 本次按已验证候选合入本地 dev；未 push，最终结果见规范采纳验收报告 | +| 合入 / push | 规则提交 `048bbe4a` 已经由候选 `83e22a70` 合入本地 dev；未 push；后续收口仅文档 | ## 验证及边界 @@ -35,9 +35,10 @@ status: open - 主目录另有 Cursor 工作流作用域任务的未提交改动；保留现场，不 checkout/pull/stash/reset。 - 当前没有自动任务协调器，分支 CURRENT 不等于全局实时认领。此次只有人工明确范围和本机 flock，不宣称自动队列或全局硬隔离已实现。 - 收口文档允许单独审核/合入，但不能按计划已写完将治理功能改成 done。 -- 主目录仍是旧任务分支；dev 暂由 `.worktrees/agent-governance-dev-integration` 检出以安全集成文档。旧任务 owner 保存成果、确认主目录干净后，先安全移除临时 dev worktree，再在主目录切回 dev；不得强抢 dev 检出。 +- 规范首次合入后，Cursor 已把作用域修复合入 `dev@e0665ca4`，并将主目录切为该提交的 detached HEAD 进行部署。dev 仍暂由 `.worktrees/agent-governance-dev-integration` 检出；该目录当前也被 Cursor 的集成流程使用，须等其释放槽位后再清理或接管。主目录最终切回 dev 前先安全移除临时 dev worktree；不得强抢检出或修改活跃部署源。 ## 相关链接 - [研究任务](../../archive/ops/2026-09-21-agent-workflow-governance-plan.md) - [CURRENT](../CURRENT.md) +- [采纳验收](../../test-reports/2026-09-21-agent-workflow-governance-adoption-test-report.md) diff --git a/.doc/test-reports/2026-09-21-agent-workflow-governance-adoption-test-report.md b/.doc/test-reports/2026-09-21-agent-workflow-governance-adoption-test-report.md new file mode 100644 index 00000000..b81b9c12 --- /dev/null +++ b/.doc/test-reports/2026-09-21-agent-workflow-governance-adoption-test-report.md @@ -0,0 +1,76 @@ +# Agent worktree 工作规范采纳验收 + +**日期**：2026-09-21。**范围**：工程规范与文档，非自动化系统或产品运行验收。 + +## 一、测试背景 + +用户批准 worktree 工作方式，需将研究方案转为可发现的生效规则，同时保护主目录其他 Agent 的未提交工作。 + +## 二、测试目标 + +规则入口一致、没有新增断链、只合入工程文档、候选与 dev 一致、主目录业务现场不被切换。 + +## 三、测试方案与环境 + +本机 Linux / Git 2.53.0，真实 Git linked worktree；检查文档与本地 Git 集成。没有 stub/真实产品 PI 调用，没有业务运行测试。父进程用 flock 串行操作，原始记录保存在 common-dir/agent-control/governance-adoption.json。 + +## 四、预期结果 + +文档检查无新错误；dev 接收已验证的同一合并提交；主目录分支和 HEAD 不变；部署 not_required，自动化仍 planned。 + +## 五、实际测试结果与判定 + +- PASS：用户批准的工作方式已写入 AGENTS、PROJECT、Cursor 规则、Herdr 规范指针和任务/收口模板。 +- PASS：全部新增改动使用 worktree，显式 dev 基线，串行候选集成，部署与安全清理条件已生效；旧脚本 create/remove 缺口有明确绕行方法。 +- PASS：链接检查覆盖 308 次本地引用，无新增断链；FEATURE-MATRIX 原有 promotion receipt 旧链接未因本任务修改。 +- PASS：规则差异及候选 `git diff --check`，只包含工程规范/Markdown 路径。 +- PASS：父进程持本机 `flock`，从明确 dev 与任务 SHA 创建 no-ff 候选，验证后在临时 dev 工作区 `--ff-only` 接收同一候选。 +- PASS：主目录分支与 HEAD 未切换，其他 Agent 的未提交业务文件未被纳入提交。 +- NOT REQUIRED：业务测试、PI、容器重建。本次不涉及运行制品，`deployment=not_required`。 +- NOT IMPLEMENTED：自动注册表、队列、脚本 guard、OS 权限隔离、PI 镜像交付等，FEATURE-MATRIX 仍为 planned。 + +### 控制台证据 + +- 链接检查：`Local links checked: 308`，`New broken links: []`；旧 FEATURE-MATRIX receipt 链接单独保留为既有问题。 +- `git diff --check`：退出码 0，无输出。 +- `git diff --exit-code 048bbe4a 83e22a70`：退出码 0，无输出，候选树与已检查的规则树一致。 +- 集成输出：`candidate=83e22a701f33825fe5b8fc34c21bf1ad8db07628`，`dev=83e22a701f33825fe5b8fc34c21bf1ad8db07628`，`main_branch_preserved=fix/intent-workflow-scoping-2026-09-21`。 +- 耗时：首次文档集成调用约 1.27 秒（工具墙钟），不作为产品性能指标。 + +### Git 身份 + +| 项 | 值 | +|---|---| +| 初始 dev | `15b8a4a87d9bd260ce9f613f5297fdd1fe6a2285` | +| 规则提交 | `048bbe4a5e2fd6ae0093664a2041a7533ea39fdf` | +| 已验证候选 = 首次合入 dev | `83e22a701f33825fe5b8fc34c21bf1ad8db07628` | +| 主目录保持 | `fix/intent-workflow-scoping-2026-09-21` @ `0912efdbd9346e61300b35961acccd1ec16bef0a` | +| 远端 | 未 push，未 fetch；不以本地跟踪引用宣称实时远端状态 | + +本报告及任务归档为随后独立的文档收口提交，不改变前述被验证内容。最终 dev 提交可从 `git log dev` 查看，不把收口 commit 当运行部署 SHA。 + +## 六、自动化测试套件汇总 + +只执行上述文档和 Git 现场检查。Go/前端/PG/真实 PI 套件 NOT REQUIRED（纯工程规范，依据 PROJECT §8 与 test-reports-standard 范围判定），不报告业务测试通过率。 + +## 七、测试结论与后续优化建议 + +生效工作规则已合入本地 dev，文档准入通过；完整自动化实现仍按独立计划推进。 + +### 并行基线变化 + +首次规范合入后，Cursor 接续合入 `e0665ca4` 并占槽 rebuild。收口请求仍携带 `83e22a70` 基线，被集成前置检查拒绝（dev SHA 不匹配），没有推进引用或改写主目录。收口需采用最新 dev 重建候选并保留 Cursor 槽位状态。 + +### 迁移与清理 + +- 主目录仍有旧任务工作，按过渡规则保留；不 stash/reset、不覆盖、不重建服务。 +- 临时 dev 检出目录为 `.worktrees/agent-governance-dev-integration`。其保留不是开发例外：只作此次文档集成与可读入口。原任务 owner 保存成果并确认根目录干净后，安全移除临时目录，再将主目录切回 dev。 +- 本任务 worktree 和集成候选在收口合入后检查无 tracked/untracked/ignored 遗留及 cwd 使用，再普通 remove/-d；若任何检查失败则保留并报告。最终实际清理状态写入 common-dir 的 `agent-control/governance-cleanup.json`。 +- 本机 `flock` 和临时操作记录仅为本次受控集成，不等于完整机器协调系统已交付。 + +## 链接 + +- [工作规范](../ops/2026-09-21-agent-worktree-workflow.md) +- [已采纳方案](../remediation/2026-09-21-agent-workflow-governance-plan.md) +- [收口任务](../archive/ops/2026-09-21-agent-workflow-governance-adoption.md) +- [迁移交接](../ops/handoffs/2026-09-21-agent-workflow-governance-plan.md)