weichen/Agent-System
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: import lock, policy, and governance artifacts for closeout

Browse Source
This commit is contained in:
weichen
2026-09-23 12:50:22 +00:00
parent 553f0ad61b
commit 6485532d88
5 changed files with 233 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.cursor/rules/test-reports-standard.mdc
+63 -2
View File
@@ -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/<report-slug>/`，**不得**与 `*-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(...)` 规范提交入库。
.doc/archive/ops/2026-09-21-agent-policy-review.md
+47
View File
@@ -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。
- 需要执行修改时先按第一批消除冲突，再处理减负及既有工具实现；不要将本报告直接视为已生效规则。
.doc/archive/ops/2026-09-21-agent-workflow-governance-adoption.md
+43
View File
@@ -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。
.doc/ops/handoffs/2026-09-21-agent-workflow-governance-plan.md
+4 -3
View File
@@ -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)
.doc/test-reports/2026-09-21-agent-workflow-governance-adoption-test-report.md
+76
View File
@@ -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)