publish-hatena

star 0

生成済みの日記記事を、はてなブログ AtomPub で下書き投稿し、--force で既存エントリを更新する

becky3 By becky3 schedule Updated 6/3/2026
play_arrow Run Skill in Manus View GitHub

name: publish-hatena description: 生成済みの日記記事を、はてなブログ AtomPub で下書き投稿し、--force で既存エントリを更新する user-invocable: true allowed-tools: Bash, Read argument-hint: "[YYYY-MM-DD] [--force]"

タスク

articles/hatena/ 配下の生成済み日記記事を、はてなブログの AtomPub エンドポイントへ送信する。POST（新規投稿）時は下書き（<app:draft>yes</app:draft>）として登録する。投稿成功時に articles/hatena/published.jsonl へ記録を追記する。

更新（PUT, --force）時は事前に GET で対象エントリの <app:control>/<app:draft> 値を取得し、同じ値を明示送信して既存の公開状態を保持する（はてな AtomPub 公式仕様では <app:draft> を省略すると公開扱いになるため、明示送信が必須）。下書き ↔ 公開の状態遷移は本スキルの対象外で、はてなブログの管理画面での手動操作とする。

仕様: aidlc-docs/plan-work/issue-42.md

引数

$ARGUMENTS の形式:

  • 引数なし: articles/hatena/ 配下のファイル名順で最新のファイルを対象とする
  • YYYY-MM-DD: ファイル名がこの日付で始まる記事を対象とする（1 日 1 記事前提のため、該当する唯一のファイルが選択される）
  • --force: published.jsonl から対象日付の edit_url を取得し、AtomPub PUT で既存エントリを上書き更新する。published.jsonl の該当行の title を最新タイトルに更新する（edit_url は既存値を保持、行追加はしない）
    • 対象日付のエントリが published.jsonl に未登録の場合はエラー停止（--force は更新専用のため、新規投稿には使えない）
    • 対象日付のエントリは登録されているが edit_url が null の場合もエラー停止。手動で edit_url を URL 文字列に書き換えてから再実行する
  • 上記の組み合わせ可（例: 2026-05-13 --force）

前提条件

以下が事前に整備されていること（オーナーによる初期設定）。未整備の場合はスクリプトがエラーで停止する。

項目 場所 内容
HATENA_ID リポジトリルートの .env はてなのユーザー名（公開情報）
HATENA_BLOG_ID リポジトリルートの .env ブログのホスト名（<subdomain>.hatenablog.com 形式、公開情報）
HATENA_API_KEY keyring（service="article-writer"） AtomPub 用 API キー（秘匿情報。ダッシュボード → 設定 → 詳細設定 → AtomPub の「APIキー」）
投稿先ブログの編集モード はてなブログの基本設定 Markdown に設定済み（運用前提。詳細は .claude/skills/write-hatena-diary/quality-guidelines.md「記法」を参照）

.env は .gitignore 済み。HATENA_API_KEY の値はオーナー手元のみで管理する秘匿情報で、本スキルから値を出力・記録しない。keyring 登録の具体コマンドは <<## エラーハンドリング一覧@self>> を参照。

処理手順

Phase 0: 環境セットアップ（worktree 対応）

.env はリポジトリルートに配置する必要があるが、git-worktree で作業中は worktree 側に .env が存在しない（.gitignore 対象のためチェックアウトされない）。

スクリプト実行前に以下を確認し、必要なら親リポからコピーする:

if [ ! -f .env ]; then
  # git worktree list --porcelain の "worktree <path>" 行を抽出（パスにスペースを含んでも安全）
  MAIN_REPO=$(git worktree list --porcelain | awk '/^worktree /{sub(/^worktree /,""); print; exit}')
  if [ -n "$MAIN_REPO" ] && [ -f "$MAIN_REPO/.env" ]; then
    cp "$MAIN_REPO/.env" .env
    echo "INFO: 親リポから .env をコピーしました: $MAIN_REPO/.env -> .env"
  fi
fi

実行される条件は カレントに .env が無い ことのみ。worktree 内では .env がチェックアウトされないため通常該当する。親リポで直接実行している場合は通常 .env が存在するため外側の if で弾かれて実質スキップされる。

カレントにも親リポにも .env がない場合は初期設定未整備のため、本セクション冒頭「前提条件」テーブルに従い .env を新規作成してから再実行する。

Phase 1: 引数パース

  1. $ARGUMENTS を空白で分割
  2. YYYY-MM-DD 形式のトークンがあれば DATE に格納
  3. --force があれば FORCE=1
  4. それ以外のトークンが残ればエラー停止

Phase 2: 投稿実行

scripts/publish_hatena.py を呼ぶ:

python scripts/publish_hatena.py [<DATE>] [--force]

スクリプトの責務:

  1. 対象記事の選択（DATE 指定時はファイル名前方一致、未指定時は最新）
  2. フロントマター（title / date / category）解析と本文取得
  3. 本文先頭の # <title> 行剥がし（はてなブログはエントリ title を別管理するため重複を避ける）
  4. 簡素記法ブロックを HTML に展開: scripts/convert_article_html.py の convert() を呼び、kuro-chan>> / nee-san>> / {{{bluesky ... }}} を対応 HTML へ変換する（記法仕様は .claude/skills/write-hatena-diary/balloon-html.md）。変換エラー時はスクリプト全体を停止
  5. published.jsonl から対象日付のエントリを検索し、登録状態（未登録 / 登録済みで edit_url が null / 登録済みで edit_url が URL 文字列）を判定する
  6. --force 分岐の確定:
    • --force なし & 対象日付が登録済み → 重複警告で停止
    • --force あり & 未登録 → エラー停止（更新対象なし）
    • --force あり & 登録済み・edit_url が null → エラー停止（手動書き換えの案内）
    • --force あり & 登録済み・edit_url が URL 文字列 → PUT を実行
    • --force なし & 未登録 → POST を実行
  7. .env から HATENA_ID / HATENA_BLOG_ID を取得
  8. keyring から HATENA_API_KEY を取得
  9. PUT (--force) 時のみ: 対象 edit_url に対して GET リクエスト を発行し、レスポンスの <app:control>/<app:draft> 値を抽出する。取得失敗（HTTP エラー / XML パース失敗 / 要素不在）時はエラー停止
  10. Atom Entry XML を組み立て:
    • <title> / <updated>（フロントマター date: を JST 0 時として ISO 8601 化、はてなブログ管理画面で公開予定日として表示される）
    • <content type="text/x-markdown">
    • <category term="...">
    • <app:control>/<app:draft> を 必ず明示送信 する。POST 時は yes（下書き）、PUT 時はステップ 9 で取得した値（公開状態を維持）。はてな AtomPub 公式仕様では <app:draft> 省略時は公開扱いになるため、状態維持には明示が必須
  11. Basic 認証でリクエスト送信
    • POST 時: https://blog.hatena.ne.jp/<HATENA_ID>/<HATENA_BLOG_ID>/atom/entry
    • PUT 時: 取得済みの edit_url
  12. POST 成功時の published.jsonl 追記:
    • レスポンスの <link rel="edit" href="..."/> を抽出し {"date": "<日付>", "title": "<title>", "edit_url": "<URL>"} 形式で 1 行 JSON を追記する
    • edit_url 抽出に失敗した場合: WARNING を出して "edit_url": null で追記する（次回 --force 前に手動書き換えが必要、終了コード 0）
    • 追記が I/O 失敗した場合: WARNING + 追記すべき 1 行を明示し終了コード 1（投稿自体は成功している点を明示）
  13. PUT 成功時は published.jsonl の該当行の title を最新タイトルに更新する（edit_url は既存値を保持、行追加はしない）
  14. URL を 2 種類画面表示する:
    • 編集ページ URL: レスポンスの <link rel="edit" href="..."/>（.../atom/entry/<entry_id>）の末尾 entry_id から https://blog.hatena.ne.jp/<HATENA_ID>/<HATENA_BLOG_ID>/edit?entry=<entry_id> を組み立てる。
      • 下書き状態でも所有者がアクセスできる唯一の URL。entry_id を抽出できない場合は表示しない
    • 公開 URL: フロントマター date: から https://<HATENA_BLOG_ID>/entry/YYYY/MM/DD/000000 を組み立てる（<updated> を JST 0 時で送るためこの形式になる）。公開されるまでは 404
    • <link rel="alternate" href="..."/> は 使用しない。POST 時点の作成時刻ベースの URL で、実際の公開 URL（<updated> ベース）と一致しないため

Phase 3: 結果報告

スクリプトの出力をそのままユーザーに見せる。成功時の典型出力（POST）:

📄 対象記事: articles/hatena/YYYY-MM-DD-diary.md
📤 POST 中 (title: ...)
✅ 下書き登録成功
  記事: articles/hatena/...
  Entry ID: tag:blog.hatena.ne.jp,...:entry-...
  編集ページ: https://blog.hatena.ne.jp/<HATENA_ID>/<HATENA_BLOG_ID>/edit?entry=<entry_id>
  公開URL: https://<HATENA_BLOG_ID>/entry/YYYY/MM/DD/000000
  published.jsonl に追記済み（edit_url 含む）
  管理画面: https://blog.hatena.ne.jp/<HATENA_ID>/<HATENA_BLOG_ID>/edit

成功時の典型出力（--force での PUT）:

📄 対象記事: articles/hatena/YYYY-MM-DD-diary.md
🔍 既存の draft 状態を取得中...
  現在の状態: 公開 ／ 下書き
🔄 PUT 中 (title: ...)
✅ 更新成功（公開状態を維持） ／ 更新成功（下書き状態を維持）    # GET で取得した状態に応じて表示が切り替わる
  記事: articles/hatena/...
  Entry ID: tag:blog.hatena.ne.jp,...:entry-...
  編集ページ: https://blog.hatena.ne.jp/<HATENA_ID>/<HATENA_BLOG_ID>/edit?entry=<entry_id>
  公開URL: https://<HATENA_BLOG_ID>/entry/YYYY/MM/DD/000000
  published.jsonl の title を最新タイトルに更新（edit_url は保持）
  管理画面: https://blog.hatena.ne.jp/<HATENA_ID>/<HATENA_BLOG_ID>/edit

エラー時はスクリプトの stderr 出力をそのまま見せ、再実行可否を判断する。

エラーハンドリング一覧

ケース 対応
.env が見つからない スクリプトがエラー表示 + 停止。.env 作成例を案内
.env に HATENA_ID または HATENA_BLOG_ID が未設定 スクリプトがエラー表示 + 停止
keyring に HATENA_API_KEY が未登録 スクリプトがエラー表示 + 停止。本スキルは値を扱えないため、オーナーが以下のコマンドで対話入力で登録する（シェル履歴に値を残さないため getpass を使用）。python -c "import keyring, getpass; keyring.set_password('article-writer', 'HATENA_API_KEY', getpass.getpass('API Key: '))"
対象記事ディレクトリが存在しない スクリプトがエラー表示 + 停止
引数日付に対応する記事がない スクリプトがエラー表示 + 停止
引数の日付形式が不正 スクリプトがエラー表示 + 停止
フロントマター（title / date）が未設定 スクリプトがエラー表示 + 停止
フロントマター date: が YYYY-MM-DD 形式でない スクリプトがエラー表示 + 停止（<updated> 組み立て前に検証する）
簡素記法ブロック（kuro-chan>> / nee-san>> / {{{bluesky ... }}}）の構文エラー（未閉鎖・必須キー欠落等） スクリプトがエラー表示 + 停止。エラーメッセージは行番号付き
同じ日付のエントリが既に published.jsonl に存在（重複検知、--force なし） スクリプトが警告 + 停止。再投稿が妥当なら --force で再実行する
--force 指定だが対象日付のエントリが published.jsonl に未登録 スクリプトがエラー停止。--force は更新専用のため、新規投稿時は --force を外して再実行する
--force 指定だが対象日付のエントリに edit_url が null スクリプトがエラー停止 + 手動書き換えの手順を案内。はてなブログ管理画面から AtomPub edit URL を取得し、published.jsonl の該当行の edit_url を null から URL 文字列に書き換えてから再実行する
HTTP 401 / 403 API キーまたは権限不足。keyring 登録値とブログオーナー権限を確認
HTTP 404（PUT 時） 指定 edit_url のエントリがはてな側に存在しない（手動削除済み等）。published.jsonl の該当行の edit_url を null に書き換え、通常 POST で再投稿する
HTTP 5xx / タイムアウト リトライは実装しない。少し時間を置いてから再実行する
PUT 前 GET の失敗（HTTP エラー / ネットワーク失敗 / XML パース失敗 / <app:draft> 要素不在） スクリプトがエラー表示 + 停止。PUT 自体は実行しない（draft 状態を確定できないため意図しない公開を起こさない）。原因を解消してから再実行する
ネットワーク失敗（DNS / TCP / URLError / TimeoutError） スクリプトは HTTP -1 として扱い、❌ ネットワークエラー: ... を表示。少し時間を置いてから再実行する
POST 成功後の published.jsonl 追記が I/O 失敗 スクリプトが Entry ID・公開閲覧 URL を表示しつつ WARNING + 追記すべき 1 行を明示。終了コード 1。投稿自体は成功しているため、明示された 1 行を published.jsonl に追記して整合を回復する
POST 成功したがレスポンスから edit_url 抽出に失敗 スクリプトが WARNING を出し、"edit_url": null で published.jsonl に追記する（終了コード 0）。次回 --force 前に管理画面から AtomPub edit URL を確認して URL 文字列に書き換える必要がある

注意事項

  • 本スキルは 下書きの登録（POST）と既存エントリの更新（--force 指定時の PUT） に対応する。PUT 時は事前に GET で取得した <app:draft> 値をそのまま明示送信するため、公開状態を変更しない（公開済み記事は公開のまま、下書き記事は下書きのまま）。下書き ↔ 公開の状態遷移はオーナーが管理画面で行う
  • 既知制約 (TOCTOU): --force の PUT 実行中（GET と PUT の間）に、オーナーがはてなブログ管理画面で対象記事の下書き/公開状態を手動切替すると、PUT は古い値を送ってしまい意図せず状態を変える可能性がある。--force 実行中は管理画面操作を避けること。再現は実運用上ほぼ起きないが、既知の制約として明示する
  • 削除（DELETE）は本スキルではサポートしない。削除は /delete-hatena スキル で実施する
  • --force での PUT 対象は published.jsonl の edit_url が URL 文字列のエントリに限る。edit_url が null のエントリ（別環境投稿等で記録された場合）に --force を実行するとエラー停止するため、必要に応じて手動で edit_url を URL 文字列に書き換える
  • リトライは実装しない。一時的失敗時は少し時間を置いてから再実行する
  • published.jsonl に追記する日付は 記事フロントマターの date:（日記対象日）。1 日 1 記事を前提に、同じ日付のエントリがあれば重複と判定する
  • 本スキルは API キー値・認証情報を出力・記録しない（~/.claude/rules/invariants.md 「秘匿情報の出力禁止」遵守）

関連

  • scripts/publish_hatena.py: 投稿スクリプト本体
  • scripts/convert_article_html.py: 簡素記法 → HTML 変換（本スクリプトが投稿前に呼ぶ）
  • .claude/skills/write-hatena-diary/SKILL.md: 日記記事の生成スキル
  • .claude/skills/write-hatena-diary/template-diary.md: 記事テンプレート（フロントマター・固定 HTML・参照データ）
  • .claude/skills/write-hatena-diary/quality-guidelines.md: 記法ポリシー含む品質ルール SSoT
  • .claude/skills/write-hatena-diary/balloon-html.md: 簡素記法仕様（吹き出し・Bluesky）
  • articles/hatena/published.jsonl: 公開済み記録（本スキルが追記する）
Install via CLI
npx skills add https://github.com/becky3/article-writer --skill publish-hatena
Repository Details
star Stars 0
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator
becky3
becky3 Explore all skills →