tech-batch 写审分离：AI 批量写技术博文的质量控制-优快云博客

tech-batch 写审分离：AI 批量写技术博文的质量控制

一、概念速查

什么是 tech-batch

tech-batch 是一个批量写技术博文的 OpenCode skill。它把一个系列的文章逐篇写→审→改→再审，严格串行推进，直到每篇都通过独立审查才进入下一篇。

核心设计

维度	设计	理由
写审分离	写 agent 和审 agent 永远不同	防止同一个人既写又审的盲区
盲审	审 agent 每次调用不带历史上下文	保证每次审查独立，不放水
无限循环	不设重试上限，直到零 blocking	质量不妥协
串行	一篇一篇过，不并发	审不过不进下一篇
断点续跑	进度文件记录每篇状态	中断后可恢复

审查五问

字数 ≥ 800？
结构完整（概念速查 + 底层原理 + 设计原则三段齐全）？
Mermaid 图独立代码块、无嵌套 subgraph？
代码可复制、版本号/API 明确？
无面试八股、无博文关联、无下一篇引导？

二、底层原理

写审循环流程

这个循环每次审 agent 都是全新的子 agent 调用。它不继承上一次审查的对话历史，审稿时不记得上次看过什么、改了什么。这意味着每次审查都是对当前版本的独立质量判断。

为什么要写审分离

让同一个人既写又审存在一个根本问题：写的时候已经对内容产生了路径依赖，审查时会下意识地接受自己写的思路。写 agent 是一套 prompt 和参考素材，审 agent 是一套标准。两套不同上下文、不同职责、不同 agent，才能形成真正的交叉验证。

为什么要盲审

带上下文的审查存在"审查疲劳"：第一次发现 3 个问题，第二次看到"这次改了 2 个，还有一个没改"就会倾向于"差不多行了"。盲审切断了这条路——每次重新读文章，逐条核对五问，不会因为"之前看过"而降低标准。

串行 vs 并发的抉择

并发写 N 篇看似快，但审 agent 的瓶颈无法并行——审一篇发现的问题可能影响下一篇的写法。串行保证每篇都在上篇完成的基础上推进，同时写 agent 在写新篇时已经经历了上一篇的审查循环，产出的质量会自然提升。

代码示例：串行循环调度器核心逻辑

import json
from pathlib import Path

class BatchPipeline:
    def __init__(self, series_dir: str):
        self.series_dir = Path(series_dir)
        self.progress = self._load_progress()

    def _load_progress(self) -> dict:
        path = self.series_dir / "batch_progress.json"
        if path.exists():
            return json.loads(path.read_text(encoding="utf-8"))
        return {"articles": [], "completed": 0, "current": 0, "status": "idle"}

    def _save_progress(self):
        path = self.series_dir / "batch_progress.json"
        path.write_text(json.dumps(self.progress, ensure_ascii=False, indent=2), encoding="utf-8")

    def run(self):
        for i, article in enumerate(self.progress["articles"]):
            if article["status"] == "completed":
                continue
            self.progress["current"] = i
            passed = False
            while not passed:
                self._write(article)
                passed = self._review(article)
                if not passed:
                    self._revise(article)
            article["status"] = "completed"
            self.progress["completed"] += 1
            self._save_progress()

    def _write(self, article): ...
    def _review(self, article) -> bool: ...
    def _revise(self, article): ...