# Feishu Doc Verifier

> 知识库文档验证子技能 / Feishu wiki document verifier sub-skill. 使用 Playwright 验证飞书知识库文档是否创建成功并可正常访问，截图留证。 Use when: "验证知识库文档", "verify wiki document", "知识库可访问性检查", "wiki accessibility check", "Playwright验证知识库", "playwright wiki verification", "知识库文档截图", "wiki document screenshot". 内部组件，由 feishu-wiki-orchestrator 编排调用，使用不同于生成路径的方式回读验证。Cross-references: feishu-wiki-orchestrator, feishu-doc, feishu-logger. Built by UniqueClub 🌐 https://uniqueclub.ai

- Skill: `wulaosiji/feishu-doc-verifier-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add wulaosiji/feishu-doc-verifier-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wulaosiji/feishu-doc-verifier-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: wulaosiji (https://skillmd.com/u/wulaosiji)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wulaosiji/feishu-doc-verifier-2

---


# 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)**
1. 启动 Playwright 浏览器
2. 导航到知识库文档 URL，等待页面加载
3. 检查页面标题和内容
4. 确认文档在知识库节点树中的位置
5. 截图保存

```bash
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

```json
{
  "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