【結論】根拠付きZenn記事を作る
Claude Codeはコード、テスト、Issue、設計資料を根拠にZenn用MarkdownのDraftを作成できます。
記事では実装済み事実、推測、個人の見解を分け、コマンドとコード例を実行確認します。
公開前にZenn CLIでfrontmatter、画像、リンク、メッセージ記法、MermaidをPreviewします。
# ターミナルで実行:Zenn CLI環境を初期化
npx zenn init
# ターミナルで実行:記事を作成
npx zenn new:article --slug claude-code-audit --title 'Claude Code監査'
# ターミナルで実行:ローカルPreviewを開始
npx zenn preview
# ターミナルで実行:記事差分を確認
git diff -- articles具体的な手順・設定方法
読者、解決する問題、根拠ファイル、再現環境を決めます。
Claudeへ見出しごとの根拠と未確認事項を先に列挙させます。
生成後にコマンド、版、URL、画像、機密情報を人間が確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
src/authとtests/authだけを根拠にZenn記事の構成案を作成してください。
背景、失敗例、最小修正、テスト、学びを含めてください。
確認できない機能や性能値は書かず、まだ記事ファイルを変更しないでください。注意点・よくあるエラーと対処法
コミット履歴から開発者の意図を断定しないでください。
社内URL、顧客名、Secrets、非公開Issueを公開記事へ含めないでください。
生成文をそのまま公開せず、著者自身の検証と編集を通してください。