【T-01】GitHub Actions × WordPress：Markdown自動投稿システムの構築ガイド

┌─────────────────────────┐
│  GitHub リポジトリ        │
│                         │
│  stories/               │
│  ├─ aquaria/            │  (水の惑星シリーズ)
│  ├─ solaris/            │  (音楽宇宙シリーズ)
│  ├─ ragteller/          │  (火星コロニーシリーズ)
│  └─ tech/               │  (技術記事)
└────────┬────────────────┘
         │ git push
         ▼
┌─────────────────────────┐
│  GitHub Actions          │
│                         │
│  Job 1: Validate        │  (バリデーション + Dry-run)
│  Job 2: Publish         │  (本番投稿 / mainのみ)
└────────┬────────────────┘
         │ REST API
         ▼
┌─────────────────────────┐
│  WordPress サイト         │
│                         │
│  カテゴリ・タグ自動設定    │
│  新規作成 or 更新判定     │
│  公開 / 予約投稿          │
└─────────────────────────┘

# lib/wp_client.py (設計パターン抜粋)
def _request(self, method: str, path: str, **kwargs) -> requests.Response:
    # Dry-run時は書き込み系メソッドをモックに差し替え
    if self.config.dry_run and method.upper() in ('POST', 'PUT', 'PATCH', 'DELETE'):
        self.logger.info("DRY RUN: %s %s", method.upper(), path)
        return self._create_mock_response()

    # 実際のAPIリクエスト
    url = self.config.endpoint(path)
    return self.session.request(method, url, auth=self.config.auth_tuple(), **kwargs)

処理フロー:

1. Frontmatter解析
   story.md → メタデータ (title, slug, categories, tags, status)
                + 本文 (Markdown)

2. Markdown → HTML変換
   **太字** → <strong>太字</strong>
   ```code``` → <pre><code>code</code></pre>

3. 同期判定
   slug "my-article" でWordPressを検索
     │
     ├─ 見つかった → 既存記事を「更新」(PUT)
     │
     └─ 見つからない → 新規記事を「作成」(POST)

---
title: "記事のタイトル"
slug: "url-friendly-name"
categories: ["Tech"]
tags: ["WordPress", "自動化"]
status: "publish"
date: "2025-01-11"
excerpt: "記事の要約（100文字程度）"
---

# ここから本文

本文をMarkdown記法で自由に書けます。
**太字**や`コード`も使えます。

# .github/workflows/wp-sync.yaml (構成概要)
jobs:
  validate:
    name: Validate and Dry-Run
    # 全ブランチで実行。バリデーションとドライランを行う

  publish:
    name: Publish to WordPress
    needs: validate
    if: github.ref == 'refs/heads/main'  # mainブランチのみ
    environment: production              # GitHub環境保護ルールを適用
    env:
      WP_APP_PASSWORD: ${{ secrets.WP_APP_PASSWORD }}

• ✅ Application Password: ログイン用パスワードではなく、WordPress専用の認証トークンを使用
• ✅ Secrets管理: パスワードやURLはコードに含めず、GitHub Secretsで厳重に管理
• ✅ 環境保護ルール: 本番投稿前にGitHub上で「手動承認」を必須にすることが可能
• ✅ ブランチ保護: mainブランチへのpushのみ本番投稿を実行

ゲート1: ブランチ保護
  └─ mainブランチへのpushのみ投稿を実行

ゲート2: 環境保護
  └─ 本番環境への投稿には手動承認が必要

ゲート3: バリデーション
  └─ 6層の検証をパスした記事のみ投稿可能
     (スキーマ / 日付 / slug衝突 / 類似度 / HTML / コンテンツ)

1回目: カテゴリ「Tech」のID → API呼び出し → 結果をキャッシュ
2回目: カテゴリ「Tech」のID → キャッシュから即座に取得（API不要）

• 📊 validation-logs: 構文チェック・バリデーションの結果
• 📊 publish-logs: WordPressから返却された投稿IDなどの詳細
• 処理時間やエラーの詳細も自動記録

1. 🚀 モジュラー設計 → 機能追加や修正が容易
2. 🛡️ 多層防御 → バリデーションとDry-runによるミス防止
3. ⚡ 自動化パイプライン → 書いてpushするだけで公開
4. ✅ 拡張性 → 画像アップロードやマルチサイト対応も視野に
5. 📊 可観測性 → ログとアーティファクトで状況把握