直したのはバグではなく前提だった ── Zenn記事生成スキルをZenn特化に作り直すまで
この記事で分かること
Zenn特化に作り直す過程で、バグではなく前提の誤りに気づく方法が得られる。実際の修正事例から学べる。
詳細要約
Zenn記事生成では、汎用的なAIスキルがZenn独自のMarkdown記法やタグ制限、公開設定といったプラットフォーム固有の前提を無視していたため、出力が使い物にならなかった。そこで、バグ修正ではなく「入力時にZennのルールをすべて前提とする」方針に切り替えた。具体点として、プロンプトに「見出しは##から始め、コードブロックは言語指定必須、画像はの形式、タグは最大5つまで」と明示する。さらに、生成後にZennのプレビュー機能で表示崩れがないか確認する手順を組み込むことで、手戻りを大幅に削減できる。