用途
devdocs-verify 是一个统一验证 Skill，采用“四合一”方式整合文档对齐、实现正确性、UI 设计对齐与开发就绪检查，替代原来的 devdocs-review、devdocs-requirements-alignment、devdocs-ui-alignment 三个 Skill。其核心定位是通过不同的运行参数，分别回答四个问题：文档写对了没（--docs）、代码做对了没（--impl）、界面做对了没（--ui）、能开工了没（--readiness），并与对抗式验证（检查代码质量是否合格）形成互补。
主要能力
按维度划分，该 Skill 提供以下检查能力：
- 文档对齐（--docs）：分为三层，层 1 检查原始需求到需求文档（F/US/AC）的对齐，检测遗漏、过度扩展与偏移；层 2 检查需求文档到系统设计的映射；层 3 检查需求文档到测试用例的映射及正向、异常路径覆盖。每层可独立执行，并支持 --layer1、--layer2、--layer3 单独运行。
- 实现正确性（--impl）：包含 AC 满足度审查（逐条语义判断，给出满足/部分满足/未满足判定）、设计符合度审查（接口签名一致性、模块职责偏离、数据流符合度、组件边界）以及追溯完整性审查（@satisfies/@verifies 覆盖率）。支持 --ac、--design、--trace 子选项。
- UI 设计对齐（--ui）：分两阶段，阶段 1 检查设计稿与需求的对齐，阶段 2 检查设计稿与实现的对齐。对比维度包括布局结构、间距、颜色、字体、交互状态、响应式。支持 --design、--impl 子选项。
- 开发就绪检查（--readiness）：检查 AC 与测试用例对齐、任务文件路径具体性、任务依赖无环、设计与任务一致性。
所有发现统一按 P1（阻塞发布）、P2（应修复）、P3（可优化）分级。
使用方式
devdocs-verify 通过命令参数调用，主要形式包括：
- /devdocs-verify：自动检测维度
- /devdocs-verify --docs：仅文档对齐（三层检查）
- /devdocs-verify --docs --layer1：仅原始需求 → 需求文档
- /devdocs-verify --docs --layer2：仅需求文档 → 系统设计
- /devdocs-verify --docs --layer3：仅需求文档 → 测试用例
- /devdocs-verify --impl：仅实现正确性
- /devdocs-verify --impl --ac：仅 AC 满足度
- /devdocs-verify --impl --design：仅设计符合度
- /devdocs-verify --impl --trace：仅追溯完整性
- /devdocs-verify --ui：仅 UI 设计对齐
- /devdocs-verify --ui --design：仅设计稿 ↔ 需求
- /devdocs-verify --ui --impl：仅设计稿 ↔ 实现
- /devdocs-verify --readiness：开发就绪检查
- /devdocs-verify T-01 T-02：指定任务范围（自动 --impl）
无参数调用时，根据是否存在最新 05-test-report.md、当前开发阶段以及是否为 UI 任务自动选择维度；若无法判断则询问用户。工作流程为：确定验证维度、读取 DevDocs 文档（01-requirements.md、02-system-design.md、03-test-cases.md、05-test-report.md 等）、按维度执行检查、生成验证报告、给出修复建议与路由。
适用场景
根据资料，该 Skill 的触发条件包括：需求/设计/测试文档完成后（--docs）；任务开发完成后、对抗式验证之前（--impl）；UI 相关任务开发完成后（--ui）；任务拆分完成、进入开发前（--readiness）；以及用户要求检查文档/实现/UI 对齐时。它还与其他 Skill 协作，例如在 devdocs-dev-workflow 任务完成后被调用触发 --impl，在 devdocs-requirements 完成后触发 --docs --layer1，在 devdocs-pipeline 中作为 dev-tasks 完成后、dev-workflow 前的质量关卡等。
输出与限制
输出文件方面，--docs/--impl/--ui 输出 docs/devdocs/verify-report.md，--readiness 输出 docs/devdocs/readiness-report.md，模板参见 templates 目录下对应文件。作为子 Agent 运行时返回结构化摘要，包含各维度状态、P1/P2/P3 总数、blockers 及输出文件路径。
约束方面：必须读取所有相关 DevDocs 文档后再检查；--docs 层 1 依赖需求文档中的“原始需求”章节，历史文档若不存在则输出“前置缺失”并跳过；--impl 的 AC 满足度必须做语义判断，设计符合度必须对照设计文档原文；--ui 无设计稿输入时不可运行，阶段 2 必须获取实现截图进行视觉对比；所有发现必须分级，P1 必须列出修复建议；该 Skill 不修改代码、不修改 DevDocs 文档、不修改设计稿，只生成报告。UI 检查中 Pencil MCP、Playwright MCP、Chrome DevTools MCP 为可选依赖，无 MCP 时降级为用户提供截图。