【ITニュース解説】Cloudflare cron day numbers: what Claude gets wrong

システム開発の世界では、決まった時間に特定の処理を自動で実行する仕組みが非常に重要だ。これを「Cron（クロン）」と呼ぶ。例えば、毎日深夜にデータベースをバックアップしたり、毎週月曜日の朝にレポートを生成したりといった作業を、人間が手動で操作することなく、システムが自動的に行ってくれるのだ。システムエンジニアを目指す皆さんにとって、このCronの設定は、基本的ながらも非常に重要な知識となる。しかし、この一見単純そうなCronの設定には、実は思わぬ落とし穴が潜んでいることがある。特に、曜日をどのように数えるかという、ごく基本的な部分で、システムの種類によって解釈が異なる場合があるのだ。

最近、Cloudflare WorkersというプラットフォームにおけるCronトリガーの利用と、大規模言語モデル（LLM）がそのスケジュールを生成する際に発生した問題が報じられた。この問題の核心は、「曜日番号の数え方」の違いにある。

まず、多くのシステムで一般的に使われている「crontab」という形式での曜日番号の数え方を確認しよう。一般的なcrontabでは、週の始まりを月曜日と考えることが多く、月曜日を「1」、火曜日を「2」、水曜日を「3」、木曜日を「4」、金曜日を「5」、土曜日を「6」と割り当てる。そして、日曜日については「0」または「7」という番号を使うことが多い。つまり、「月曜日から金曜日まで毎日」といった指定をしたい場合、「1-5」と記述すれば良い、と多くの人が認識している。

ところが、Cloudflare WorkersのCron Triggersでは、この曜日番号の数え方が異なる。Cloudflareでは、日曜日を週の始まりとみなし、日曜日を「1」、月曜日を「2」、火曜日を「3」、水曜日を「4」、木曜日を「5」、金曜日を「6」、土曜日を「7」と数えるのだ。このわずかな違いが、今回報告された問題の根源だった。

この違いが、具体的にどのような問題を引き起こすのだろうか。現代のシステム開発では、AI、特に大規模言語モデル（LLM）がコードの生成や設定ファイルの作成を支援する場面が増えている。今回、Cloudflare Workers向けのCronスケジュールをLLMに作成させたところ、この曜日番号の解釈の違いが原因で、多くの間違いが発生したのだ。

例えば、一般的なcrontabの知識を持つLLMが「平日（月曜日から金曜日まで）に実行するスケジュール」を作成しようと考え、「1-5」という曜日指定をCloudflare Workers向けに出力したとする。一般的なcrontabでは「1-5」は月曜日から金曜日を指す。しかし、Cloudflareのルールに従うと、「1-5」は日曜日から木曜日を意味してしまう。結果として、LLMが意図した金曜日の処理は実行されず、意図しない日曜日の処理が実行されてしまうことになる。

また、LLMが「金曜日に実行するスケジュール」を生成する際に、一般的なcrontabの「5」という番号を使ったとする。この「5」は、Cloudflareのルールでは木曜日を指すため、金曜日に実行されるべき処理が木曜日に動いてしまうという誤りが発生した。さらに深刻なのは、一般的なcrontabで日曜日を指す「0」という番号を指定した場合だ。Cloudflare WorkersのCron Triggersでは「0」という曜日番号はサポートされていないため、デプロイ（システムへの展開）時にエラーとなり、スケジュール自体が拒否されてしまう事態も発生した。

この問題の厄介な点は、間違いが「静かに発生する」ことにある。つまり、設定自体は受け付けられてしまうが、意図した日とは違う日に実行される、あるいは全く実行されない、といったことが発生し、すぐにエラーとして表面化しにくいのだ。システムが動いているように見えても、実は間違った動作をしているという状況は、問題の発見を遅らせ、潜在的なリスクを高める。

Cloudflare Workersのスケジュール生成を試みたLLMとして「Sonnet」と「Haiku」というモデルが使われたが、補助なしでスケジュールを作成させた場合、Sonnetは18件中13件、Haikuはわずか6件しか正しく作成できなかった。そのほとんどが、この曜日番号の解釈違いに起因するものだった。

しかし、この問題には解決策がある。LLMに「Cloudflare WorkersのCron Triggersでは、日曜日を1として曜日番号を数える」という具体的なルールを明示的に教えてからスケジュールを作成させたところ、結果は大きく改善した。SonnetもHaikuも、18件全てのスケジュールを正確に作成できるようになったのだ。これは、AIを活用する上で、単に汎用的な知識を与えるだけでなく、特定のプラットフォームやシステムにおける「ローカルルール」を明確に指示することの重要性を示している。

さらに、あるスケジューラーから別のスケジューラー形式へ変換するテストでも、同様の問題が発生した。ここでも、曜日番号の解釈違いが原因で、多くの変換ミスが生じた。このことから、異なるシステム間で設定を移行する際にも、細かな仕様の違いに注意深く対応する必要があることが分かる。

この事例から、システムエンジニアを目指す皆さんが学ぶべき教訓はいくつかある。第一に、一見些細に見えるシステムの仕様の違いが、大きな問題を引き起こす可能性があるということだ。特に、多くのシステムで共通して使われている概念（今回の場合は曜日番号）であっても、特定の環境では異なる解釈がされることがある。第二に、AIのような自動化ツールを利用する際でも、そのツールの出力が対象システムの要件に完全に合致しているかを、人間が最終的に確認することの重要性だ。AIは学習したデータに基づいて一般的なパターンを適用しようとするが、固有のルールまでは自動的に推測できない場合がある。

システム開発において、ドキュメントを丁寧に読み込み、使用するプラットフォームやツールの具体的な挙動を正確に理解する姿勢は極めて重要だ。今回のCloudflareと一般的なcrontabの曜日番号の違いは、まさにそのような細部への注意が、安定したシステム運用には不可欠であることを教えている。表面的な理解に留まらず、システムの奥深くにある規則まで掘り下げて確認する習慣を身につけることが、信頼性の高いシステムを構築するための第一歩となるだろう。