技術記事推敲スキル

このスキルは、技術記事の品質を向上させるための体系的な推敲を支援します。

使用タイミング

以下のような依頼があった際に、このスキルを使用してください:

「記事を推敲して」
「記事をレビューして」
「記事の品質をチェックして」
「読みやすさを改善して」
「技術記事をブラッシュアップして」

推敲の流れ

1. 記事の読み込みと全体把握

まず、記事ファイルを読み込み、以下を確認します:

記事のテーマと目的
想定読者層
記事の構成（導入・本文・まとめ）
全体の文章量とボリューム感

2. 体系的なチェック

以下の6つの観点で記事を評価し、具体的な改善提案を行います:

(1) 記事構造のチェック

導入部分: 読者の興味を引くか、記事の目的が明確か
本文構成: 論理的な流れになっているか、見出しの階層構造は適切か
まとめ: 要点が整理されているか、次のアクションが示されているか
全体のバランス: セクション間の分量は適切か

(2) 読みやすさのチェック

文章の長さ: 1文が長すぎないか（目安：60文字以内）
段落構成: 1段落1トピックになっているか
改行と空白: 適切な余白があり、視覚的に読みやすいか
見出し: 内容を的確に表現しているか
リスト: 箇条書きを効果的に使っているか

(3) 技術的正確性のチェック

用語の正確性: 技術用語は正しく使われているか
コマンド・コード: 実行可能で、エラーがないか
バージョン情報: 必要に応じてバージョンが明記されているか
前提条件: 必要な環境や前提知識が示されているか

(4) 表現の明確さ

曖昧な表現: 「〜など」「〜とか」の多用を避ける
主語の明確化: 何が・誰が・どうするのか明確か
専門用語の説明: 初出時に適切に説明されているか
代名詞の使用: 「これ」「それ」が指す対象は明確か

(5) コードサンプルの品質

可読性: インデント、コメント、変数名は適切か
完全性: そのまま動作する完全なコードか、一部の抜粋か明示されているか
説明: コードの前後で十分な説明があるか
シンタックスハイライト: 言語指定がされているか

(6) ターゲット読者への適切さ

難易度: 想定読者のレベルに合っているか
前提知識: 読者が持つべき前提知識は示されているか
説明の詳しさ: 初心者向けなら丁寧に、上級者向けなら簡潔に

3. 推敲の4つの技法の適用

石原尚氏の推敲手法を技術記事に適用します:

「切り分ける」

長すぎる段落や文章を適切に分割
1つの見出しに複数のトピックが混在している場合、見出しを増やす
長いコードブロックを機能ごとに分割

「並び替える」

論理的な順序に再構成（例: 前提条件 → 基本 → 応用）
重要度の高い情報を前に配置
時系列や因果関係に沿った順序に

「繋ぎ方を変える」

セクション間の接続を改善（接続詞、遷移文の追加）
見出しレベルの調整
箇条書きと本文の使い分け

「削り落とす」

冗長な表現を簡潔に
テーマから外れた内容を削除
同じ内容の重複を削減
不要な修飾語を削除

出力フォーマット

推敲結果は以下の形式で提示します:

# 技術記事推敲レポート

## 総合評価
[記事の現状と全体的な印象]

## 主な改善ポイント

### 1. 記事構造
- [具体的な指摘と改善案]

### 2. 読みやすさ
- [具体的な指摘と改善案]

### 3. 技術的正確性
- [具体的な指摘と改善案]

### 4. 表現の明確さ
- [具体的な指摘と改善案]

### 5. コードサンプル
- [具体的な指摘と改善案]

### 6. ターゲット読者への適切さ
- [具体的な指摘と改善案]

## 推敲の4技法による具体的修正案

### 切り分けるべき箇所
[行番号と具体的な修正案]

### 並び替えるべき箇所
[セクション名と具体的な修正案]

### 繋ぎ方を変えるべき箇所
[行番号と具体的な修正案]

### 削り落とすべき箇所
[行番号と具体的な修正案]

## 優先的に対応すべき項目TOP3
1. [最も重要な改善点]
2. [次に重要な改善点]
3. [その次に重要な改善点]

## 良い点（維持すべきポイント）
- [記事の優れている点を具体的に]

実行手順

記事ファイルの読み込み: Readツールで記事を読み込む
全体分析: 記事の構成とテーマを把握
6つの観点でチェック: 各項目を順次評価
4つの技法を適用: 具体的な修正案を作成
レポート作成: 上記フォーマットで推敲結果をまとめる
ユーザーへの確認: 修正を適用するか、ユーザーに確認する

注意事項

元の意図を尊重: 著者の意図や文体を損なわない範囲で提案する
具体的な指摘: 「わかりにくい」ではなく「○○が不明確」と具体的に
ポジティブな指摘: 良い点も積極的に伝える
優先順位: すべての指摘を適用する必要はなく、重要度を示す
実行可能性: 修正が容易な順に並べ、段階的改善を可能にする

ツールの使用

このスキルでは以下のツールを使用します:

Read: 記事ファイルの読み込み
Grep: 特定パターンの検索（例: 長すぎる文の検出）
Edit または Write: ユーザーが承認した修正の適用

記事の品質向上を通じて、読者により価値のある技術情報を届けることを目指します。