はじめに
「アウトプットを習慣にしたいけど、毎週ゼロから記事を書くのは続かない」という悩みから、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 には毎週次のことを頼んでいます。
-
topics.txtの一番上のネタを取り出す - 必要ならリポジトリのコードや公式ドキュメントを読んで、下書きを書く
- 自信がない箇所は
<!-- TODO: 要確認 -->、自分の体験が必要な箇所は<!-- TODO: 自分の体験を追記 -->を入れる - ブランチを切って 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、記事中の秘密情報は伏せ字、を徹底する
リンク
- Qiita CLI: https://github.com/increments/qiita-cli