← 一覧に戻る

Zenn記事 NUCHIレビュー対応プラン

2026年2月28日 18:00 更新

一言でいうと

不動産プラグインのZenn記事ドラフトにNUCHIから7点のフィードバック。全て対応方針をまとめた。

参考にされた記事

yoshiko — /release コマンド

h2に絵文字なし。短い段落。スクショでターミナル実行結果を見せる。コマンドの.mdファイル内容を丸ごとコードブロックで公開。catnose氏と同じく「人間に分かりやすい文章」が得意な書き手。

knowledgework — knip × AIエージェント

AIへの指示文をコードブロックで表示。「knipを使って無駄コードを掃除して。」のように自然言語をそのままコードブロックに入れている。

指摘と対応方針(7点)

即対応

1. h2見出しの絵文字を削除する

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

対応方針: Zenn記事のh2から絵文字を全て削除する。テキストのみの見出しに。

BEFORE
## 📊 分析の仕組み
AFTER
## 分析の仕組み
即対応

2. リポジトリURLを記事内に記載する

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

対応方針: 記事末尾の「Claude Codeに読ませてみて」の直前にGitHubリポジトリURLを追加。

BEFORE
まずはこの記事をあなたの Claude Code に読ませて、このリポジトリの構造を分析させてみてほしい。
AFTER
リポジトリ: https://github.com/ramenumaiwhy/reinfolib-plugin まずはこの記事をあなたの Claude Code に読ませて、リポジトリの構造を分析させてみてほしい。
即対応

3. AIへの指示文をコードブロックにする

NUCHIの指摘: 「AIへの指示文の例はcodeblockの方がわかりやすい」(参考: knip記事

対応方針: 「赤坂1丁目の土地の相場教えて」などの入力例をコードブロックで表示する。knip記事のように、自然言語をそのままコードブロックに入れるスタイル。

BEFORE
「赤坂1丁目の土地の相場教えて」「この物件、高い?安い?」
AFTER
``` 赤坂1丁目の土地の相場教えて ``` ``` この物件、高い?安い? ```
要検討

4. 技術スタック記載 + SKILL.md公開

NUCHIの指摘: 「使ってる技術とか書いた方がいいかも。自然言語で完結させているなら、そういう戦略的なものも書きつつ、SKILL.mdを公開してもいいなら記事内にコードブロックで貼っちゃった方が楽かも」

対応方針: このプラグインは意図的にコードを書かず、自然言語のみで構成している(Markdown 3ファイルだけ)。これは「戦略」として記事で強調する価値がある。SKILL.md をコードブロックで全文掲載し、「これが全てです」と見せる。

yoshiko記事も .md ファイルの全文をコードブロックで公開しており、読者の理解が深まるスタイル。

確認事項: SKILL.md に機密情報がないか要チェック(APIキー等 → 確認済み、なし)。

要議論

5. plugin ではなく skill だけで良いのでは

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

現状: reinfolib-plugin は以下の3ファイルで構成されている:

分析: skill 単体で提供すると、スラッシュコマンド(/price-check)が使えない。SKILL.md だけなら自然言語トリガーのみになる。plugin にしている理由は「確実に起動できるスラッシュコマンド」を提供するため。

対応方針: 記事内で「なぜ plugin として構成したか」を1文で説明する。「スラッシュコマンドで確実に起動させたいので plugin にした。skill だけでも自然言語トリガーで動くが、不動産分析のような重いタスクは明示的にコマンドで起動する方が安全」という趣旨。

要対応

6. 文章を減らしてスクリーンショットを活用する

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

対応方針: 以下の箇所でスクリーンショットを撮影して差し替える:

スクリーンショットの撮影はユーザー側の作業。素材をもらえれば記事に組み込む。

要対応

7. yoshiko記事のスタイルを参考に文体改善

NUCHIの指摘: 「yoshikoはcatnoseと同じようにhumanにわかりやすい文章や伝え方が得意」

yoshiko記事の特徴(分析結果):

対応方針: 記事全体をyoshikoスタイルに寄せる。段落を短くし、技術的な説明は「ざっくりいうと」で導入してから詳細に入る。冒頭に軽い自己紹介を入れる。

対応の優先順位

1. 即座に対応(機械的に修正できる)

- h2の絵文字削除
- リポジトリURL追記
- 指示文のコードブロック化

2. 記事構成の変更(書き直しが必要)

- SKILL.md全文掲載 + 「コードゼロ戦略」の説明追加
- pluginにした理由の説明追加
- 文体をyoshikoスタイルに改善(短い段落、平易な導入)

3. ユーザー作業が必要

- ターミナルのスクリーンショット撮影(実行時の画面と出力レポート)

📝 質問モード — テキストを選択してね
✓ 質問を送信しました