feat(req): 部署门禁制度 — PDV 验收任务 + Deploy Gate 1-3

在 /req deploy 流程中增加部署后 E2E 验收（Post-Deploy Verification）门禁：
- 新增 verification linkRole 和【验收】任务命名规范
- Deploy Gate 1 健康检查 / Gate 2 PDV 任务完成 / Gate 3 证据完整
- PDV Playwright spec 模板（页面可达、菜单可见、API 连通）
- 同步更新 req-workflow、dev-test、e2e-testing 相关文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

skills-dev/dev-test-plugin/skills/dev-test/SKILL.md

@@ -15,6 +15,7 @@ description: 软件测试技能。用于单元测试、集成测试、E2E测试
 | `android-testing.md` | Android 测试 (JUnit + Espresso + Compose) |
 | `e2e-testing.md` | E2E Playwright：API Mock 冒烟测试（无后端）+ 全链路集成测试 |
 | `templates/go-integration-test.md` | Go 集成测试模板（多步骤 API 流程、中间件验证、租户隔离） |
+| `templates/pdv-smoke-spec.md` | PDV 部署后验收 Playwright 模板（页面可达、菜单可见、API 连通） |
 
 ---
 
@@ -50,6 +51,7 @@ description: 软件测试技能。用于单元测试、集成测试、E2E测试
 | E2E (Mock 冒烟) | `npm run test:e2e:smoke-mock` | `e2e-testing.md` §API Mock |
 | E2E (全链路) | `npm run test:e2e` | `e2e-testing.md` §全链路 |
 | E2E (Coolbuy PaaS) | `make e2e` | `e2e-testing.md` §Coolbuy |
+| E2E (部署后验收 PDV) | `E2E_BASE_URL=<url> npx playwright test e2e/pdv/` | §PDV |
 
 ---
 
@@ -145,6 +147,60 @@ ai-proj task append-doc --id <taskId> --content "# 测试报告
 
 ---
 
+## 部署后 E2E 验收 (PDV — Post-Deploy Verification)
+
+部署后验收是独立于 TG4 的 E2E 冒烟模式，在 `/req deploy` 健康检查通过后执行。
+
+### PDV vs TG4 区别
+
+| 维度 | TG4 (开发阶段 E2E 冒烟) | PDV (部署后验收) |
+|------|------------------------|-----------------|
+| **触发时机** | `/req test` Gate 4 | `/req deploy` 步骤 6 |
+| **环境** | 本地开发环境，API Mock | 真实部署环境 (staging/prod) |
+| **目的** | 验证前端逻辑、UI 渲染 | 验证功能入口可达、基本可用 |
+| **API** | `page.route()` 拦截 | 真实后端 API |
+| **范围** | 回归冒烟 | 仅新功能可达性 |
+
+### PDV 检查项
+
+| 检查项 | 说明 | 示例 |
+|--------|------|------|
+| **页面可达** | 需求涉及的前端页面返回 200 | `/okr/my`, `/okr/team` |
+| **菜单可见** | 新增菜单项在侧栏中出现 | OKR 菜单对目标用户角色可见 |
+| **基础渲染** | 页面无白屏/JS 报错 | 页面有预期的标题/组件 |
+| **API 连通** | 关键 API 带 token 调用返回正常 | `GET /api/v1/okr/objectives` 返回 200 |
+
+### PDV 不做什么
+
+- 不做完整回归测试（那是 TG4 的事）
+- 不测试复杂业务流程（如多步骤表单提交）
+- 不替代手动验收
+- 只做「功能入口可达 + 基本可用」的冒烟验证
+
+### PDV 执行方式
+
+```bash
+E2E_BASE_URL=<部署环境URL> npx playwright test e2e/pdv/ --project=chromium
+```
+
+### PDV Spec 生成规则
+
+AI 根据需求变更范围动态生成 Playwright spec，模板见 `templates/pdv-smoke-spec.md`。生成流程：
+
+1. 从需求关联任务提取前端变更范围（页面路由、菜单项、API 端点）
+2. 登录测试账号（使用 storageState 或手动登录）
+3. 验证新增菜单项可见（检查 `.ant-menu` 包含目标文本）
+4. 导航到新页面，验证非白屏（title 不含 error/500/404）
+5. 调用关键 API，验证返回状态码 < 500
+6. 每步截图保存为证据
+
+### PDV 结果判定
+
+- **全部 PASS** → 继续推进到 released
+- **任一 FAIL** → 阻断推进，在部署文档记录失败项，通知修复
+
+---
+
 ## TG2 集成测试检测
 
 ### 模板映射

skills-dev/dev-test-plugin/skills/dev-test/e2e-testing.md

@@ -1,14 +1,17 @@
 # E2E 测试 (Playwright)
 
-## 两种 E2E 测试模式
+## 三种 E2E 测试模式
 
 | 模式 | 后端依赖 | 速度 | 适用场景 | 门禁阶段 |
 |------|---------|------|---------|---------|
-| **API Mock 冒烟测试** | ❌ 无需后端 | 快（<30s） | UI 布局、路由、菜单、权限隔离 | E2E 冒烟门禁 |
+| **API Mock 冒烟测试** | ❌ 无需后端 | 快（<30s） | UI 布局、路由、菜单、权限隔离 | TG4 E2E 冒烟门禁 |
 | **全链路集成测试** | ✅ 需完整后端+DB | 慢（分钟级） | CRUD 业务流程、数据持久化 | 手动/CI |
+| **部署后验收 (PDV)** | ✅ 真实部署环境 | 中（<2min） | 功能入口可达、菜单可见、API 连通 | `/req deploy` 步骤 6 |
 
 **⚠️ 关键原则：E2E 冒烟门禁必须使用 API Mock 模式，不依赖后端。** 依赖后端的 E2E 在开发机上经常跑不通（后端没启动、DB 未初始化），导致门禁形同虚设。
 
+> **PDV 与 TG4 的区别**：TG4 在开发阶段用 API Mock 验证前端逻辑；PDV 在部署后用真实环境验证功能可达性。详见 `SKILL.md` §PDV 章节。
+
 > **与 req-test-gate 的关系**：本文档定义 E2E 测试的**执行技术**（怎么写 mock、怎么跑）。质量门禁流程（Gates 0-5、scope 分级、文档持久化）定义在 `req-test-gate` 技能中。
 
 ---

skills-dev/dev-test-plugin/skills/dev-test/templates/pdv-smoke-spec.md

@@ -0,0 +1,147 @@
+# PDV Smoke Spec 模板
+
+部署后验收 (Post-Deploy Verification) Playwright 测试模板。AI 根据需求变更范围，基于此模板动态生成验收 spec。
+
+## 使用方式
+
+```bash
+# 指定部署环境 URL 执行
+E2E_BASE_URL=https://staging.example.com npx playwright test e2e/pdv/ --project=chromium
+```
+
+## Spec 模板结构
+
+```typescript
+import { test, expect } from '@playwright/test';
+
+const BASE_URL = process.env.E2E_BASE_URL || 'http://localhost:3000';
+
+test.describe('PDV: {需求标题}', () => {
+
+  test.beforeEach(async ({ page }) => {
+    // 方式 1: 使用 storageState（推荐，需预先保存登录状态）
+    // test.use({ storageState: 'e2e/.auth/user.json' });
+
+    // 方式 2: 手动登录
+    await page.goto(`${BASE_URL}/login`);
+    await page.fill('input[name="username"]', '{测试账号}');
+    await page.fill('input[name="password"]', '{测试密码}');
+    await page.click('button[type="submit"]');
+    await page.waitForURL('**/dashboard/**');
+  });
+
+  test('菜单可见性: {菜单名}', async ({ page }) => {
+    await page.goto(`${BASE_URL}/`);
+    await page.waitForSelector('.ant-menu');
+
+    // 检查侧栏包含新菜单项
+    const menu = page.locator('.ant-menu');
+    await expect(menu).toContainText('{菜单名}');
+
+    // 截图证据
+    await page.screenshot({ path: 'e2e-results/pdv-menu-{菜单名}.png', fullPage: false });
+  });
+
+  test('页面可达: {页面路由}', async ({ page }) => {
+    const response = await page.goto(`${BASE_URL}{页面路由}`);
+
+    // 验证 HTTP 状态
+    expect(response?.status()).toBeLessThan(400);
+
+    // 验证非白屏 — title 不含错误关键词
+    await expect(page).not.toHaveTitle(/error|500|404|not found/i);
+
+    // 验证页面有核心内容（非空白）
+    await expect(page.locator('{核心选择器}')).toBeVisible({ timeout: 10000 });
+
+    // 检查无 JS 报错（通过 console error 监听）
+    const errors: string[] = [];
+    page.on('console', msg => {
+      if (msg.type() === 'error') errors.push(msg.text());
+    });
+    await page.waitForTimeout(2000);
+    expect(errors.filter(e => !e.includes('favicon'))).toHaveLength(0);
+
+    // 截图证据
+    await page.screenshot({ path: 'e2e-results/pdv-page-{页面名}.png', fullPage: true });
+  });
+
+  test('API 连通: {接口描述}', async ({ request }) => {
+    // 需要带认证 token 调用
+    const resp = await request.get(`${BASE_URL}/api/v1/{路径}`, {
+      headers: {
+        'Authorization': 'Bearer {token}',
+      },
+    });
+
+    // 验证非 5xx 错误
+    expect(resp.status()).toBeLessThan(500);
+
+    // 可选：验证响应结构
+    // const body = await resp.json();
+    // expect(body).toHaveProperty('data');
+  });
+
+});
+```
+
+## 占位符说明
+
+| 占位符 | 含义 | 来源 |
+|--------|------|------|
+| `{需求标题}` | 需求名称 | `ai-proj req get --id <id>` |
+| `{菜单名}` | 新增的菜单文本 | 从需求关联的前端任务中提取 |
+| `{页面路由}` | 新增/变更的前端路由 | 从前端路由配置或 PRD 提取 |
+| `{核心选择器}` | 页面核心内容的 CSS 选择器 | 如 `h1`, `.page-title`, `[data-testid="xxx"]` |
+| `{测试账号}` / `{测试密码}` | 测试环境登录凭据 | 环境配置 |
+| `{token}` | API 认证 token | 登录后获取 |
+| `{接口描述}` / `{路径}` | 关键 API 端点 | 从后端路由或 PRD 提取 |
+| `{页面名}` | 截图文件名标识 | 自定义 |
+
+## 生成示例（OKR 功能）
+
+```typescript
+import { test, expect } from '@playwright/test';
+
+const BASE_URL = process.env.E2E_BASE_URL || 'http://localhost:3000';
+
+test.describe('PDV: OKR 团队/对齐/设置/评分功能', () => {
+
+  test.beforeEach(async ({ page }) => {
+    await page.goto(`${BASE_URL}/login`);
+    await page.fill('input[name="username"]', 'testuser');
+    await page.fill('input[name="password"]', 'TestPass123');
+    await page.click('button[type="submit"]');
+    await page.waitForURL('**/dashboard/**');
+  });
+
+  test('菜单可见性: OKR', async ({ page }) => {
+    await page.goto(`${BASE_URL}/`);
+    await page.waitForSelector('.ant-menu');
+    await expect(page.locator('.ant-menu')).toContainText('OKR');
+    await page.screenshot({ path: 'e2e-results/pdv-menu-okr.png' });
+  });
+
+  test('页面可达: /okr/my', async ({ page }) => {
+    const response = await page.goto(`${BASE_URL}/okr/my`);
+    expect(response?.status()).toBeLessThan(400);
+    await expect(page).not.toHaveTitle(/error|500|404/i);
+    await expect(page.locator('h1, .page-title')).toBeVisible({ timeout: 10000 });
+    await page.screenshot({ path: 'e2e-results/pdv-page-okr-my.png', fullPage: true });
+  });
+
+  test('页面可达: /okr/team', async ({ page }) => {
+    const response = await page.goto(`${BASE_URL}/okr/team`);
+    expect(response?.status()).toBeLessThan(400);
+    await expect(page).not.toHaveTitle(/error|500|404/i);
+    await expect(page.locator('h1, .page-title')).toBeVisible({ timeout: 10000 });
+    await page.screenshot({ path: 'e2e-results/pdv-page-okr-team.png', fullPage: true });
+  });
+
+  test('API 连通: OKR objectives', async ({ request }) => {
+    const resp = await request.get(`${BASE_URL}/api/v1/okr/objectives`);
+    expect(resp.status()).toBeLessThan(500);
+  });
+
+});
+```