1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

ClaudeとGitHub Actionsで、Qiita記事を週1で自動下書き→レビュー→公開する仕組みを作った

1
Last updated at Posted at 2026-10-23

はじめに

「アウトプットを習慣にしたいけど、毎週ゼロから記事を書くのは続かない」という悩みから、Qiita の記事を週1で自動的に下書きし、自分が確認してから公開する仕組み を作りました。

全自動で公開するのではなく、最後の判断(マージ)は必ず人がやる のがポイントです。

全体の流れ

毎週月曜の朝
  └─ Claude の定期タスクが、ネタ帳(topics.txt)の一番上から下書きを書く
       └─ GitHub に Pull Request を作る
            └─ 自分が読んで、体験やスクショを追記してマージ
                 └─ GitHub Actions が Qiita に公開
役割 使ったもの
記事の管理 GitHub リポジトリ(Markdown)
公開 Qiita CLI の公式 GitHub Action
下書きの作成 Claude の定期実行タスク
レビュー Pull Request

リポジトリの構成

.github/workflows/publish.yml  … main にマージされたら Qiita に公開
public/                        … 記事の Markdown
topics.txt                     … ネタ帳(上から順に使われる)
topics-done.txt                … 使い終わったネタ
style.md                       … 文体・構成のルール
qiita.config.json              … Qiita CLI の設定

1. 公開部分:Qiita CLI の公式 Action

Qiita CLI には、GitHub で記事を管理するための公式 Action が用意されています。

name: Publish articles

on:
  push:
    branches:
      - main
  workflow_dispatch:

permissions:
  contents: write

jobs:
  publish_articles:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: increments/qiita-cli/actions/publish@v1
        with:
          qiita-token: ${{ secrets.QIITA_TOKEN }}
          root: "."

main に push されるたびに public/ の記事が Qiita に反映されます。新しく公開した記事には Qiita 側の id が付くので、Action がそれをリポジトリに書き戻します(そのために contents: write が必要です)。

記事ファイルの先頭には、Qiita CLI 形式の Front Matter を付けます。

---
title: '記事タイトル'
tags:
  - 'タグ'
private: false
updated_at: ''
id: null
organization_url_name: null
slide: false
ignorePublish: false
---

2. 下書き部分:ネタ帳 + Claude の定期タスク

ネタ帳は1行1ネタのテキストファイルです。

タイトル案 | repo:リポジトリ名 | メモ

repo: を書いておくと、Claude がそのリポジトリの実際のコードを読んでから記事を書きます。
実際には書かれていない機能を「作った」ことにしないよう、コードに書いてあることだけを根拠にする ルールを style.md に書いています。

Claude には毎週次のことを頼んでいます。

  1. topics.txt の一番上のネタを取り出す
  2. 必要ならリポジトリのコードや公式ドキュメントを読んで、下書きを書く
  3. 自信がない箇所は <!-- TODO: 要確認 -->、自分の体験が必要な箇所は <!-- TODO: 自分の体験を追記 --> を入れる
  4. ブランチを切って Pull Request を作る(main には直接 push しない)

3. レビュー:Pull Request で確認してからマージ

届いた PR には、次のチェックリストを付けています。

- [ ] 内容・コードが正しいか確認した
- [ ] TODO箇所に自分の体験・スクショ・公開URLを追記した
- [ ] タグを確認した

マージすれば公開、出したくなければ Close するだけです。

気をつけたこと

トークンは Secrets に置く

Qiita のアクセストークンは、リポジトリの Actions Secrets に QIITA_TOKEN として登録しています。コードや記事にトークンを書くことはありません。
トークンのスコープは read_qiita と write_qiita の2つにしました。

AI が書いたものをそのまま公開しない

AI の下書きは間違うことがありますし、筆者の体験が入っていない記事は読んでいて面白くありません。
TODO を埋めて、自分の言葉と体験を足してから公開する ことを自分のルールにしています。

記事中に秘密の値を載せない

個人開発の記事ではコードを引用するので、API キーや接続先 URL、広告 ID などの値は xxxx に置き換えるルールにしています。

ハマったところ

  • トークンを作り直した:最初に発行したトークンで認証エラー(Unauthorized)になり、スコープを確認して発行し直したら通りました
  • ブランチの衝突:下書きブランチとネタ帳の更新が重なると、マージ時にコンフリクトします。ネタ帳の更新と記事の追加を分けて扱うようにしました

まとめ

  • Qiita CLI の公式 Action を使えば、「main にマージ = 公開」が数行で作れる
  • 下書きは AI に任せ、公開の判断とひと手間の追記は人がやる と、質を保ったまま続けやすい
  • トークンは Secrets、記事中の秘密情報は伏せ字、を徹底する

リンク

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?