Feishu Doc Verifier

Feishu Wiki 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-wiki-orchestrator (parent) instead
• 需要验证云盘文档 → use feishu-doc-orchestrator/feishu-doc-verifier instead

Typical triggers:

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

Workflow

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

2. 约束 (Constrain) 使用 Playwright 持久化上下文启动浏览器，确保登录态有效。验证方式必须不同于生成路径（API 创建 → 浏览器验证）。知识库 URL 格式为 https://xxx.feishu.cn/wiki/xxx。

3. 执行 (Execute)

4. 启动 Playwright 浏览器

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

6. 检查页面标题和内容

7. 确认文档在知识库节点树中的位置

8. 截图保存

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/wiki/U2wNd2rMkot6fzxr67ScN7hJn7c",
  "page_loaded": true,
  "page_title": "文档标题",
  "wiki_location_correct": true,
  "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-wiki-orchestrator (parent) — 主编排技能，调用本子技能
• feishu-doc — API 方式读取文档内容
• feishu-logger — 下游：汇总验证结果到日志

About UniqueClub

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