IT記事添削スキル

---
name: article-review-skill
description: QiitaとZennに掲載するIT関係の記事内容を添削し、修正箇所を確認依頼するスキル。文章の正確性、わかりやすさ、スタイルガイドへの準拠を検査します
---

# IT記事添削スキル

## Purpose

QiitaとZennに掲載するIT関連記事の品質向上を支援するスキル。文法、表現、技術的な正確性、記事スタイルをチェックし、修正提案ではなく確認依頼を出します

## このスキルは以下の場合に使用してください

- QiitaまたはZennに掲載予定のIT関連記事の内容を添削したい
- 記事の可読性や説得力を改善したい
- スタイルガイドへの準拠状況を確認したい

## チェック対象

### 1. 技術的な正確性
- 記述されている技術用語、概念の正確性
- コード例の構文的正確性（※バグがないと仮定）
- APIの説明や仕様の正確性
- バージョンや推奨事項の現在の妥当性

### 2. 文章・表現の品質
- 文の構成と論理性
- 説明の順序と段階性
- 読者層の想定と説明レベルの適切性
- 専門用語と一般的な説明のバランス

### 3. スタイルガイドへの準拠
- 文末の「。」（句点）を使用しないスタイル
- 敬体・常体の一貫性
- 見出しレベルの適切性
- 箇条書きの形式統一

### 4. 構成・可読性
- 記事全体の流れと構成
- 見出しの階層構造
- 段落分け
- コード例の効果的な配置

### 5. メタデータ確認
- タイトルの適切性と長さ
- 説明文（description）の有無と内容
- タグの適切性と最大数の確認（Qiita：5個、Zenn：5個）

## 添削プロセス

1. **記事内容の読み取り** - 全体を把握
2. **チェック項目の確認** - 上記5項目を対象に分析
3. **修正箇所の特定** - 問題がある箇所を明確化
4. **修正提案の準備** - 改善案を用意
5. **確認依頼の出力** - 修正箇所を報告し承認を待つ

## 出力フォーマット

```
📝 [記事タイトル] の添削結果

🔍 チェック項目別の確認：

【技術的な正確性】
- [指摘内容（問題がない場合は「問題なし」）]

【文章・表現の品質】
- [指摘内容]

【スタイルガイド準拠】
- [指摘内容]

【構成・可読性】
- [指摘内容]

【メタデータ確認】
- [タイトル・タグなどの指摘]

---

🔧 修正が必要な箇所：

[修正箇所1]
📌 確認依頼：
- 修正前：[該当テキスト]
- 修正案：[提案内容]
- 理由：[修正理由]

[修正箇所2]
📌 確認依頼：
- 修正前：[該当テキスト]
- 修正案：[提案内容]
- 理由：[修正理由]

（複数の修正箇所がある場合）

---

✅ 修正不要の箇所：
- [特に良い点があれば記載]

--- Skill Executed (article-review-skill) ---
```

## 重要な処理フロー

**修正が必要な場合、以下のフローで対応してください：**

1. 修正箇所を明確に指摘
2. 修正案を提示
3. **「承認をお待ちしています」と確認依頼を出す**
4. ユーザーの承認を待つ
5. 承認後に初めて実際の修正を実行

修正前に承認を取ることで、ユーザーの意図と異なる修正を防ぎます

## 例外・注意点

- **コードの検証は不要** - コード例はバグが起きないものと考えます
- **技術内容の校正に注力** - 誤字よりも技術的な正確性を優先
- **スタイル統一** - 「。」がない文体での統一確認が重要
- **Qiita・Zenn特有の仕様** - 両プラットフォームの違いを考慮