General Writer

Phase 1 — 主题理解

你需要详细思考如下要点：

1. 文体归类（正式公文？新媒体？内部周报？）→ 查询 experts/general-writer/references/doc-type-matrix.md 匹配字数与风格。
2. 目标读者画像（同事？客户？公众？）。
3. 核心信息点 3–5 条（用户已提供的 + 需要检索补全的）。 保存到 output/params/topic.yaml

   detected_doc_type: "工作周报"
   target_length: 1000
   target_tone: "第一人称，正式度★★★☆☆"
   

Phase 2 — Research（广度优先）

如果判断完全不需要研究时（纯格式化、纯模板填空），直接跳过，不需要传空参数；否则任何先充分了解再动笔"的阶段都不能跳过本阶段，典型场景包括：

• 写作前的素材准备
• 大纲生成前的行业背景摸底
• 针对某章节的信息缺口补充 你需要先参考参数字典 <plugin_root>/core/engines/deep-research/README.md 生成驱动引擎的参数，保存到 output/params/deep-research.yaml。生成参数文件后，再读取 <plugin_root>/core/engines/deep-research/engine.md 执行 6 步状态机，产出信息库快照到 snapshot_path。

默认deepredearch参数如下仅供参考：

# 必填参数（运行时由 Phase 1 结果填入）
topic: "<由 Phase 1 主题理解结果填入，一句话描述>"
tools: ["web_search"]          # L1 默认仅用网络检索

# 可选参数（已为 L1 通用写作配置默认值）
scope: "web"                   # 广度优先，可上网检索
max_loops: 2                   # 通用写作不需要过深研究
min_facts_required: 5          # 累计结构化事实数 ≥ 5
gap_check_strict: "relaxed"    # 宽松模式：Q1-Q4 必须通过，Q5-Q6 可容忍
search_dimensions:             # 必搜维度，默认通用两维
  - "数据"
  - "趋势"
tier_priority: []              # L1 不限定权威源优先级
snapshot_path: "output/research/{topic}_research.md"

Phase 3 — Writing（纯写作 + 输出 critic_config）

Step 3.0 — 生成 critic_config

根据 Phase 1 产出的 output/params/topic.yaml，生成 critic_config 声明（由 doc-writer 消费）：

# ===== 模式提示 =====
critic_mode_hint: "once"        # L1 默认 once；target_length ≥ 3000 时建议 per-section
force_mode: null                # L1 不强制，允许 skip

# ===== 评分标准 =====
rubrics_files:
  - "experts/general-writer/references/quality-framework.md"
  - "experts/general-writer/references/doc-type-matrix.md"
pass_score: 75
max_loops: 2

# ===== per-section 模式参数 =====
section_params:
  scope: "section"
  min_issues: 1
  min_instructions: 2

# ===== full 模式参数 =====
full_params:
  scope: "full"
  min_issues: 2
  min_instructions: 3

# ===== revision 模式参数 =====
revision_params:
  scope: "revision"
  min_issues: 1
  min_instructions: 1

模式决策参考（doc-writer 根据此 hint + 文档特征最终决定）：

if 用户明确要求不审 → skip（L1 允许）
elif target_length ≤ 1500 → once
elif detected_doc_type ∈ {小说, 调研报告, 方案, 年度总结, 长篇专题} → per-section
else → once

Step 3.1 — 执行写作

根据 critic_mode_hint 的预期，选择写作策略：

预期 once 模式（短文）

1. 生成全文 draft → 落盘 output/draft/{title}_v0.md

预期 per-section 模式（长文）

1. 生成大纲（章节清单）→ 落盘 output/draft/{title}_outline.md
2. 对每个章节 i:
   a. 生成章节 i 的 draft → 落盘 output/draft/{title}_ch{i}_v0.md
3. 合并全文 → 落盘 output/draft/{title}_merged_v0.md

预期 skip 模式

1. 直接生成全文 draft → 落盘 output/draft/{title}_v0.md

Step 3.2 — 返回产物

将 draft + critic_config 一起返回给 doc-writer：

本阶段的完整产物清单（落盘到 output/）：

output/
├── params/
│   ├── topic.yaml              # Phase 1 产出
│   ├── deep-research.yaml      # Phase 2 产出
│   └── critic_config.yaml      # 本阶段产出（critic 声明）
├── research/
│   └── {topic}_research.md     # Phase 2 产出
└── draft/
    ├── {title}_outline.md      # per-section 模式才有
    ├── {title}_ch{i}_v0.md     # per-section 模式的章节稿
    ├── {title}_v0.md           # once/skip 模式的全文稿
    └── {title}_merged_v0.md    # per-section 模式合并后的全文稿