Back to Details

tech-article-humanizer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Tech Article Humanizer

技术文章类人化工具

Overview

概述

This skill transforms technical article drafts into authentic, human-like Japanese technical articles that are indistinguishable from content written by experienced developers. It follows a comprehensive style guide that eliminates AI writing patterns and produces natural, engaging technical content.
此技能可将技术文章草稿转换为真实、类人风格的日语技术文章，其质量可媲美资深开发者撰写的内容。它遵循一套全面的风格指南，消除AI写作痕迹，产出自然、引人入胜的技术内容。

Workflow

工作流程

1. Understand Source Material

1. 理解素材

Accept input in any of these formats:
  • Markdown draft with rough structure
  • Bullet points or outline
  • Raw notes or technical concepts
  • Existing article that needs humanization
Ask the user: "Please provide the source material for the article (file path or content)"
接受以下任意格式的输入：
  • 具有大致结构的Markdown草稿
  • 项目符号或大纲
  • 原始笔记或技术概念
  • 需要类人化的现有文章
向用户询问：「请提供文章的素材（文件路径或内容）」

2. Load Style Guide

2. 加载风格指南

CRITICAL: Before generating any article content, read the complete style guide:
references/style-guide-human-tone.md
This guide contains:
  • Forbidden patterns that must have ZERO violations
  • Polite form (です/ます) distribution requirements
  • Authenticity markers and human-like writing patterns
  • Technical accuracy standards
  • Pre-submission checklist
Do NOT proceed without reading this guide completely.
关键要求：在生成任何文章内容之前，必须完整阅读风格指南：
references/style-guide-human-tone.md
该指南包含：
  • 必须零违反的禁用模式
  • 礼貌体（です/ます）的使用要求
  • 真实感标识与类人写作模式
  • 技术准确性标准
  • 提交前检查清单
未完整阅读本指南前，请勿继续操作。

3. Generate Article

3. 生成文章

Follow the style guide strictly while generating content:
Critical Requirements (Publication Blockers):
  • ZERO sentence-ending contracted forms (てる。てた。てます。)
  • ZERO paragraph-initial "で、"
  • ZERO colons (：) in prose before code/lists
  • MINIMUM 15+ です/ます sentence endings
  • TARGET 45-60% です/ます distribution
  • Valid frontmatter (title, emoji, type, topics, published)
Authenticity Markers (for 8.0+ quality):
  • Show code evolution (bug → fix, V1 → V2)
  • Include 2-3 unresolved elements
  • Add ecosystem context (GitHub refs, community mentions)
  • Vary depth dramatically (15 para on favorite topic, 2 sentences on boring)
  • Maximum 6-7 H2 sections
严格遵循风格指南生成内容：
关键要求（发布必备条件）：
  • 禁止使用句末缩略形式（てる。てた。てます。）
  • 禁止段落开头使用「で、」
  • 正文内容中代码/列表前禁止使用冒号（：）
  • 至少使用15个以上以です/ます结尾的句子
  • 目标：です/ます的使用占比为45-60%
  • 有效的前置元数据（标题、表情符号、类型、主题、发布状态）
真实感标识（达到8.0+质量）：
  • 展示代码演进过程（错误→修复，V1→V2）
  • 包含2-3个未解决的内容点
  • 添加生态系统背景（GitHub引用、社区提及）
  • 大幅调整内容深度（感兴趣的主题写15段，枯燥的内容写2句）
  • 最多设置6-7个H2章节

4. Save Output

4. 保存输出

Save the generated article to:
outputs/YYYYMMDD-{topic-slug}.md
Example: 
outputs/20260110-typescript-const-parameters.md
将生成的文章保存至：
outputs/YYYYMMDD-{topic-slug}.md
示例：
outputs/20260110-typescript-const-parameters.md

5. Validation (Optional)

5. 验证（可选）

Run validation script to check for forbidden patterns:
bash
python scripts/validate_article.py outputs/YYYYMMDD-{topic-slug}.md
运行验证脚本检查是否存在禁用模式：
bash
python scripts/validate_article.py outputs/YYYYMMDD-{topic-slug}.md

Usage Examples

使用示例

Example 1: From bullet points
User: "これを元に技術記事を作成してください"
markdown
- TypeScript 5.0の新機能
- const type parametersについて
- 使い方と利点
Agent: [Loads style guide] → Generates full article → Saves to 
outputs/20260110-typescript-const-parameters.md
Example 2: Humanize existing draft
User: "この記事を人間風にリライトして" + provides draft.md
Agent: [Loads style guide] → Rewrites following human patterns → Saves to 
outputs/20260110-rewritten-article.md
Example 3: With validation
User: "記事を生成して、バリデーションもお願い"
Agent: [Generate article] → Saves output → Runs validation → Reports results
示例1：基于项目符号生成
用户：「これを元に技術記事を作成してください」
markdown
- TypeScript 5.0の新機能
- const type parametersについて
- 使い方と利点
Agent：[加载风格指南] → 生成完整文章 → 保存至
outputs/20260110-typescript-const-parameters.md
示例2：类人化现有草稿
用户：「この記事を人間風にリライトして」+ 提供draft.md
Agent：[加载风格指南] → 遵循类人模式改写 → 保存至
outputs/20260110-rewritten-article.md
示例3：带验证的生成
用户：「記事を生成して、バリデーションもお願い」
Agent：[生成文章] → 保存输出 → 运行验证 → 报告结果

Resources

资源

scripts/

scripts/

  • validate_article.py: Validates generated articles against forbidden patterns and style requirements
Usage:
bash
python scripts/validate_article.py <article-path>
  • validate_article.py：验证生成的文章是否符合禁用模式和风格要求
使用方法：
bash
python scripts/validate_article.py <article-path>

references/

references/

  • style-guide-human-tone.md: Complete style guide for generating human-like Japanese technical articles. MUST be read before generating any content.
  • style-guide-human-tone.md：生成类人风格日语技术文章的完整风格指南。生成任何内容前必须阅读。