writing-tech-post

エンジニアリング記事の執筆

依頼された成果物（新しい記事、アウトライン、対象を絞った書き直し、公開前レビュー）を作成します。承認済みのブリーフと根拠を再利用します。読者と素材に合った構成を選びます。小規模な編集のために、執筆ワークフロー全体をやり直す必要はありません。

1. 利用可能なコンテキストから、読者、主旨、裏付けのある事実を確認します。依頼された出力に重大な影響を与える情報が不足している場合に限り、質問します。
2. 新しい記事の場合は、有用な主要類型とアウトラインを選びます。既存の草稿の場合は、機能している構成を維持し、依頼された範囲を編集します。フロントマター、段階ラベル、深度タプル、セクションごとの根拠計画は、公開元から求められない限り、任意のツールです。
3. 仕組みと、それが重要な理由を説明します。定量的、比較的、セキュリティ関連、機能に関する主張は、適切な根拠と制約を示して裏付けます。実際の測定値、説明用の例、仮説、進行中の作業を区別します。
4. 必要に応じて、語調と流れを整えます。公開元のスタイルマトリックス、H2の疑問文の連なり、冒頭と末尾の各200語の比較は、編集上のヒューリスティックであり、普遍的な必須条件ではありません。構成を整えるために、失敗した緩和策、部分的な成功、ベンチマーク結果、教訓を捏造しないでください。
5. 外部公開の前に、該当する主張と開示義務について references/pre-publish-checklist.md を適用します。草稿の納品は公開許可を意味しません。任意のリンターはヒューリスティックを報告するものであり、裏付けのない主張や開示の判断に対する責任は、人間による事実確認にあります。

参考資料の案内

すべての段階の資料を読むのではなく、現在の類型または編集上の課題に関する資料を読みます。

• 構成：references/archetypes-and-structure.md。深度の診断は任意で、references/depth-and-abstraction.md を参照します。
• インシデント：references/postmortems.md。移行：references/migrations.md。パフォーマンス：references/performance-deep-dive.md。
• AI／エージェント：references/ai-and-agents.md。セキュリティ／信頼性：references/security-and-reliability.md。
• 根拠／素材：references/evidence-diagrams-code.md。ナラティブ：references/narrative-and-pacing.md。
• 文体／開示：references/voice-and-disclosure.md。公開元の文体指定がある場合：references/publisher-voice-matrix.md。特定の文章上の問題：references/anti-patterns.md。

有用な場合に限り、assets/outline.<archetype>.md テンプレートを使用し、該当しないセクションは省略します。このスキルの絶対パスを使ってヘルパーを実行します：python3 <writing-tech-post-dir>/scripts/lint-post.py <draft.md>。--strict を指定すると、明示的に選んだ編集上のゲートに対して、ヒューリスティックによる警告を失敗として扱います。リンターで問題が検出されなくても、事実が正しいことや開示の準備が整っていることの証明にはなりません。