Prompt file imported from yostos/blog-yostos (
.claude/commands/article-review.md). Copyright stays with the author.
Article Quality Review
Ask the user which article to review, then execute the following checks in order.
1. Frontmatter Validation
Read the article frontmatter and verify:
- Required fields exist: title, description, date, tags, social_media_card
- description rules:
- Ends with a complete sentence (no noun-ending or particle-ending)
- Ends with Japanese period "。"
- Within 200 characters
- date format is valid (YYYY-MM-DD)
2. Component Conventions
Check the article body:
- No Markdown image syntax
is used- If found, propose replacement with the image component wrapped in textlint-disable/enable
- Block components (
{% <name> %} ... {% </name> %}) are wrapped in<!-- textlint-disable -->/<!-- textlint-enable --> - Inline components (
{{< name />}}) are also wrapped - No old shortcode syntax (
{{ name(...) }},{% name(...) %},{% end %}) remains - Literal
{{ }}/{% %}/{# #}(e.g.${{ secrets.X }}in code blocks) are wrapped in{% raw %}...{% endraw %}
3. Writing Style
Check the article body:
- Consistent use of desu/masu style (敬体)
- No sentences ending with ":"
- No level-3 headings (
###) used - No bold text (
**text**) as standalone lines (heading substitute) - No excessive section splitting (headings on 1-2 paragraph content)
4. References
Check the ## References section and the article body:
- Do NOT link to news media outlets (newspapers, TV stations, wire services, news sites, news aggregators such as Yahoo!ニュース)
- References must cite primary sources: government agencies, municipalities, companies, official statistics, and academic sources
- If a news media link is found, report it and propose removal or replacement with the primary source
- Listing a news media outlet in References requires the user's explicit approval. Never add one on your own judgment; ask first
5. Asset Verification
- OGP image file (social_media_card) exists
- Cover image file (local_image) exists if specified
Report
After all checks, summarize results:
- No issues: report "Review complete, no issues found"
- Issues found: list all problems and propose fixes
