wechat-tech-writer

WeChat公式アカウント向け技術記事ライティングアシスタント

⚠️ 基本原則

必ず厳守する5つのポイント

1. 🎯 カバー画像は必須です

   • 記事ごとに、目を引くテーマカバー画像を1枚生成する必要があります
   • カバー画像は本文中の画像とは別に用意し、最初の画像として掲載します

2. 画像内の文字は中国語にする

   • 生成する画像内の文字はすべて簡体字中国語にします
   • プロンプトで「text in simplified Chinese, minimal text, accurate」と明確に指定します

3. 画像の枚数を調整する

   • カバー画像：1枚（必須）
   • 本文中の画像：0～2枚（必要に応じて生成）
   • 判断基準：データ比較がある場合は比較図を生成、複雑な構成がある場合は構成図を生成、それ以外の場合は生成しない

4. 記事には本文のみを出力する

   • ❌ 「参考資料」「画像の説明」「メリット・デメリットの説明」などのセクションを追加しないでください
   • ✅ 残すのは「タイトル＋カバー画像＋本文＋最後のまとめ」のみです

5. リンクはプレーンテキスト形式にする

   • ❌ 誤り：[公式サイト](https://example.com/)
   • ✅ 正しい：公式サイト：https://example.com/

---

全体のワークフロー

ステップ1：ユーザーの要望を理解して計画する

ユーザーがトピックを入力したら、まず次のことを行います。

1. テーマの種類を明確にする

   • AI大規模モデル：機能や特徴、利用シーン、競合製品との比較
   • オープンソースツール：主要機能、インストールと使い方、活用事例
   • 技術的な概念：原理の説明、実際の活用、今後の動向
   • ニュース：背景、影響分析、業界の反応

2. 記事の切り口を決める

   • ニュース記事：速報性＋網羅性
   • 紹介記事：分かりやすさ＋実用性
   • レビュー記事：客観性＋データに基づく評価
   • チュートリアル記事：実行のしやすさ＋詳細さ

---

ステップ2：質の高い情報源を検索する

WebSearch ツールを使用して、3～5回検索します。

検索方法：

• 第1回：公式情報（「{製品名} 公式ドキュメント」、「{製品名} GitHub」）
• 第2回：技術解説（「{製品名} 詳細な紹介」、「{製品名} チュートリアル」）
• 第3回：比較・レビュー（「{製品名} vs {競合製品}」、「{製品名} レビュー」）
• 第4回：追加検証（最初の3回の結果に基づき、不足している情報を補足）

品質基準：公式ドキュメント、著名な技術ブログ、信頼できるメディアの報道を優先します。

---

ステップ3：コンテンツを取得して分析する

WebFetch を使用して、代表的な記事を2～5本選び、全文を取得します。

優先順位：

1. 公式ドキュメントまたは公式ブログ（信頼性）
2. 技術ブログ：掘金、CSDN、Medium（詳しさ）
3. GitHub README.md（実用性）
4. 信頼できるメディアの技術報道（網羅性）

抽出するポイント：

• 主要な機能と特徴
• 技術原理（簡略版）
• 利用シーンと事例
• メリットと制約
• 最新情報と今後の展開

---

ステップ4：コンテンツを書き換えて記事を作成する

基本原則：

• 自分の言葉で再構成し、原文をそのまま転載しない
• 一般ユーザー向けに書き、専門的になりすぎないようにする
• 分かりやすい比喩や具体例を加える
• 事実の正確性を保つ

推奨する記事構成（2000～3000字）：

1. 引子（100-200字）
   用一个场景或问题引入话题

2. 是什么（300-500字）
   产品/技术的基本介绍
   用类比帮助理解核心概念

3. 能做什么（500-800字）
   核心功能特性
   实际应用场景
   具体使用案例

4. 为什么选择它（300-500字）
   独特优势
   与同类产品对比

5. 如何开始（200-300字）
   快速上手指引
   提供官方资源链接（纯文本格式）

6. 总结（100-200字）
   总结要点
   展望未来

文体：

• 「私たち」や「あなた」などの二人称を適度に使い、親しみやすさを高める
• 絵文字を適度に使う（使いすぎない）
• 長文より短文を優先する（25字以内）
• 並列構造や小見出しを多く使う

詳しい執筆ガイド：references/writing-style.md を参照してください。

---

ステップ5：テーマカバー画像を生成する（必須）

⚠️ このステップは必須です：記事ごとに、目を引くテーマカバー画像を1枚生成する必要があります。

すぐに始める

ポイント：

• テーマに合わせて配色を選ぶ：AI関連は青紫のグラデーション、ツール関連は緑橙のグラデーション、効率化関連は橙桃色のグラデーション
• タイトル：テーマのキーワード（中国語と英語を組み合わせる）
• サブタイトル：核心となる価値を一文で表す（簡体字中国語）
• ビジュアル要素：テーマに関連する3D要素、光の効果、粒子

すばやく生成するコマンド：

cd /root/.claude/skills/wechat-tech-writer

python scripts/generate_image.py \
  --prompt "A stunning cover for [主题], gradient [配色], title '[标题]', subtitle '[副标题]' in Chinese..." \
  --api gemini \
  --output cover.png

品質確認リスト：

• 中国語の文字が明瞭で読みやすく、文字化けしていない
• 色鮮やかで、目を引く
• 視覚的な焦点が明確（タイトルが最も目立つ）
• 全体がテーマに合っている

詳細ガイド

カバー画像の設計原則、プロンプトのテンプレート、実行手順の全容：

👉 references/cover-image-guide.md を参照してください

内容：

• 5種類の記事向けの配色案
• 5種類のプロンプトテンプレート（AI関連、ツール関連、効率化関連、ニュース関連、チュートリアル関連）
• 詳細な生成手順と品質確認方法
• よくある問題のトラブルシューティング

---

ステップ6：本文に応じてほかの画像を生成する（必要に応じて）

⚠️ このステップは任意です：本文で本当に必要な場合に限り、追加の画像を生成します（0～2枚）。

判断基準

阅读文章内容
  │
  ├─ 有明确数据对比？ → 是 → 生成性能对比图
  │
  ├─ 有复杂技术架构？ → 是 → 生成架构示意图
  │
  └─ 其他情况 → 不生成配图

典型的なケース：

• 製品レビュー記事：カバー画像＋性能比較図（合計2枚）
• 技術解説記事：カバー画像＋技術構成図（合計2枚）
• ニュース記事：カバー画像のみ（合計1枚）
• チュートリアル記事：カバー画像のみ（合計1枚）

詳細ガイド

本文中の画像の種類、プロンプトのテンプレート、生成手順の全容：

👉 references/content-images-guide.md を参照してください

内容：

• 5種類の画像（棒グラフ、構成図、比較図、フローチャート、レーダーチャート）
• 各種類のプロンプトテンプレート
• データの抽出と検証方法
• 記事に挿入する際のベストプラクティス

---

ステップ7：記事を出力する

Write ツールを使用して、Markdown形式の記事ファイルを作成します。

ファイルの内容構成：

# 文章标题

![封面图](cover.png)

## 第一部分标题

正文内容...

![配图1](comparison.png)  

*图：简短说明*

## 第二部分标题

正文内容...

## 总结

结尾总结段落...

重要な注意事項：

• ❌ 「参考資料」「画像の説明」「関連記事」などの追加セクションを加えないでください
• ❌ Markdownのハイパーリンク形式 [テキスト](URL) を使用しないでください
• ✅ 出力するのは「タイトル＋カバー画像＋本文＋まとめ」のみです
• ✅ リンクはプレーンテキスト形式にします：公式サイト：https://example.com/

出力ファイル：

• 記事ファイル：{主题名称}.md
• カバー画像：cover.png
• 本文中の画像（ある場合）：performance-comparison.png、architecture.png など

---

品質確認リスト

出力前に、必ず次の項目を確認してください。

コンテンツの品質

• 内容をすべて自分の言葉で表現しており、長文をそのまま転載していない
• 技術用語を分かりやすく説明している
• 具体例と利用シーンを含んでいる
• 事実に関する情報が正確である
• 記事の構成が明確で、読みやすい
• 自然で流暢な文章で、公式アカウントの記事スタイルに合っている
• 文字数が2000～3000字である

画像の品質（必須確認）

• ✅ テーマカバー画像を生成済み（必須）
• カバー画像の色が鮮やかで、魅力的である
• カバー画像内の中国語が明瞭で読みやすく、文字化けしていない
• カバー画像の視覚的な焦点が明確で、テーマに合っている
• 本文中の画像がある場合、データが正確である
• すべての画像が出力ディレクトリに保存されている
• 画像のスタイルが統一されている（配色やデザインスタイルに一貫性がある）

書式のルール

• カバー画像が記事内の最初の画像として、タイトルの直後に配置されている
• リンクがプレーンテキスト形式である（Markdownのハイパーリンクではない）
• 「参考資料」「画像の説明」などの追加セクションがない
• ファイル名が命名規則に従っている（中国語の特殊文字を含まない）

---

参考ドキュメント

詳細ガイド

• writing-style.md - 詳細な文体ガイドと例
• cover-image-guide.md - カバー画像生成の完全ガイド（設計原則、プロンプトテンプレート）
• content-images-guide.md - 本文中の画像生成ガイド（判断基準、図表の種類）
• image-guidelines.md - 画像の選択と処理の基準（実画像の抽出）
• ai-image-generation.md - AI画像生成の技術的な詳細
• api-configuration.md - 画像生成APIの設定ガイド（Gemini/DALL-Eのキー設定）
• fact-checking.md - 事実確認のポイント

使用例

• EXAMPLES.md - 完全な使用例（異なる種類の記事を3つ）
  • 例1：技術ニュース／情報記事（VSCodeの名称変更に関する出来事）
  • 例2：AI大規模モデルの紹介（Claude Sonnet 4）
  • 例3：開発ツールの紹介（LangChain）

实用脚本

• scripts/generate_image.py - 生图API调用脚本（支持Gemini/DALL-E/Claude原生）
• scripts/generate_cover_optimized.py - 优化的封面图生成脚本
• scripts/generate_temp.py - 临时图片生成工具

---

快速参考

文章类型决策树

用户输入话题
  │
  ├─ 包含"最新"、"发布"、"更名" → 新闻资讯类
  │   └─ 搜索：官方公告 + 社区反应
  │       └─ 配图：仅封面图（1张）
  │
  ├─ 是AI模型/工具名称 → 介绍类
  │   ├─ AI大模型 → 功能+评测+案例
  │   │   └─ 配图：封面 + 可选性能对比图（1-2张）
  │   │
  │   └─ 开发工具 → 文档+教程+案例
  │       └─ 配图：封面 + 可选架构图（1-2张）
  │
  └─ 是技术概念 → 概念科普
      └─ 搜索：定义+原理+应用
          └─ 配图：封面 + 可选概念对比图（1-2张）

封面图配色速查

文章类型	配色方案	色彩代码
AI/科技类	蓝紫渐变	#1a1f5c → #7c3aed
工具/效率类	绿橙渐变	#10b981 → #f97316
数据/分析类	蓝绿渐变	#0891b2 → #06b6d4
创意/设计类	粉紫渐变	#ec4899 → #a855f7

常用命令

生成封面图（Gemini）：

python scripts/generate_image.py \
  --prompt "提示词" \
  --api gemini \
  --output cover.png

生成封面图（DALL-E高清）：

python scripts/generate_image.py \
  --prompt "提示词" \
  --api dalle \
  --quality hd \
  --size 1792x1024 \
  --output cover.png

---

典型工作流示例

示例：AI大模型介绍文章

# 步骤1：明确主题
主题类型 = "AI大模型介绍"
目标读者 = "AI用户、技术爱好者"

# 步骤2-3：搜索和抓取
搜索("Claude Sonnet 4 官方介绍")
搜索("Claude Sonnet 4 vs GPT-4 性能对比")
抓取(官网产品页 + 评测文章 + API文档)

# 步骤4：改写创作
写作(
  引子="实际应用场景引入",
  正文="功能特点 + 性能对比 + 应用案例 + 上手指引",
  字数=2800
)

# 步骤5：生成封面图（强制）
generate_image(
  prompt="Claude Sonnet 4 封面，蓝紫渐变，标题+副标题...",
  api="gemini",
  output="cover.png"
)

# 步骤6：内容配图（按需）
if 文章有性能对比数据:
    generate_image(
      prompt="性能对比柱状图，Claude vs GPT vs Gemini...",
      output="performance-comparison.png"
    )

# 步骤7：输出
write_file("Claude_Sonnet_4介绍.md", 文章内容)

---

注意事项

✅ 应该做的

1. 每次都生成封面图 - 这是强制要求，不可省略
2. 验证中文清晰度 - 生成后检查文字是否清晰
3. 控制图片数量 - 总数不超过3张（1封面 + 0-2内容）
4. 保持风格统一 - 如有多张配图，配色和设计语言要一致
5. 链接用纯文本 - 不使用markdown超链接格式

❌ 不应该做的

1. 不要跳过封面图 - 即使时间紧也必须生成
2. 不要过度配图 - 宁缺毋滥，没价值的图不生成
3. 不要照搬原文 - 必须用自己的语言改写
4. 不要添加额外章节 - 如"参考资料"、"图片说明"
5. 不要忽视质量检查 - 输出前必须过一遍检查清单

---

提升质量的关键点

1. 选题要精准：理解用户真正想了解什么
2. 信息要准确：事实和数据必须可靠
3. 语言要通俗：技术术语要解释，多用比喻
4. 结构要清晰：小标题、列表、图表帮助阅读
5. 封面要吸睛：配色鲜明、标题醒目、主题契合

---

记住：这个技能的目标是生成高质量、易读、吸引人的微信公众号科普文章。每个步骤都很重要，不可省略！