human-writing について
Human Writingは、人が読む文章の作成や推敲を支援するスキルです。モード選択から文章の原則の適用、AIらしい表現の除去、最終確認までを案内します。
主な機能
- 01執筆モードと読者の選択
- 02文章作成の原則の適用
- 03文章の作成と推敲
- 04よくあるAI文体の除去
- 05チェックリストによる草稿確認
活用シーン
- 01プロジェクト紹介文の作成
- 02技術文書の文章部分を推敲
- 03READMEやリポジトリ紹介の編集
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ timlai666/ skills --skill human-writingインストール後、Claude Code で/human-writingを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/ai-writing-patterns.mdfinal-checklist.mdhuman-writing-examples.mdhuman-writing-principles.mdmode-selection-and-language-rules.md詳細
人が書いた文章
概要
一から文章を書く場合も、下書きを推敲する場合も、人が読む文章にはこれを使います。読者が情景を思い浮かべ、行動に移せる文章を目指し、AI が書いたと感じさせる痕跡を残さないようにします。
コード、JSON、SQL、シェルコマンドなど、構造化された出力には適用しないでください。別のスキルが形式や主題を担当する場合は、そのスキルを使って内容を計画し、文章にはこのスキルを使います。
プロジェクトの紹介文、README ファイル、リポジトリの説明にもこのスキルを使います。技術文書と文章が混在している場合は、コマンド、コード例、API 識別子の正確さを保ちながら、文章部分に執筆ルールを適用します。
このファイルでは手順を示します。ルールはリンク先のリファレンスに記載されています。記憶に頼って要約するのではなく、各手順で指定されたリファレンスを読んでください。
ワークフロー
-
モードを選びます。 references/mode-selection-and-language-rules.md を読みます。
rewriteとgenerateのどちらにするかを決め、読者と目的を特定し、言語を合わせて、groundedまたはvoicedを選びます。 -
原則と例を確認します。 references/human-writing-principles.md を読み、次に下書きを作成する前に references/human-writing-examples.md を最後まで読みます。読者が推測しなければならない点がまだ残る書き直し例も含め、具体性、読者の状況、構成、語彙、リズム、トーン、句読点に関するルールを、例がどのように自然な文章に落とし込んでいるかを確認します。
-
下書きを書きます。 原則と例が示す、具体的な詳細、読者の状況、構成、語彙、リズム、トーン、句読点に関する内容を適用します。
-
AI らしいパターンを取り除きます。 references/ai-writing-patterns.md を読みます。意味、事実、意図を変えずに、記載されているパターンをすべて取り除きます。
-
完成した文章を確認します。 references/final-checklist.md を読みます。実際の文章に照らして各項目を確認し、問題があれば修正して、もう一度確認します。
-
継続中のタスクの進捗を報告します。 継続中のタスクでは、各応答の最後に、納品物には含めず会話上の返信に、簡潔な進捗バーを付けます。元の目標に沿って、合意した項目のうち確認済みの完了数と全項目数、現在の作業、完了までに残っている内容を示します。受け入れ待ちは別に示します。範囲が明示的に変更されない限り、分母は一定に保ちます。総数が不明な場合は、割合や完了予定日を作り出さず、マイルストーンを示します。合意した完了条件と納品条件をすべて満たした場合に限り、100% とします。