NUCHIレビュー対応プラン — Zenn記事ドラフト改善

即対応 1. AIへの指示文を codeblock に変更

NUCHIの指摘: 「AIへの指示文の例はcodeblockの方がわかりやすい」

参考: knip記事では、AIへのプロンプトをコードブロック（灰色背景・等幅フォント）で表示している。本文テキストとの区別がつきやすい。

現状: セキュリティ監査のプロンプト例が引用ブロック（>）で書かれている。引用は「誰かの発言の引用」に使うものなので、AIへの入力文としては意味がずれる。

対応: 記事内の引用ブロックをコードブロックに変更する。

即対応 2. 末尾CTAのリポジトリURL修正

NUCHIの指摘: 「このリポジトリを分析させてとあるが、記事内にリポジトリが書いてないかも？」

現状: 記事の最後に「この記事のURLをあなたの Claude Code に読ませて」と書いてあるが、「分析して」と言うならリポジトリのURLを渡すべき。GitHub URLは「まとめ」セクションにはあるが、CTA（行動を促す文）との接続が弱い。

対応: 「この記事のURL」→「上のGitHubリポジトリのURL」に修正。

要判断 3. 文章を減らしてスクリーンショットに置き換え

NUCHIの指摘: 「文章は減らして、スクショに置き換えれるところはそうした方がいい記事になるかも、特にターミナルのところとか」

参考: yoshiko記事は文章少なめ・コード全文掲載・スクリーンショット1枚で視覚的に説得力がある。段落は2〜3行と短い。

スクショ候補:

• サーバー起動時のターミナル出力（PIN表示を含む）
• スマホでのPIN入力画面
• plan-viewer のスマホ表示画面（すでに1枚ある）
• アノテーション機能のデモ（すでにGIFがある）
• hook がブロックした時のターミナル表示

対応案: ターミナル操作の説明文をスクショに置き換え、文章量を減らす。スクショの撮影はあなた自身の作業が必要。素材を渡してもらえれば記事に組み込める。

要判断 4. plugin ではなく skill だけで良いのでは？

NUCHIの指摘: 「自然言語で完結させているmdファイルなのであれば、pluginではなくskillだけで良いかも（俺の理解ではpluginが必要なケースは相当珍しいはず）」

現状の分析: plan-viewer は以下の4つの部品で構成されている:

• hook（plan確定をブロックするゲート） — skill のフロントマター（設定ヘッダー）でも定義できる
• コマンド（/plan-viewer:setup, /plan-viewer:serve） — plugin構造が必要
• スキル（HTML生成ルール） — 単体で動く
• Pythonスクリプト（HTTPサーバー） — 外部ファイルとして配置

コマンド（スラッシュコマンド）を使うには plugin 構造が必要。ただし、コマンドをスキルの指示文に統合すれば skill だけでも成立する可能性はある。

判断ポイント: plugin構造を維持するなら「なぜpluginなのか」を記事で説明する。skill に再構成するなら記事タイトルも「スキル」に変える必要がある。

対応案:

• A案: plugin のまま維持し、記事内で「hookとコマンドを使うためにplugin構成にした」と理由を説明する
• B案: skill だけに再構成する（コマンドを廃止し、スキルの説明文に統合）

要判断 5. 使ってる技術/戦略を書く + SKILL.md 埋め込み

NUCHIの指摘: 「使ってる技術とか書いたほうがいいかもな。もしなくて意図的に自然言語で完結させているとかであれば、そういう戦略的なものも書きつつ、SKILL.mdが公開してもいいんであれば、なんかコードブロックとかでzennの中で貼り付けちゃった方がもしかしたら楽かもね。」

現状: 記事では「文章ルールが本質」セクションで SKILL.md のルールを一部引用しているが、技術スタックの説明はない。

plan-viewer の特徴は「コードをほとんど書いていない」こと。hook のシェルスクリプトと HTTP サーバーの Python スクリプト以外は、すべて自然言語の Markdown ファイルだけで成立している。

対応案:

• 「技術スタック」セクションを追加して、意図的に自然言語で完結させている戦略を説明する
• SKILL.md の文章ルール部分をコードブロックで全文掲載する（現在は一部引用のみ）
• yoshiko記事のようにコード全文掲載で説得力を出す方向性

対応済 6. h2見出しからemoji削除

NUCHIの指摘: 「h2見出しにemojiを使うのは『AIっぽい＝AI任せの低品質なもの』と連想されがちだから、ない方がいいかも」

確認結果: 記事の全10個のh2見出しを確認済み。いずれもemojiを使っていない（例: 「vibe-codingを"vibe"なままにしないために」「plan-viewerというプラグインを作った」）。

Zennの記事カード用emoji（フロントマターの emoji: "📱"）は残すべき。これはZennの標準仕様。

対応: すでに対応済み。追加作業なし。

全体方針 7. yoshiko記事を参考にした全体改善

NUCHIのコメント: 「yoshikoが例なのは、こいつはcatnoseと同じようにhumanにわかりやすい文章や伝え方が得意そうだからそうしている」

yoshiko記事の分析結果:

• 文章量は少なめ。段落は2〜3行で改行
• コード（コマンド定義の Markdown）を全文掲載して読者が自分で読めるようにしている
• スクリーンショットは1枚だが、コマンド実行時のUIを見せている
• h2見出しにemojiなし（タイトルのみ）
• 各ステップの「なぜ」を簡潔に説明している

対応案: #3（スクショ追加）と #5（SKILL.md全文掲載）を合わせて実行すると、yoshiko記事に近い「ビジュアル + コード全文」の構成になる。