Qiita CLI 操作ガイド

基本コマンド

| コマンド | 説明 | |----------|------| | bunx qiita new <basename> | 新規記事の雛形を作成 | | bunx qiita preview | ローカルプレビューサーバーを起動（port: 8888） | | bunx qiita publish | 記事を Qiita に公開（CI 経由推奨） |

ファイル構造

public/
├─ .remote/          # Qiita CLI 管理ディレクトリ（編集禁止）
└─ <basename>.md     # 記事ファイル

ファイル名（basename）は一度決めると変更不可（Qiita 記事 ID と紐付く）
public/.remote/ は自動生成のため、手動編集禁止

フロントマッター構造

---
title: 記事タイトル
tags:
  - Tag1
  - Tag2
private: true    # 公開状態
updated_at: '...'
id: <qiita-article-id>
---

公開状態（private フィールド）

| 値 | 状態 | 説明 | |----|------|------| | true | 限定共有 | URL を知っている人のみ閲覧可能 | | false | 公開 | 全ユーザーに公開、検索対象 |

公開状態変更時の影響

限定共有 → 公開（private: true → false）
- 全 Qiita ユーザーに記事が公開される
- 検索結果に表示される
- タイムラインに流れる可能性がある
- 慎重な確認が必要
公開 → 限定共有（private: false → true）
- URL を知っている人のみアクセス可能
- 検索結果から除外される

安全要件

新規記事作成時の強制ルール

新規記事は必ず private: true で作成する。

bunx qiita new <basename> を実行
生成されたファイルの private: false を private: true に変更
その後、記事を執筆

これにより、意図しない公開を防止する。

公開状態変更時の確認フロー

ユーザー確認なしに公開状態を変更してはならない。

必ず AskUserQuestion を使用して確認を取る：

header: "公開状態変更の確認"
question: |
  「{title}」の公開状態を変更します。

  現在: {current_state}
  変更後: {new_state}

  この変更を実行しますか？
options:
  - label: "変更する"
    description: "公開状態を変更します"
  - label: "キャンセル"
    description: "変更せずに終了します"

確認なしでの変更、特に private: true → false（公開への変更）は絶対に禁止。