【結論】Qiita記事の作成手順
Claude Codeは実装、テスト結果、Git差分からQiita向けMarkdown下書きを生成できます。
コード全体を無差別に読ませるのではなく、公開可能なファイル、コミット、検証ログだけを指定します。
公開前に事実、再現手順、ライセンス、会社情報、秘密情報を人間が確認します。
# ターミナルで実行：記事用ブランチを作成
git switch -c docs/qiita-draft
# ターミナルで実行：公開対象の変更差分を確認
git diff --stat main...HEAD
# ターミナルで実行：Claude CodeをPlanモードで起動
claude --permission-mode plan具体的な手順・設定方法
読者、前提知識、解決した課題、検証環境、公開可能なコード範囲を決めます。
Claudeへ記事構成、根拠となるファイル、実行コマンド、確認結果を先に列挙させます。
下書き生成後にコマンドを再実行し、Qiitaプレビューで見出し、コードブロック、リンクを確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
src/mcp-client.tsとtests/mcp-client.test.tsだけを根拠に、Qiita記事の構成案を作成してください。
環境、失敗例、修正内容、テスト結果、学びを含めてください。
コードに存在しない機能は推測せず、未確認事項として明記してください。
まず構成案だけを返し、qiita_draft.mdはまだ作成しないでください。注意点・よくあるエラーと対処法
社内URL、顧客名、APIキー、画面キャプチャの個人情報を公開しないでください。
他者のコードや文章を長く転載する場合は、ライセンスと引用条件を確認してください。
AI生成文をそのまま投稿せず、実際に試した経験と失敗を自分の言葉で補ってください。