uae-docs-pipeline

name	uae-docs-pipeline
description	UAE 落地资料生产线：从 Notion 看板驱动，产出面向中国企业客户的阿联酋落地操作指南。USE WHEN 写阿联酋公司服务文档、巡检文档管线、文档规划、QA、场景审查、反馈学习。

UAE 落地资料生产线

概述

半自动化文档生产管线。原 docs-director / ops-director / delivery-director 三个中间层 director 已于 Round 2 Workstream B 删除，其路由、运维日报、文档 规划能力内嵌到本 SKILL；具体执行由下属 workflow + content-writer / content-editor / feedback-extractor / quality-assurance / scenario-reviewer 五个生产角色承担。

子 workflow 路由

手动或 cron 触发时，按意图分发到对应 workflow：

意图	Workflow / 文件	触发方式
管线巡检	agents/uae-docs-pipeline/workflows/pipeline-check.md	cron / 手动
写作（按 doc_type）	agents/uae-docs-pipeline/workflows/write-<type>.md（guide/case-study/faq/marketing/opinion/whitepaper）	pipeline-check 分发 / 手动
QA 质检（按 doc_type）	agents/uae-docs-pipeline/workflows/qa-<type>.md	pipeline-check 分发 / 手动
场景审查（按 doc_type）	agents/uae-docs-pipeline/workflows/review-<type>.md	pipeline-check 分发 / 手动
反馈学习	agents/uae-docs-pipeline/workflows/learn.md	pipeline-check 分发 / 手动
品牌格式化	agents/uae-docs-pipeline/workflows/finalize.md	review 子步骤 / 手动重跑
状态看板	agents/uae-docs-pipeline/workflows/status.md	手动
任务发布	agents/uae-docs-pipeline/workflows/plan.md	手动
日报 / 运维巡检	本 SKILL.md ### 运维域：日报与巡检	cron / 手动
文档规划 / Writing Brief	本 SKILL.md ### 交付域：文档规划与 Writing Brief	手动

执行规则

1. 读取下属 workflow 后完整执行，不截断不跳步
2. 失败重试 1 次，仍失败则记录后继续处理下一条
3. 单条异常不中断管线，巡检日报汇总当日异常
4. Notion 字段 SSOT：状态字段由 workflow 写回，SKILL 不缓存状态

生产角色

角色	Skill 文件	职责	状态
content-writer	skills/content-writer/SKILL.md	起草写作（status=Planned）	active
content-editor	skills/content-editor/SKILL.md	修订编辑（status=Revising）	active
feedback-extractor	skills/feedback-extractor/SKILL.md	学习提炼（strategy 归纳）	active
quality-assurance	skills/quality-assurance/SKILL.md	10 维度 QA 评分	active
scenario-reviewer	skills/scenario-reviewer/SKILL.md	50+ 场景审查	active
content-agent	skills/content-agent/SKILL.md	已废弃 — 2026-05-08 拆分为 content-writer / content-editor / feedback-extractor 三 SKILL	redirect（保留兼容历史 caller）

运维域：日报与巡检

原 ops-director 内容内嵌于此。日报/巡检只汇总已存在数据，不在日报里顺手 做额外构建。

• agents/uae-docs-pipeline/prompts/cron-doc-pipeline.md — 定时触发管线 巡检（每日 10:00 Dubai），读取 Notion 看板状态后按 pipeline-check.md 分发 write / qa / review / learn
• agents/uae-docs-pipeline/prompts/cron-daily-report.md — 定时触发日报 （每日 18:00 Dubai），汇总当日写作 / QA / review 进展 + 阻塞点 + 异常
• 手动巡检入口：直接读取 workflows/pipeline-check.md + workflows/status.md 两份 workflow 并执行
• 异常处理原则：单条失败不中断整条管线，记录后继续，日报聚合汇报

交付域：文档规划与 Writing Brief

原 delivery-director 能力内嵌于此。手动触发，不由定时任务调度。

启动流程：

1. 读取品牌规范：brand guideline/INDEX.md，重点读取主规范 v2.6（受众画像章节） 和 MIRISE_一票否决清单_v1.0.md
2. 读取知识库索引：knowledge/kb-index.md
3. 读取 Notion schema：agents/uae-docs-pipeline/context/notion-schema.md
4. 查询当前看板全量状态：

   "$MIRISE_BUN_BIN" "$MIRISE_WORKSPACE/scripts/shared/mirise-cli.ts" docs query-docs --status all --limit 100
   

文档清单规划视角（从中国企业落地实操角度覆盖全生命周期）：

• 总览：决策指南（主陆 vs 自贸区、实体类型、股东结构）
• 注册：每个自贸区/酋长国独立文件，个人/企业股东分开
• 签证：每种签证类型独立文件
• 公认证：按文件类型/用途分
• 银行：每家银行独立文件 + 总览对比
• 合规：企业税、VAT、年审、ESR、UBO

规划时思考：一个中国企业负责人在阿联酋落地的每一步会需要查阅什么资料？ 有没有遗漏的场景？

Writing Brief 模板（每篇文档必须包含）：

## Writing Brief: [文档名称]

### 目标
本文档帮助 [目标读者] 了解/完成 [具体事项]

### 受众
- 阅读层级：决策层 / 操作层 / 两者兼顾
- 出海阶段：考虑出海 / 已在中东

### 范围
必须覆盖的内容点：
1. [具体内容点]
2. [具体内容点]

### 知识库参考路径
- [对应的 knowledge/ 路径]

### 关键数据项
需要包含的具体费用/配额/时间数据：
- [数据项 1]
- [数据项 2]

### 特别要求
- [如有]

创建 Notion 任务：通过 Notion connector 创建任务卡片，字段按 agents/uae-docs-pipeline/context/notion-schema.md 填写。

Brief 完整性 pre-create gate（仅卡新建，不阻塞历史 brief）： 创建 Notion 任务前必须跑 check-brief-completeness.ts，校验 brief 是否 hint 了三类 doc-type-level mandatory 内容：lifecycle / failure-path / boundary。 与 phase-3 §M1 的 methodology mandatory sections 对齐 —— brief 不带这三类 hint，下游 claim-tree-writer 兜底生成会缺料，QA 结构完整度直接掉档。

"$MIRISE_BUN_BIN" agents/uae-docs-pipeline/scripts/check-brief-completeness.ts \
  --brief <brief.json> --doc-type guide --mode=hard

--mode=hard 缺任一类即 exit 1；新建被阻断，按 stderr hints 补 brief 后重跑。--mode=soft 仅做审计（exit 0 + JSON 报告），用于回顾既有 brief 不阻塞历史任务。

输出要求：

• 文档清单需与 Boss 确认后再创建 Notion 任务
• Brief 要具体到"需要包含哪些数据项"，不能泛泛说"介绍费用"
• Brief 必须包含 lifecycle / failure-path / boundary 三类内容（见上方 gate）
• 优先级按 P0/P1/P2 分批，P0 不超过 10 篇

工具纪律

• Notion 读取: MCP 工具
• Notion 写入: 使用 Notion MCP 工具或对应 agent 专用写入脚本；不要直接调用 shared library notion-write-pipeline.ts
• Google Doc 创建: "$MIRISE_BUN_BIN" "$MIRISE_WORKSPACE/scripts/shared/mirise-cli.ts" docs create-branded-doc
• Google Doc 读取: google_drive_fetch MCP 工具
• Email 通知: "$MIRISE_BUN_BIN" "$MIRISE_WORKSPACE/scripts/shared/mirise-cli.ts" shared send-gmail
• 禁止: 任何浏览器/Chrome 相关工具

关键资源

• 品牌规范: brand guideline/INDEX.md
• 知识库: knowledge/（operations / structured / raw-pdf）
• 外部系统 ID: config/services.yaml
• 文档标准: agents/uae-docs-pipeline/context/doc-standards.md
• 写作策略: agents/uae-docs-pipeline/context/writing-strategy.md（自进化）
• 质量规则: agents/uae-docs-pipeline/context/quality-rules.md