Blackbox Blast
BB Preflight
← 事故ログへ

CASE · 軽微 · other

検証済み運営者の一次記録

記事に書いたコマンドの `--オプション` が、公開ページでは `—オプション` に化けていた

自分たちのサイトに載せた記事で、本文のコマンドオプション(例: --as-agent, --version)の先頭の「--」が、公開ページでは長いダッシュ「—」に置き換わって表示されていた。

約2分で読めます

発生日
分類
other
影響範囲
reputation
検知
manual-observation
タグ
#astro #markdown #smartypants #typography #cli-flags #default-setting

CH 1

原因

サイトを作っている Astro の Markdown 処理は、既定で smartypants(引用符やダッシュを見栄えのよい記号に自動置換する機能)が有効になっている。この機能が、本文中の「--」を「—」に変える。原稿のファイルは正しいままなので、原稿を読み返しても気づけない。

CH 2

結果

コマンドの書き方を伝える記事で、コピーして使うと動かない表記が公開されていた。BB は事故の記録を載せるサイトで、コマンドの正確さが中身の一部になる。期間と影響した記事の全数は、記録に残っていない。

CH 3

対策

設定で smartypants を無効にした(2026年11月5日)。以後、本文の「--」は書いたとおりに表示される。教訓は、既定で有効な「見栄えの自動補正」は、原稿を見ても結果が分からない、ということ。

何が起きたか

BB の記事には、AIエージェントのコマンドやオプションがたくさん出てくる。2026年11月5日、公開ページで --as-agent や --version の頭が「—」になっているのが見つかった。

原因

Astro の Markdown 処理は、既定で smartypants を使う。引用符を曲がった引用符に、「--」を長いダッシュにする、見栄えのための自動置換だ。文章には合うが、コマンドのオプションにとっては破壊になる。原稿のファイルは正しいので、原稿を見ても、バリデータを通しても気づけない。公開ページを見て初めて分かる種類の不具合だった。

直したこと

  • site/astro.config.mjs で smartypants を無効にした。以後、本文の「--」は書いたとおりに出る。
  • 新しい記事にオプションを書くときに、置換を心配する必要もなくなった。

学び

フレームワークの既定で有効な「親切な自動補正」は、入力と出力が一致しなくなる場所を黙って作る。コマンドや識別子を載せるサイトは、補正を最初から切っておくか、公開ページで確認する。

出典

  • 運営者自身が起こした事故の一次記録です。外部に公開された元記事はありません。
PREFLIGHTあなたの Mac の備えは、大丈夫?BB Preflight は、AIエージェントの権限や鍵の置き場所など21項目を、読み取りだけで点検する無料の Mac 用ツールです。点検してみる →