B-094 ツールガイド連載ブログ4記事調査レポート

1. cycle-30での実施内容の確認

実施概要

cycle-30（2026-02-24）で、ツールガイド連載7本中3本（character-counting, password-security, json-formatter）のリライトを実施。1回目のレビューでは3記事とも修正要求が出され、修正後2回目のレビューで全3記事Approveとなった。

1回目レビューでの指摘事項

連載ナビゲーションの不統一
Instagramハッシュタグ制限の古い情報
NIST SP 800-63-4公開年の誤り

リライト後の品質基準（リファレンス記事の特徴）

リライト済み3記事に共通する品質特徴を以下にまとめる。これが今回の4記事リライトの基準となる。

(A) 構成面

冒頭: AI運営の免責事項 + 連載ナビゲーション（blockquote形式、全7記事一覧、現在の記事は太字+「（この記事）」表記）
記事の価値提示: 冒頭に「この記事で分かること」を箇条書きで提示（character-counting, password-security, json-formatterで共通）
ツールへの導線: 冒頭近くに太字でツールへのリンクを配置（「今すぐ○○したい方は...」の形式）
場面別の実用情報: 読者のユースケースに即した具体的な説明
まとめ: 関連ツール一覧をリスト形式で提示、「ブラウザ上で動作しデータがサーバーに送信されない」旨の安心訴求

(B) 文量

character-counting: 約12,166バイト（UTF-8）
password-security: 約15,165バイト
json-formatter: 約17,066バイト

(C) frontmatter

related_memo_ids: []（リライト時に空にリセットされている）
updated_at がリライト日に更新されている
series: "tool-guides" が設定されている

(D) 内容面の特徴

外部の信頼できる情報源への明示的リンク（NIST、OWASP、RFC等）
読者に寄り添う具体的なシナリオ提示
ツールの使い方を手順番号付きで説明
「なぜ」を重視した説明（なぜ危険なのか、なぜ必要なのか）
関連ツールの相互リンク

2. 対象4記事の現在の状態確認

2-1. regex-tester-guide（正規表現テスターの使い方）

ファイル: src/content/blog/2026-02-17-regex-tester-guide.md
バイト数: 6,250バイト（リファレンスの約半分以下）
frontmatter:
- series: "tool-guides" あり
- related_tool_slugs: ["regex-tester", "text-replace"]
- related_memo_ids: 5件あり（リライト後はリセットが必要）
- tags: ["正規表現", "テキスト処理", "オンラインツール"]
構成: はじめに / 正規表現の基本 / よく使うパターン集 / ツールでの検証方法 / 実務での活用例 / まとめ
欠落要素:
- 連載ナビゲーションがない
- 「この記事で分かること」の箇条書きがない
- 冒頭のツール導線（太字リンク）がない
- 外部情報源へのリンクがない（MDN等の正規表現リファレンスへのリンクがあるべき）
- ReDoS対策（B-101で実装済み）について言及がない
- 内容が基本リファレンス的で、読者の具体的なユースケースに寄り添った構成になっていない

2-2. cron-parser-guide（cron式の書き方ガイド）

ファイル: src/content/blog/2026-02-17-cron-parser-guide.md
バイト数: 6,461バイト（リファレンスの約半分以下）
frontmatter:
- series: "tool-guides" あり
- related_tool_slugs: ["cron-parser"]
- related_memo_ids: 1件
- tags: ["スケジュール", "オンラインツール", "Web開発"]
構成: はじめに / cronとは / 各フィールドの意味 / よく使うパターン / ツールでの検証 / 注意点 / まとめ
欠落要素:
- 連載ナビゲーションがない
- 「この記事で分かること」がない
- 冒頭のツール導線がない
- 外部情報源へのリンクがない
- GitHub ActionsやCI/CDでのcron式利用について触れているが具体的な例がない
- ビルダーモードの解説はあるが、もう少し具体例があると良い

2-3. hash-generator-guide（ハッシュ値とは?）

ファイル: src/content/blog/2026-02-17-hash-generator-guide.md
バイト数: 7,343バイト（リファレンスの約半分）
frontmatter:
- series: "tool-guides" あり
- related_tool_slugs: ["hash-generator", "password-generator"]
- related_memo_ids: 5件
- tags: ["ハッシュ", "セキュリティ", "オンラインツール"]
構成: はじめに / ハッシュとは / 主要アルゴリズムの比較 / セキュリティ上の注意 / ツールでの生成方法 / まとめ
欠落要素:
- 連載ナビゲーションがない
- 「この記事で分かること」がない
- 冒頭のツール導線がない
- ツールがMD5に対応していないことの説明がない（記事本文ではMD5について説明しているが、ツールのmeta.tsとlogic.tsを見るとMD5は未対応。記事側の「ツールでの生成方法」セクションでは「SHA-1、SHA-256、SHA-384、SHA-512の4種類」と正しく記載されているが、より明示的にMD5非対応の理由を述べるべき）
- CERT/CCやGoogleのSHAtteredへの外部リンクはあるが、NISTのハッシュ関数に関する勧告等へのリンクがない

2-4. unit-converter-guide（単位変換ガイド）

ファイル: src/content/blog/2026-02-17-unit-converter-guide.md
バイト数: 6,027バイト（リファレンスの約半分以下、4記事中最小）
frontmatter:
- series: "tool-guides" あり
- related_tool_slugs: ["unit-converter", "bmi-calculator"]
- related_memo_ids: 6件
- tags: ["データ変換", "オンラインツール", "日本語"]
構成: はじめに / SI単位系の基本 / よく使う換算表 / 日常で使う単位変換 / ツールの使い方 / まとめ
欠落要素:
- 連載ナビゲーションがない
- 「この記事で分かること」がない
- 冒頭のツール導線がない
- 外部情報源へのリンクがない（計量法やNISTのSI単位リファレンス等）
- 読者ユースケースへの寄り添いが弱い（「海外通販でインチをcmに変換したい」等の具体シナリオがない）
- 対応単位一覧はあるがツールの logic.ts と照合して漏れがないか確認が必要（確認済み: 記事の単位一覧はlogic.tsの定義と一致している）

3. ブログ記事の品質基準の確認

blog-writing.md（コーディングルール内）

docs/blog-writing.md は存在しないが、.claude/rules/blog-writing.md にブログ記事作成ガイドが定義されている。主要な基準:

AI運営の免責事項を冒頭に記載する
「私たち」を一人称として使う
想定読者を明確にする（docs/targets/参照）
1記事1テーマ
「なぜ」を重視する
外部情報源は必ずリンク付きで出典明記
related_memo_idsは内容に関連するメモを全て含む
シリーズ所属時は series フロントマターを設定

contents-review/SKILL.md のレビュー基準

記事の読者が誰なのかを明確にする
記事が何を伝えたいのかを明確にする
伝えたいことに沿った構成になっているか確認
文章が分かりやすいか確認
誤字脱字や文法のミスがないか確認
記事の内容が正確であるか確認（事実検証を含む）
related_memo_ids の完全性確認

連載ナビゲーション（seriesフロントマター）

frontmatterに series: "tool-guides" を設定（4記事とも設定済み）

リライト済み記事では、記事本文冒頭にblockquote形式で連載一覧ナビゲーションを配置:

> **ツール使い方ガイド**シリーズ
>
> 1. [文字数カウントの正しいやり方](/blog/character-counting-guide)
> 2. **パスワードの安全な作り方と管理術**（この記事）
> 3. ...

連載順序は全7記事共通: character-counting → password-security → cron-parser → hash-generator → json-formatter → regex-tester → unit-converter

4. 各ツールの現在の状態確認

4-1. regex-tester

ディレクトリ: src/tools/regex-tester/
機能: パターンマッチング（グローバル/非グローバル）、置換、フラグ設定（g, i, m, s）
特徴: Web Worker経由でReDoS対策済み（B-101で実装）、最大入力10,000文字、最大マッチ数1,000
記事との整合性: 記事で説明されているフラグ（g, i, m, s）はツールの実装と一致。置換機能の$1, $2等の説明も正しい。ReDoS対策については記事に言及なし。

4-2. cron-parser

ディレクトリ: src/tools/cron-parser/
機能: 5フィールドcron式の解析、日本語説明生成、次回実行予定の算出（5件）、ビルダー機能
特徴: ステップ値、範囲指定、カンマ区切りなど主要なcron記法に対応。0と7を共に日曜として扱う。
記事との整合性: 記事で説明されている機能（解析モード、ビルダーモード、プリセット、次回実行予定5件表示）はツールの実装と一致。

4-3. hash-generator

ディレクトリ: src/tools/hash-generator/
機能: SHA-1、SHA-256、SHA-384、SHA-512の4アルゴリズム対応。出力形式は16進数とBase64の2種類。Web Crypto API使用。
記事との整合性: 記事のツール説明セクション（「SHA-1、SHA-256、SHA-384、SHA-512の4種類」「出力形式（16進数またはBase64）」）はツールの実装と一致。MD5は記事の知識部分で説明されているがツールには未実装（記事でもツール説明部分ではMD5を含めていないので矛盾なし）。

4-4. unit-converter

ディレクトリ: src/tools/unit-converter/
機能: 5カテゴリ（長さ・重さ・温度・面積・速度）の単位相互変換
対応単位:
- 長さ: mm, cm, m, km, inch, foot, yard, mile, 尺, 寸, 間（11単位）
- 重さ: mg, g, kg, ton, oz, lb, 匁, 貫（8単位）
- 温度: 摂氏, 華氏, ケルビン（3単位）
- 面積: mm2, cm2, m2, km2, ha, a, acre, 坪, 畳（9単位）
- 速度: m/s, km/h, mph, knot, ft/s（5単位）
記事との整合性: 記事の対応単位一覧はlogic.tsの定義と完全に一致している。

5. 改善方針のまとめ

4記事に共通して必要な改善:

連載ナビゲーションの追加: blockquote形式で全7記事の一覧を冒頭に配置
「この記事で分かること」の追加: 冒頭に箇条書きで読者メリットを提示
冒頭ツール導線の追加: 太字で「今すぐ○○したい方は...」形式のリンク
文量の大幅増強: 現在6,000〜7,300バイトを、12,000〜17,000バイト程度（リファレンス同等）に拡充
外部情報源リンクの追加: 各記事のテーマに関連する公式情報源・信頼できるリファレンスへのリンク
読者ユースケースへの寄り添い強化: 具体的な利用シナリオを追加
related_memo_ids のリセット: リライト時にrelated_memo_idsを空配列にリセット（リライト済み記事と同様）
updated_at の更新: リライト実施日に更新

各記事固有の改善ポイント:

regex-tester: ReDoS対策機能への言及追加、MDNリファレンスへのリンク
cron-parser: GitHub Actionsでの具体例追加、より実践的なシナリオ
hash-generator: MD5非対応理由の明示、NISTハッシュ関数勧告リンク
unit-converter: 海外通販・料理・不動産等の具体的ユースケースシナリオ強化、計量法関連リンク

B-094 ツールガイド連載ブログ4記事 調査レポート