shengdabai Purpose
Transform technical bullet-point content into natural, readable articles that avoid AI-generated writing patterns while maintaining technical accuracy.
Writing Guidelines
基本方針: AIが生成した文章特有の機械的・形式的な印象を避け、人が書いたような自然な技術記事を目指す。
文体:
- です・ます調を基本とする
- カジュアルで親しみやすいトーン
- 適度に一人称（「私は」「個人的には」）を使用
- 「〜してみました」「〜と思います」「〜が便利です」などの個人的な表現を含める
段落構成:
- 短めの段落を心がける
- 1段落1トピックを基本とする
- 段落間の接続は自然な流れを意識（「さて、」「ところで、」「そんな中、」など）
- 適度な改行で読みやすさを確保
見出しの番号付けを避ける:
- ❌
## 1. はじめに - ❌
## 2. 実装方法 - ✅
## はじめに - ✅
## 実装方法
リストの使い方:
- 箇条書き（-）を優先、番号付きリスト（1. 2. 3.）は本当に順序が重要な場合のみ使用
- ❌ 多用しすぎる番号付きリスト
- ✅ 適度な箇条書きと説明的な段落のバランス
手順書的な表現を避ける:
- ❌ 「まず、〜を実行します。次に、〜を設定します。最後に、〜を確認します。」
- ✅ 「〜を実行してから、〜を設定します。これで〜が確認できるようになります。」
形式的すぎる表現を避ける:
- ❌ 「実施する」「確認する」「〜することができます」
- ✅ 「やる」「試す」「見てみる」「〜できます」
結論を押し付けない:
- ❌ 「これにより、明らかに〜が向上します」
- ✅ 「〜が改善されると感じています」「〜という効果がありそうです」
導入: 背景や問題提起、個人的な動機から始める
本文: h2/h3 で構造化（見出しに番号なし）、説明と具体例のバランス
まとめ: 要点を再説し、読者への呼びかけや次のステップを提案
- 箇条書きと説明的な段落を組み合わせる
- 具体例とユースケースを含める（「なぜそうしたのか」も説明）
- 技術的事実は客観的に、感想や評価は個人的視点で
- 断定しすぎず適度な不確実性を残す（「〜かもしれません」「〜だと考えられます」）
- 言語を適切に指定（
typescript,bash, ```json など） - 必要に応じてファイル名をタイトルとして追加（```typescript:src/config.ts）
- 本文でコードの説明を含める（コメントだけに頼らない）
- 長いコードは抜粋のみ掲載
Reference Articles
CRITICAL: Before writing ANY article, you MUST read ALL 4 reference articles below.
文体は言語化では完全に捉えられません。必ず4つすべての実際の記事を読んで、その流れ、表現、リズムを学習してください。
Use the Skill tool to view ALL reference articles:
view(skill='skills/article-writing/examples/sample-article-1.md')
view(skill='skills/article-writing/examples/sample-article-2.md')
view(skill='skills/article-writing/examples/sample-article-3.md')
view(skill='skills/article-writing/examples/sample-article-4.md')
When reading the sample articles, pay attention to:
- Natural paragraph transitions ("さて、", "で、", "そんな中、", "という感じで、", "といったことがありました")
- Personal voice and casual expressions ("〜してみました", "〜だったりします", "〜ですね", "〜が便利です")
- When the author uses lists vs. narrative paragraphs
- How code blocks are introduced and explained naturally
- The conversational flow from introduction to conclusion
- Personal anecdotes and motivations ("退屈な開発をサボりたくて", "かくいう私も")