T Demo Accept

Demo 测试验收

运行时边界统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/runtime-boundaries.md 需求来源边界统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/requirement-source-contract.md

目标

• 验证测试是否覆盖用户故事。
• 验证测试是否可编译、可运行且全部通过。
• 输出结构化验收报告到 .ai/quality/。

参数

/t-demo-accept [target]

target 说明：

• 测试文件路径：demo/e2e/super-admin/super-admin-comprehensive-demo.e2e.ts
• 角色名：super-admin / realm-admin / regular-user / third-party-app
• all 或留空：验收全部 Demo 测试

执行流程

• 识别目标测试文件。
• 若是文件路径：仅处理该文件。
• 若是角色名：匹配 demo/e2e/** 下对应文件。
• 若是 all 或空：扫描 demo/e2e/**/*.e2e.ts，排除 fixtures/、templates/、verification/。

• 用户故事一致性检查（必须）。
• 读取测试文件顶部注释中的用户故事路径。
• 校验用户故事文件存在；路径可以是 .ai/user-stories/... draft 或 docs/user-stories/... 已发布文档。
• 核对场景覆盖、角色匹配、关键断言与验收标准。

• 编译检查（必须）。

cd demo && npm run build

• 测试执行检查（必须）。

uv run scripts/demo-test-runner.py "[测试文件]" --mode fast --log-level mini

• 若任一测试失败、超时或编译失败，直接判定该文件 REJECTED。

• 代码质量检查。

grep -n "verifyTestEnvironment\|cleanupDemoTestData" [测试文件路径]
grep -n "UnifiedLogger\|logger\." [测试文件路径]
grep -n "waitForTimeout" [测试文件路径]
grep -n "data-testid\|getByRole\|getByText" [测试文件路径]
npx jscpd --pattern "**/*.ts" --reporters console demo/e2e
wc -l [测试文件路径]

• 生成报告。
• 单文件：.ai/quality/demo-accept-[name]-[YYYYMMDD-HHMMSS].md
• 批量：同时生成汇总 .ai/quality/demo-accept-summary-[YYYYMMDD-HHMMSS].md
• 报告必须包含重复代码检查结果：执行命令、重复率/重复块数量、关键文件位置；未执行时必须说明原因。

输出格式

每个文件产出：

• 状态：ACCEPTED / ACCEPTED_WITH_IMPROVEMENTS / REJECTED
• 分数：0-100
• 问题清单：P0 / P1 / P2
• 证据：失败命令、日志路径、相关代码位置
• 重复代码检查结果：命令、重复率/重复块数量、关键文件位置或未执行原因

日志路径统一使用仓库相对路径：

• log/backend-demo.log
• log/frontend-demo.log
• demo/test-results/

失败处理

• 用户故事不存在（.ai/user-stories 或 docs/user-stories 均未找到）：直接拒绝验收。
• 编译失败：直接拒绝验收。
• 测试失败或超时：直接拒绝验收。
• 批量模式下：记录失败并继续处理后续文件。

质量门禁

P0 必须全部通过：

• 用户故事映射有效
• 编译成功
• 测试全部通过
• 存在环境验证与数据清理
• 使用 UnifiedLogger

允许 ACCEPTED_WITH_IMPROVEMENTS 的前提：

• 所有测试通过
• 无 P0 问题

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: timzaak
• Source: timzaak/web-dev-skills
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.