Communitygithub.com

1999AZZAR/human-writing-skill

正確で自然なテクニカルライティング、ドキュメント作成、編集、AIパターンレビューのためのエージェントスキル。

human-writing-skill とは?

このスキルは、Claude Code、Cursor、CodexなどのAIコーディングエージェント向けに設計されており、技術文書の作成・編集において、人間らしい正確で自然な文章を生成することを支援します。主な目的は、事実を尊重し、AI検出を回避するための最適化ではなく、内容の正確性と明確さを向上させることにあります。このスキルは、リポジトリのスタイルガイドに従い、具体的な名詞や動詞を優先し、誇張表現やプロモーション的な言い回しを排除します。また、定型文やAIらしい表現を診断するためのリファレンス(ai-tells.md)を活用し、一般的で機械的な文体を改善します。ワークフローは、要求の分析、オリジナルの主張と声の保持、プロフェッショナル基準に基づく編集、最終チェック(事実確認、用語の一貫性、プロモーション的表現の削除など)で構成されています。対応プラットフォームはAIエージェント全般であり、エンジニアリング文書、チュートリアル、APIリファレンスなど、幅広い技術文書に適用可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add 1999AZZAR/human-writing-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Human writing(ヒューマンライティング)

読み手に適した、正確で直接的な文章を作成します。AI検出を回避するための最適化ではなく、テキストの品質向上を目的とします。

優先事項

  1. 事実、意味、制約、および筆者が意図した確実性のレベルを保持する。
  2. リポジトリのスタイルガイドと周辺の文章を優先し、その後にこのスキルのデフォルトを適用する。
  3. ドキュメントの目的、対象読者、期待される詳細レベルに合わせる。
  4. プロモーション的な表現よりも、具体的な名詞、正確な動詞、証拠を優先する。
  5. 必要な専門用語や自然な構文は、スタイル警告リストに含まれていても使用する。

ワークフロー

  1. リクエスト、ソース素材、周辺のドキュメントを精査する。対象読者、目的、必要な形式、ハウススタイルを特定する。
  2. 書き直しの場合、ユーザーが変更を要求しない限り、元の主張と声を保持する。暗黙のうちにコミットメントを追加または削除しない。
  3. プロフェッショナル基準に従って草稿を作成または編集する。
  4. 散文が一般的、プロモーション的、反復的、または機械的な構造に見える場合、定型文的な書き方のシグナルを確認する。これらを禁止形としてではなく、診断の手がかりとして扱う。
  5. 以下の最終チェックを実行し、正確性や理解の向上に資する変更のみを行う。

最終チェック

  • 事実に基づく主張は、提供された資料または検証可能なソースで裏付ける。
  • 測定値、ベンチマーク、バージョン、引用、引用文、日付、RFCの適用可能性を決して捏造しない。検証が不可能な場合は、証拠を求めるか、その主張を条件付きにする。
  • 編集時には意味と不確実性を保持する。未解決の矛盾を推測で解決するのではなく、明示する。
  • 結果がリクエストに応え、必要なセクション、手順、警告、制約をすべて含んでいることを確認する。
  • 用語を一貫して使用する。ツールやソース素材が許す場合、コマンド、コード、リンク、例を検証する。
  • 曖昧な帰属、根拠のない解釈、繰り返し、プロモーション的な埋め草を削除する。
  • 見出し、リスト、表、強調、絵文字は、対象フォーマットと確立されたスタイルに合致する場合にのみ保持する。
  • 結果を流れを意識して一度読む。単にバリエーションのためではなく、現在のリズムが機械的に感じられる場合に、文や段落の形状を変える。

参考文献

関連スキル