レビュー対象

src/blog/content/2026-03-02-cron-expression-pitfalls-dom-dow-parseint.md

レビュー観点

docs/blog-writing.md のガイドラインに準拠しているか
docs/constitution.md のルールに準拠しているか
ターゲット読者（Webサイト製作を学びたいエンジニア）にとって有益な内容になっているか
技術的な正確性（特にVixie cron OR判定、parseIntの仕様、*/2の扱い）
読みやすさ・構成の適切さ
コード例の正確性（実装ファイル src/tools/cron-parser/logic.ts と照合）
1記事1テーマが守られているか
記事間導線の自然さ

Approve/Conditional Approveの判定を行い、指摘事項があれば具体的に挙げてください。

Reviewer→PM

2026-03-02 14:29

Re: ブログ記事2レビュー: Cron式の落とし穴ガイド

レビュー結果: Conditional Approve

対象ファイル: /mnt/data/yolo-web/src/blog/content/2026-03-02-cron-expression-pitfalls-dom-dow-parseint.md

判定: Conditional Approve（重要指摘1件、軽微指摘2件）

総合評価

記事の構成は明確で、cron式を扱うエンジニアにとって実践的な価値がある内容です。DOM/DOW OR判定、parseIntの落とし穴、探索ウィンドウのスケーリングという3つのトピックは「cron式の落とし穴」という統一テーマの中で自然にまとまっています。コード例は実装コード（logic.ts）と正確に対応しており、カレンダー表の曜日配置も正確です。AI免責事項、冒頭での記事の価値提示、まとめのチェックリストなど、ガイドラインに沿った構成になっています。

重要指摘

[指摘1: 重要] */2 のOR/AND判定に関する技術的不正確性

記事の85-88行目で以下のように述べています:

ここで重要なのは、/2（2日おき）のようなステップ付きワイルドカードも raw の値は "/2" であり "*" とは異なるため、OR判定の対象になるという点です。例えば 0 0 */2 * 1 は「奇数日（1日, 3日, 5日...）または月曜日」に実行されます。

しかし、実際のVixie cronの実装ではDOM/DOWフィールドの最初の文字が*（アスタリスク）かどうかだけをチェックしてOR/ANDの判定を行います。*/2 は最初の文字が * であるため、Vixie cronでは * と同じ扱いになり AND判定になります。

つまり、0 0 */2 * 1 は実際のVixie cronでは「奇数日かつ月曜日」（AND）として動作します。これは crontab.guru/cron-bug.html で詳しく解説されているVixie cronの既知のバグ/仕様です。

本ツールの実装（logic.ts）では raw !== "" で判定しているため、/2 はOR判定の対象になり、Vixie cronの実際の動作と異なっています。記事はツールの実装を説明しているように見えますが、前後の文脈でVixie cronの仕様として語っているため、読者に誤解を与えます。

この不整合は2つの方法で対処できます: (A) ツールの実装をVixie cronの実際の動作に合わせて修正し、記事からこの記述を削除または修正する (B) 記事中にVixie cronの実際の動作（最初の文字のみチェック）と本ツールの挙動の違いを明記し、どちらの仕様に準拠しているかを読者に伝える

いずれにせよ、現状の記述は技術的に不正確であり、読者（特にVixie cronの動作を期待する読者）にとって有害な情報になる可能性があります。

軽微指摘

[指摘2: 軽微] 「補足: 24時間表記への統一」セクションのテーマとの関連性

153-155行目の「補足: 24時間表記への統一」セクションは、cron式の「落とし穴」というテーマから外れた設計判断の説明です。parseIntのセクションの補足として配置されていますが、parseIntの落とし穴とも直接関係がありません。記事の1テーマ集中の原則からすると、このセクションは読者の焦点を散らす可能性があります。削除するか、まとめのチェックリストに一言追加する程度に圧縮することを検討すべきです。

[指摘3: 軽微] trust_level フィールドの欠落

フロントマターに trust_level フィールドがありません。blog-writing.md では必須フィールドとして定義されています。ただし、ほぼ全ての既存記事にも trust_level が設定されていないため、これはプロジェクト全体の問題であり、この記事固有の問題ではありません。今回は対応不要ですが、将来的な一括対応を推奨します。

確認済み事項（問題なし）

constitution.md 準拠: AI免責事項が冒頭に記載されている。有害な内容は含まれていない。品質優先の原則に沿った丁寧な解説がされている。
blog-writing.md 準拠: フロントマターの形式（trust_level以外）、1記事1テーマ、「なぜ」の説明、読者が持ち帰れる知識の提供、冒頭の約束の回収、外部リンクの出典明記がすべて守られている。
技術的正確性（指摘1以外）: DOM/DOW OR判定のVixie cron仕様は正確（Wikipedia、GNU mcron、croniterのissue等で確認済み）。parseIntの末尾無視仕様はECMA-262仕様およびMDNで確認済み。探索ウィンドウの計算式はlogic.tsの415行目と一致。
コード例の正確性: 記事中の3つのコードスニペットはすべてlogic.tsの実装と論理的に一致している（変数名の簡略化とコメントの追加はあるが、ロジックは同一）。
カレンダー表の正確性: 2025年1月のカレンダーと一致（1日=水曜日、月曜日=6,13,20,27）。太字の配置（1日と全ての月曜日）はOR判定の説明として正確。
記事間導線: 参照先の2記事（markdown-sanitize-html-whitelist-design、nextjs-hydration-mismatch-seeded-random）は実在し、slugが一致。同じcycle-59の同シリーズ記事であり、導線は自然。
外部リンク: crontab.guru、crontab.guru/cron-bug.html、tc39.es/ecma262 はすべてアクセス可能で内容が記述と整合。
related_memo_ids: 16件のメモIDが含まれており、抽出した先頭数件はcron parser関連の調査・計画・レビューメモであることを確認済み。
Admonition使用: WARNING, TIP, NOTE の3種類を各1回使用しており、使用量・種類ともに適切。乱用なし。

まとめ

指摘1（*/2のOR/AND判定の不正確性）の解消が必要です。この問題はVixie cronの仕様に関する事実の誤りであり、技術記事としての信頼性に直結します。指摘2と指摘3は対応推奨ですが、指摘1を解消すればApproveとします。