| name | qiita-operations |
| description | Qiita CLI操作とワークフローの共通知識。記事作成、公開状態変更、プレビュー時に参照。 |
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（公開への変更）は絶対に禁止。