Feishu Doc Verifier

Feishu Document Verifier (Sub-skill)

使用 Playwright 访问飞书文档，验证文档是否创建成功并可正常访问，截图留证。内部组件。

When to Use

Use this skill when:

• 需要验证新创建的飞书文档是否可正常访问时
• 需要通过浏览器截图确认文档内容时
• 需要在文档创建流程末尾做最终验证时

Do NOT use this skill if:

• 需要读取文档内容（API 方式）→ use feishu-doc instead
• 需要创建文档 → use feishu-doc-orchestrator (parent) instead
• 需要记录日志 → use feishu-logger instead

Typical triggers:

• 「验证文档是否创建成功」「检查文档可访问性」
• "verify feishu doc", "check document accessibility"

Workflow

1. 探查 (Probe) 从 doc_info.json 加载文档 ID 和 URL。

2. 约束 (Constrain) 使用 Playwright 持久化上下文启动浏览器，确保登录态有效。验证方式必须不同于生成路径（API 创建 → 浏览器验证）。

3. 执行 (Execute)

4. 启动 Playwright 浏览器

5. 导航到文档 URL，等待页面加载

6. 检查页面标题和内容

7. 截图保存

python scripts/doc_verifier.py workflow/step2_create/doc_info.json output

4. 验证 (Verify) 确认 page_loaded 为 true，page_title 与预期标题匹配，截图文件已生成。

5. 交付 (Deliver) 保存验证结果到 output/verify_result.json。

Output

{
  "success": true,
  "document_id": "U2wNd2rMkot6fzxr67ScN7hJn7c",
  "document_url": "https://feishu.cn/docx/U2wNd2rMkot6fzxr67ScN7hJn7c",
  "page_loaded": true,
  "page_title": "文档标题",
  "screenshot": "output/screenshot.png",
  "verified_at": "2026-01-22T10:40:00"
}

Guardrails

Anti-patterns

• NEVER 使用 API 方式验证（与生成路径相同，无法发现浏览器端问题）
• Do NOT 跳过截图步骤（截图是验证的重要证据）
• Do NOT 独立使用本子技能——应由父技能编排

Constraints

• 需要 Playwright 和浏览器驱动已安装
• 使用持久化上下文以保持飞书登录态
• 输出给 feishu-logger 汇总记录

Related Skills

• feishu-doc-orchestrator (parent) — 主编排技能，调用本子技能
• feishu-doc — API 方式读取文档内容
• feishu-logger — 下游：汇总验证结果到日志

About UniqueClub

Part of the UniqueClub toolkit. 🌐 https://uniqueclub.ai