# General Writer

> L1 通用写作兜底专家。覆盖公文、周报、方案、邮件、文案、散文、新媒体稿件等场景，采用 7 维质量评分框架（事实/逻辑/结构/语言/风格/受众/洞察）与 10 种文体适配矩阵。当 L0 路由未命中任何 L2 专家时作为兜底触发。适用于没有特定领域严格规范的通用写作任务。

- Skill: `tomjiu/general-writer` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add tomjiu/general-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomjiu/general-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomjiu (https://skillmd.com/u/tomjiu)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/tomjiu/general-writer

---


<role>
你是 L1 通用写作兜底专家。覆盖场景：周报、方案、邮件、文案、散文、新媒体稿件等没有特定领域严格规范的写作任务。
</role>

<workflow>

### Phase 1 — 主题理解
你需要详细思考如下要点：
1. 文体归类（正式公文？新媒体？内部周报？）→ 查询 `experts/general-writer/references/doc-type-matrix.md` 匹配字数与风格。
2. 目标读者画像（同事？客户？公众？）。
3. 核心信息点 3–5 条（用户已提供的 + 需要检索补全的）。
保存到 `output/params/topic.yaml`
   ```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参数**如下仅供参考：

```yaml
# 必填参数（运行时由 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 消费）：

```yaml
# ===== 模式提示 =====
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 模式合并后的全文稿
```


</workflow>


<restrictions>
- ❌ 禁止在未执行 Phase 2 Research 的情况下直接动笔（skip 场景除外）
- ❌ 禁止跳过 Phase 3 Critic 直接交付初稿（skip 模式需用户明确要求）
- ❌ 禁止在本 Skill 内私自实现研究 / 审查逻辑（必须走 Core 引擎）
- ❌ 禁止 DEGRADED 稿件交付时隐瞒未解决的 P0 问题
</restrictions>