---
url: /pdf-agent-stack/ja/use-cases/publish-pipeline.md
description: >-
  品質ゲート付き納品パイプライン — write → read-back → verify のループを、請求書デモ（PDF/A-3b + PDF/UA-1 を
  veraPDF 権威判定で通過）の実走ログで追う
---

# 納品パイプライン

## シナリオ

「PDF を作って納品する」を、**作りっぱなしにしません**。pdf-writer で書き、pdf-reader で読み戻して
意図どおりかを観測し、pdf-verify（veraPDF）で機械採点してから納品します。合否は verify のみが下し、
writer の正常終了は「要求どおり出力された」の証拠にしません。

書き込み列（`FONT_REQUIRED` → fontPath 再試行）は **2026-08-11** の Publish Report です。成果物 `publish-demo-invoice.pdf` の読み戻しとゲートは **2026-09-04** に取り直しました（pdf-writer-mcp v0.21.0 / pdf-reader-mcp v0.15.0 / pdf-verify-mcp v0.26.0 / veraPDF 1.30.0）。

## 登場 MCP / Skill

| 役者 | 役割 |
|---|---|
| [pdf-publish Skill](/ja/skills/pdf-publish) | 呼び出し順の決定・warnings の転記・Publish Report |
| [pdf-writer](/ja/mcp/pdf-writer)（必須） | 生成・添付・器付け（`ensure_pdfa`） |
| [pdf-reader](/ja/mcp/pdf-reader)（推奨） | 読み戻し観測（合否は言わない） |
| [pdf-verify](/ja/mcp/pdf-verify)（conformance 水準で必須） | `validate_conformance`（veraPDF 委譲） |

## シーケンス図

```mermaid
sequenceDiagram
  actor U as 利用者
  participant S as pdf-publish Skill
  participant W as pdf-writer
  participant R as pdf-reader
  participant V as pdf-verify (veraPDF)

  U->>S: 電帳法対応の請求書 PDF を納品まで
  S->>W: create_markdown_pdf(tagged, lang: ja)
  W-->>S: FONT_REQUIRED（構造化エラー）
  S->>W: 同上 + fontPath（next_actions に従い再試行）
  S->>W: attach_file(CSV, relationship: Data)
  S->>W: ensure_pdfa(pdfa-3b) — 必ず最後
  W-->>S: 成功 + warning「CLAIMS PDF/A-3b, NOT checked」
  S->>R: read_text / extract_structured_text / inspect_fonts / inspect_structure
  R-->>S: 観測（入力との照合・AF/Names の実在確認）
  S->>V: validate_conformance(pdfa-3b) / (pdfua-1)
  V-->>S: veraPDF COMPLIANT 146/146 / 106/106
  S-->>U: 納品 + Publish Report（不合格なら修正ループ ≤ 3 回）
```

## プロンプト例

* 「この請求書データを電帳法対応の PDF にして。明細の CSV も同梱、検証まで通して納品して」
* 「このレポートをアクセシブルな PDF（PDF/UA）で。品質保証付きで」
* 「下書きでいいから PDF に」（→ 水準 `none`。ゲートなしと明記される）

## 実測例 — 請求書デモの Publish Report 要旨

| Phase | 結果 |
|---|---|
| 生成（2026-08-11） | `FONT_REQUIRED` → 構造化エラーの `next_actions` に従い fontPath 指定で復帰。attach（Data）→ ensure_pdfa（最後） |
| 読み戻し（2026-09-04） | `inspect_tags`: タグ付き、H1×1、TH 5 / TD 15 / TR 4。catalog に StructTreeRoot・MarkInfo・Lang・Names・AF・OutputIntents |
| 品質ゲート（2026-09-04） | **veraPDF 1.30.0 が PDF/A-3b COMPLIANT（146/146）・PDF/UA-1 COMPLIANT（106/106）と判定** |
| 修正ループ | 0 回 |

::: details 呼び出し — 成果物のゲート（取り直し）

* 実測: pdf-verify-mcp v0.26.0、veraPDF 1.30.0
* 標本: `docs/specimens/publish-demo-invoice.pdf`

```jsonc
{
  "file_path": "/absolute/path/to/docs/specimens/publish-demo-invoice.pdf",
  "flavour": "pdfa-3b",
  "response_format": "json"
}
```

```jsonc
{
  "engine": "verapdf",
  "flavour": "PDF/A-3b",
  "compliant": true,
  "checkedRules": 146,
  "passedRules": 146,
  "failedRules": 0
}
```

`flavour: "pdfua-1"` では `checkedRules` / `passedRules` が 106、`compliant: true` です。
:::

`ensure_pdfa` は成功時にも必ず warning を返します（「CLAIMS … NOT checked」）。これは設計であり、
**ラベルを書いた瞬間に検証が省略不能になる**ことを機械側が言い続けています。生成列そのものは 2026-08-11 のログのままです（日本語フォントの `.otf` がこの環境に無く、書き込みは再実行していません）。

## 結果の読み方

* 合否の言い方は規範の層で変わります: PDF/A は「**veraPDF が COMPLIANT と判定**」（T2 — ISO 19005 準拠とは書きません）、
  PDF/UA-1 は ISO 14289-1 の条文を引けます（T1）
* `engine: native` の `compliant: null` は「検査サブセットで違反なし」であって適合ではありません —
  conformance 水準の判定は保留し veraPDF を入れてください
* 機械検証は alt テキストや読み順の**意味的**な適切さまでは判定できません。人手レビューの残る範囲を
  Report に明記してください
* 修正ループは上限 3 回・同じ違反が 2 回続いたら即人手へ（[打ち切り条件](/ja/skills/pdf-publish#ループ打ち切り条件)）

## 別ホストでの再走（2026-09-15、Grok Build 1.0.30）

pdf-writer-mcp v0.21.0 / pdf-verify-mcp v0.26.0 / veraPDF 1.30.0 で、日本語の請求書を write → 読み戻し → verify まで回しました。PDF/A-3b は veraPDF が COMPLIANT（146/146）、PDF/UA-1 は 106/106 です。観察が 2 つあります。Claude Code の `settings.json` に書いた `PDF_WRITER_FONT` は Grok Build が起動した writer プロセスには渡らず、呼び出しの `fontPath` で回避しました（→ [導入手順](/ja/guide/getting-started)）。`create_markdown_pdf`（tagged）は title と本文見出しが同じ文字列のとき H1 が 2 つできます。報告書: [UC02.md](https://github.com/shuji-bonji/pdf-agent-stack/blob/main/eval/hosts/grok-build/reports/UC02.md)