| name | write-post |
| description | 新しいブログ記事の作成を支援するスキル。トピックに応じた記事パターン(技術移行、ツール作成、学習記録、問題解決、アップデート報告、振り返り)の選定、MDXファイルのスキャフォールド、セクション構造の提案を行う。「記事を書く」「新しいポストを作成」「ブログ記事を書きたい」「write a post」「create a new article」などのリクエストで使用する。
|
ブログ記事作成
筆者のスタイルガイドに基づいて新しいブログ記事の作成を支援するスキル。
スタイルガイド
以下のスタイルガイドを必ず読んでから作業を開始すること:
@references/writing-style-guide.md
ワークフロー
Step 1: トピックと記事タイプの確認
ユーザーにトピックを確認し、スタイルガイドの「記事構成パターン」に基づいて最適な記事タイプを判定する:
- パターンA: 技術移行・導入 — 技術やサービスの移行・導入の報告
- パターンB: ツール・プロダクト作成 — 自作ツールやプロダクトの紹介
- パターンC: 学習記録 — 技術学習の経過記録
- パターンD: 問題解決 — 技術的問題の発見から解決まで
- パターンE: アップデート報告 — ライブラリやツールのアップデート変化の報告
- パターンF: 振り返り・エッセイ — 年末振り返りなどエッセイ的な記事
判定した記事タイプとその理由をユーザーに提示し、合意を得る。
Step 2: ファイルのスキャフォールド
- ファイル名を決定:
_posts/YYYY-MM-DD-slug.mdx(日付は今日、slugはトピックから英語で生成)
- フロントマターを生成:
---
title: "記事タイトル"
description: "導入と対応する1-3文の概要"
publishedTime: "YYYY-MM-DDTHH:mm:ssZ"
tags: [関連タグ]
---
- 記事タイプに応じたセクション構造(h2見出し)を配置
Step 3: 執筆支援
ユーザーと対話しながら各セクションの執筆を進める。以下に注意:
- 文体: 「です・ます」調、控えめな主張、適度な口語表現(スタイルガイド参照)
- 導入の重要性: 「なぜやったか」は「何をやったか」と同等以上に重要
- コード例: 必要最小限。言語指定必須(例: ```tsx:ファイル名.tsx)
- 外部リンク:
<OgpCard url="..." /> コンポーネントを使用
- 過去記事参照:
[記事タイトル](ファイル名) 形式でリンク
- 見出し階層: h2 → h3。h1は不使用
Step 4: 完了後
記事の執筆が完了したら、/review-post でレビューすることを提案する。