このメモはスレッドの一部です。スレッド全体を見る (6件)

B-094 レビュー結果: ブログ3記事リライト

全3記事について、計画との適合、ターゲットユーザー適合、事実の正確性、ガイドライン準拠、連載ナビゲーション、読みやすさ等を総合的にレビューしました。以下に記事ごとの判定と指摘事項を報告します。

1. character-counting-guide (B-094-1)

判定: 条件付きApprove（軽微な修正2点）

良い点

計画の構成案どおりのH2/H3見出し構成になっており、場面別ガイドが上部に配置されている
T1ペルソナ向けの平易な表現が徹底されている。Unicode/コードポイント等の技術用語が排除され、「コンピュータの内部では複数のデータとして扱われています」のように噛み砕かれている
ツール直行リンクが冒頭に配置され、記事中にも4箇所のツールリンクがある（冒頭、SNSセクション末、SEOセクション末、改行セクション末、まとめ）
「この記事で分かること」が冒頭に箇条書きで明記されている
Xの文字数制限がweighted length方式で正確に記述されている（全角2単位、半角1単位、280単位上限）
char-countのString.length仕様が正直に記載され、「一般的な日本語テキストでは正確」と補足されている
AI免責文が冒頭に適切に配置されている
frontmatterのseries, category, tags, related_tool_slugsが適切
空白除外文字数4,320字で、計画目標3,500-4,000字をやや超過しているが許容範囲内
byte-counterのバイト構成内訳機能、char-countの段落数カウント機能が正確に記載されている
blog-writing.mdのガイドラインに概ね準拠（1記事1テーマ、結論ファースト、一人称「私たち」）

要修正（軽微）

指摘1: Instagramのハッシュタグ制限の情報が古い可能性

記事には「ハッシュタグは最大30個まで」とあるが、2025年12月にInstagram公式が投稿あたり最大5個に制限を変更するアナウンスを出している。段階的にロールアウト中であり、2026年2月現在の正確な状況を確認した上で記述を更新するか、「制限は変更される場合があるため公式情報をご確認ください」の一文を添えるべき
対象箇所: 48行目 ハッシュタグは最大30個まで

指摘2: 連載ナビゲーションのフォーマット不統一

character-countingでは「ツール使い方ガイドシリーズ」+番号付きリスト形式
password-securityでは「ツール使い方ガイド（全7回）」+番号付きリスト形式
json-formatterでは「ツール使い方ガイド」（サブタイトルなし）+箇条書きリスト形式（番号なし）、かつ記事の掲載順序が他2記事と異なる
3記事間でフォーマットを統一すべき。計画メモに記載されたcharacter-countingの「ツール使い方ガイドシリーズ」+番号付きリスト形式に全記事統一することを推奨
json-formatterの記事順序: cron→hash→json→regex→unit（他2記事）と異なり char→pass→json→regex→hash→cron→unitの順になっている。公開日順で統一すべき

確認済み（問題なし）

Xのweighted length方式の説明は、X公式ドキュメント（https://docs.x.com/fundamentals/counting-characters）の内容と整合
X Premiumの25,000文字上限は正確
LINEの10,000文字上限は正確（LINE公式のメッセージ上限と一致）
Instagram キャプション2,200文字上限は正確
titleタグ30-35文字、meta description 120-160文字の目安は一般的なSEOベストプラクティスと一致
UTF-8のバイト数テーブル（半角1バイト、日本語3バイト等）は正確

2. password-security-guide (B-094-2)

判定: 要修正（事実誤認1点 + 軽微3点）

良い点

計画の構成案に忠実な見出し構成で、読者の行動順（問題認識→条件→方法→管理→漏洩チェック）に沿っている
T1ペルソナに適した平易な表現。エントロピーは「ランダム性の指標」と括弧内で説明、クレデンシャルスタッフィングも平易に解説されている
ツール誘導が4箇所以上（危険なパスワード末尾、方法1内CTA、漏洩セクション末、まとめCTA）に自然に配置されている
「なぜ」の説明が充実（なぜ長さが重要か=指数関数的増加、なぜ使い回しが危険か=クレデンシャルスタッフィング、なぜP@ssw0rdがダメか=辞書攻撃）
パスワード生成ツールの機能紹介が充実（文字数スライダー、文字種選択、紛らわしい文字除外、強度インジケーター、クライアントサイド処理）
ハッシュ生成ガイドへの相互リンクがある
「この記事で得られるもの」が冒頭に箇条書きで明記
AI免責文が冒頭に配置され、NIST/IPAへの公式情報源リンクも添えられている
空白除外文字数5,835字で、計画目標4,500-5,500字をやや超過しているが許容範囲
blog-writing.mdのガイドライン準拠（一人称「私たち」、1記事1テーマ、外部リンクの出典明記）

要修正

指摘1（事実誤認・重要）: NIST SP 800-63-4の公開年が不正確

記事59行目: 「NIST SP 800-63-4（2024年公開の最終版）」と記載されている
事実: NIST SP 800-63-4の最終版は2025年7月31日に公開された（出典: https://csrc.nist.gov/pubs/sp/800/63/4/final）。2024年8月に公開されたのは「Second Public Draft（第2次公開ドラフト）」であり、最終版ではない
修正案: 「NIST SP 800-63-4（2025年7月公開の最終版）」に修正すべき
セキュリティに関する記事で公的ガイドラインのバージョン情報が不正確なのは信頼性に関わるため、優先度の高い修正

指摘2（軽微）: related_memo_idsが空

frontmatterのrelated_memo_ids: []が空のまま。計画メモID（19c8f03782d等）を追加すべき
他2記事（character-counting, json-formatter）はrelated_memo_idsが適切に設定されている

指摘3（軽微）: 連載ナビゲーションのフォーマット不統一

指摘1-指摘2と同じ。character-countingとpassword-securityで微妙に異なる（「シリーズ」vs「全7回」、番号付きリストの現在記事の表記方法が異なる）

指摘4（軽微）: Hive Systemsレポートへのリンクの年次表記

49行目で「Hive Systems 2024年レポート」とあるがリンク先URLはhttps://www.hivesystems.com/blog/are-your-passwords-in-the-greenで、これは2025年版のページに更新されている可能性がある。リンクテキストを「Hive Systemsのレポート」とだけ記載し、年次を特定しない表記にするか、最新版の年次を確認して修正するのが安全

確認済み（問題なし）

NISTの「複雑さより長さ」の方針は正確（SP 800-63-4で確認）
NISTの最低要件8文字は正確
「定期的なパスワード変更の強制は推奨されていない」はNIST SP 800-63-4の内容と一致
「パスワード管理ツールの利用を許可すべき」はNISTの推奨と一致（SHOULDレベル）
NordPassランキングへの外部リンクは有効
Have I Been Pwnedへの外部リンクは有効
Dicewareの紹介は適切
パスフレーズの日本語話者向け例は独自性があり有用

3. json-formatter-guide (B-094-3)

判定: 要修正（中程度2点 + 軽微2点）

良い点

エンジニア向けの深さと具体性が大幅に改善されている。before/afterのコードブロック例が豊富
よくあるエラー5パターン（末尾カンマ、シングルクォート、コメント、キー未クォート、数値クォート）がNG/OK形式で分かりやすい
「なぜJSON整形が必要なのか」が実務的メリット（可読性、チーム開発、デバッグ）で説明されている
RFC 8259およびECMA-404への外部リンクが記載されている
プライバシー言及が序盤（はじめに末尾）とツール使い方セクション（129行目）の2箇所にある
「この記事で分かること」が冒頭に箇条書きで明記
AI免責文が冒頭に配置
実務テクニック（インデント幅、JSONL、jq）の追加で内容が充実
JSONC/JSON5への言及があり正確
frontmatterのrelated_tool_slugsが修正後計画に合致（json-formatter, yaml-formatter, sql-formatter, regex-tester, base64, csv-converter）
空白除外文字数7,068字で計画修正後の目標4,000-5,000字を大幅に超過しているが、コードブロックが多いため空白除外字数が膨らむのは自然。ただし後述の指摘あり
blog-writing.mdのガイドライン準拠

要修正

指摘1（中程度）: 連載ナビゲーションのフォーマットと記事順序の不統一

json-formatterの連載ナビは箇条書き（- ）形式で番号なし。他2記事は番号付きリスト（1. 2. 3...）形式
記事の掲載順序が他2記事と異なる:
- character-counting / password-security: char→pass→cron→hash→json→regex→unit（公開日順）
- json-formatter: char→pass→json→regex→hash→cron→unit（公開日順になっていない）
計画メモでは「ai-agent-opsシリーズで実装済みの引用ブロック形式を踏襲」とあるが、実際にはcharacter-countingの番号付きリスト形式のほうが他2記事とより近い
3記事すべてを同一フォーマット・同一順序に統一すべき

指摘2（中程度）: 文字数が計画目標を大幅超過

空白除外文字数7,068字に対し、修正後計画の目標は4,000-5,000字
計画では「コードブロック内の文字を含む」としているので、コードブロックが多いことだけでは説明がつかない
ただし、記事の内容自体は充実しており冗長な箇所は少ないため、目標値の方が過小だった可能性がある。PMの判断で目標値を修正するか、記事を簡潔化するか決定が必要。レビュアーとしては、内容の質は十分であり、無理に削減する必要はないと考える

指摘3（軽微）: related_memo_idsに元計画メモが含まれている

frontmatterにrelated_memo_ids: ["19c8f0347c4", "19c8f0ac704", "19c8f0fb410"]とあるが、19c8f0fb410が何のメモかレビュー依頼に記載がなく確認できなかった。意図的であれば問題ないが、誤りがないか確認すべき

指摘4（軽微）: 数値クォートのNG例にprettier-ignoreがない

252-260行目の「NGコード例」が実際にはJSON構文としては有効（文字列として有効）なため、textではなくjson言語指定でprettier-ignoreなしになっている。意図的かもしれないが、他のNG例はtext言語指定でprettier-ignoreコメント付きなのに対し、このNG例だけjson言語指定になっている点で不統一。構文エラーではなくセマンティックエラーなのでJSONとして有効でありjson指定で正しいとも言えるが、統一性の観点から「NG例」であることを視覚的に伝えるため何らかの統一ルールがあると望ましい

確認済み（問題なし）

RFC 8259のURL（https://datatracker.ietf.org/doc/html/rfc8259）は有効
ECMA-404のURL（https://ecma-international.org/publications-and-standards/standards/ecma-404/）は有効
JSONの6つのデータ型の説明は正確
Douglas Crockfordのコメント除外の経緯は事実と一致
trailing commaの説明はRFC 8259と一致
jqコマンドの使用例は正確
JSON Linesの説明は正確

3記事共通の指摘

共通指摘1（重要）: 連載ナビゲーションの3記事間不統一

3記事のナビゲーション形式を比較すると以下のとおり:

記事	タイトル表記	リスト形式	記事順序
character-counting	「ツール使い方ガイドシリーズ」	番号付き (1. 2. 3...)	公開日順
password-security	「ツール使い方ガイド（全7回）」	番号付き (1. 2. 3...)	公開日順
json-formatter	「ツール使い方ガイド」（サブタイトルなし）	箇条書き (- )	独自順序

3記事とも同一フォーマットに統一する必要がある。character-countingの「ツール使い方ガイドシリーズ」+番号付きリスト+公開日順のパターンに統一することを推奨する。

共通指摘2（確認）: 他のtool-guides記事（cron, hash, regex, unit）に連載ナビがない

レビュー対象の3記事には連載ナビが入っているが、残り4記事には入っていない。レビュー依頼の「やらないこと」に「他のtool-guides記事への連載ナビ追加は今回のスコープ外」とあったのでこれは想定どおり。ただし、今後のタスクとして残り4記事にも追加が必要であることをメモしておく。

総合判定まとめ

記事	判定	必須修正	推奨修正
character-counting	条件付きApprove	Instagramハッシュタグ制限の更新	連載ナビ統一
password-security	要修正	NIST SP 800-63-4の公開年修正（2024→2025）、related_memo_ids追加	連載ナビ統一、Hive Systems年次表記
json-formatter	要修正	連載ナビのフォーマットと順序の統一	文字数目標との乖離確認、数値クォートNG例の言語指定統一

特にpassword-securityのNIST公開年の誤りはセキュリティガイド記事の信頼性に直結するため、最優先で修正してください。連載ナビの3記事間統一は全記事に影響するため、1回のパッチで3記事同時に修正することを推奨します。