Skip to content

Instantly share code, notes, and snippets.

@negipoyoc
Last active May 18, 2025 13:09
Show Gist options
  • Select an option

  • Save negipoyoc/3eefbc676c6188b99d1d1eb012bfd3ab to your computer and use it in GitHub Desktop.

Select an option

Save negipoyoc/3eefbc676c6188b99d1d1eb012bfd3ab to your computer and use it in GitHub Desktop.
Cursor記事執筆補助

CursorRulesを活用した執筆効率化の可能性

CursorRulesを用いることで、自身の文体を維持しつつ、AI特有の表現を抑えた質の高い記事を作成できる可能性があると感じています。

プロジェクトに応じたルール切り替えの利便性

CursorRulesは、プロジェクトのルートディレクトリなどに.mdcファイルとして保存することで、プロジェクトごとに異なるルールセットを適用できることに気づきました。 これにより、例えば技術記事と社内向けドキュメントでは、それぞれに適した執筆スタイルを使い分けるといった運用が考えられます。これは、執筆対象に応じて最適な表現を追求する上で、非常に便利な機能だと感じています。

AIはあくまで執筆の「補助」

以前読んだ記事(参考1参考2)にもありましたが、特に技術記事においては、筆者自身の経験や考察、例えば「ここで詰まった」「こうしたら解決した」「この仕様は少し使いにくいのでは?」といった生の声が記事の価値を大きく左右すると考えています。

そのため、中心となるコンテンツ、つまり筆者ならではの視点や体験談は人間が主体となって記述し、文章の構成や細かな表現の調整をAIに任せるという分担が、現時点での私にとって最適なバランスだと感じています。

Cursorを用いた執筆支援への期待

近年、個人ブログや技術情報サイトなどで文章を発信する機会が増えましたが、納得のいく記事を仕上げるためには数時間から数日を要することも珍しくありません。目まぐるしく情報が変化する現代において、この執筆速度は課題だと感じていました。 極端な話、記事を書き終える頃には前提となる情報が変わっている、なんてことも起こり得るわけです。

本来、記事執筆の目的は「伝えたいことを的確に読み手に届ける」ことであり、必ずしも「美しい文章を書く」こと自体が目的ではありません。この点を考慮すると、AIによる執筆支援は非常に有効な手段となり得ると考えています。

AIに期待する執筆支援の方向性

私がAIに執筆支援を求める上で、特に重視したい点は以下の3つです。

  • AIが生成する文章特有の不自然さを避けること
  • 自身の既存の文体を可能な範囲で反映させること
  • 記事全体の構成をより洗練されたものにすること

AIらしさの排除について

AIが生成した文章に見られる特徴として、以下の点が挙げられるという指摘(参考)は、私自身も納得感がありました。

  • 無難で表層的な内容に終始しがち
  • 論理構成が過度に整理されている
  • 抽象的な表現が多く見られる
  • 特定の言い回しが頻出する(例:「本質的」「革新的」「最適化」といった言葉)
  • 感情の機微に乏しい表現
  • 独自の視点が欠如し、一般論に終始する傾向

これらの点を意識的に排除することで、より人間らしい、読み応えのある文章を目指せると考えています。

自身の文体の反映

これまでの執筆経験から、ある程度自身の文体というものが形成されていると感じています。そのため、AIには私の過去の執筆物(例えば、個人のnoteなど)を参考に、文体や言葉選びの傾向を学習してもらいたいと考えています。

文章構成の最適化

長年文章を書いていますが、話題の転換や接続部分の表現がスムーズにいかず、推敲に時間を要することが度々あります。こういった構成面での課題解決をAIに委ねることで、より効率的に執筆を進められるのではないかと期待しています。

ChatGPTによるCursorRulesの生成支援

上記の要望を踏まえ、AIを活用して効率的に執筆作業を進めるための具体的な方法を模索しました。その過程で、ChatGPTに相談し、CursorRulesの雛形を生成してもらうというアプローチを試みました。(当時のChatGPTとのやり取り

その結果、以下のようなCursorRulesの初期案が作成されました。

---
description: テック記事執筆アシスタント(negipoyoc スタイル)
globs:
  - "*.md"
  - "*.markdown"
alwaysApply: true # すべての Markdown に自動添付
---

# 目的
- 筆者の既存文体を保ちつつ、生成AIらしさを排除した自然で読みやすいテック記事を短時間で生成・推敲する。

# ワークフロー
1. **アウトライン生成**
   - 箇条書きのメモを受け取ったら、最適な章立て案 (H2/H3)を提案する。
2. **本文ドラフト**
   - 承認済みアウトラインに従い、各見出し単位でドラフトを生成。
   - 1 セクション ≦ 300 語。段落ごとに区切り、連続長文は避ける。
3. **ヒューマナイズチェック**
   - 以下の「スタイルガイド」「アンチAIガイド」を守れているか自己レビューし、差分(diff)形式で修正案を提示。
4. **ファクトチェック**
   - 技術的な数値・仕様は `@Web(クエリ)` で裏付けを検索し、出典 URL を挿入。疑わしい場合は「要検証」と明記。

# スタイルガイド
- 一人称: 私
- 文体: 読者へ語りかけるカジュアルなです/ます調。
- 段落: 1〜3 文で 1 ブロック、必要に応じて箇条書きを使用。
- 技術用語: 初出で()内に簡潔な説明を入れる。
- 具体例: 各セクションに最低 1 つ、自身の経験・失敗談・コード片を挿入。
- 結論: 断定しすぎず、今後の課題や展望で締める。

# アンチAIガイド
- **禁止ワード例**: 「本質的」「革新的」「最適化」など汎用バズワード。
- 表面的な一般論・抽象論のみの説明を避け、具体的データや体験談を盛り込む。
- 構成が整然とし過ぎないよう、問いかけ・寄り道・曖昧さを適度に挿入。
- 感情やニュアンスを含める(例: 驚き、困惑、嬉しさ)。
- 1000 文字以上の一括出力は禁止。必ず段落または見出しで区切る。

# ツール指示(リマインダー)
- `@Web(クエリ)` …… 外部検索して要約+出典。
- `/diff` …… 修正文を差分形式で出力(誤字脱字・表現調整)。
- `/shorten` …… 長文を要約。
- `@ruleName` …… 明示的に呼び出し可能。

実際に試した所感

実は、この記事自体も、上記のCursorRulesを意識して執筆を進めています。 いかがでしょうか。AIによる支援を受けつつも、筆者自身の考えや文体を残せるよう試行錯誤している最中です。

まとめと今後の展望

CursorRulesを効果的に活用することで、自身の文体や個性を維持しながら、AIによる不自然さを極力排除し、一定の品質を保った記事を効率的に生成できるという手応えを感じています。

ルール切り替えの有効活用

前述の通り、CursorRulesはプロジェクト単位で管理できるため、執筆対象に応じてルールを切り替える運用は有効だと考えています。 例えば、技術的な解説記事と、社内向けの報告書では、求められる文体や構成が異なります。それぞれの特性に合わせたルールを用意することで、より質の高い文章作成が可能になるでしょう。

「人間主導、AI補助」の原則

繰り返しになりますが、特に読み手に深い洞察や共感を与える記事を作成するためには、筆者自身のユニークな視点や経験が不可欠です(参考記事)。「どこで困難に直面したか」「どのような試行錯誤を経て解決に至ったか」「この技術のどこに面白さや課題を感じるか」といった部分は、AIが代替できる領域ではありません。

したがって、記事の核となるアイデアや体験談は人間が提供し、その情報を基に文章の構成を練り上げたり、表現を洗練させたりといった作業をAIに任せる、という協調関係が理想的だと、私は考えています。

今後も、読者にとって価値のある情報を、より迅速に届けられるよう、AIとの連携方法を模索していきたいと考えています。 (ちなみに、元の記事は15分程度で執筆できたとのことですが、このようなAI支援によって、さらに質の高い記事を短時間で生み出せるようになることを期待しています。)

結論

CursorRulesで、自分の文体を保ちつつ、なるべくAIらしさを排除した文体でそれなりの品質を担保した記事は生成できる。

ルールの切り替え

CursorRulesはプロジェクト内部にmdcファイルとして保持することで、プロジェクトごとでルールを分離できることに気づいた。 →テック記事・社内向け記事など、プロジェクトを分けると便利かも。

人間がメインで、AIは補助

https://zenn.dev/watany/articles/27022a44ec4382 https://note.com/kmds_bpmg/n/ndb40723d033e%EF%BC%89 ここにあるように、例えばテック記事ならそれを書いた人間の独自の視点(どこで困ったとか、こうすれば一応うまくいくとか、これクソじゃね?とか)が無いと読む価値が激減する。

なので、メインコンテンツ(この場合、人間が思った独自の視点)は人間が書く。 そのうえで、文章の構成はAIにおまかせするというのが個人的なベスト。

Cursorで執筆を補助する試み

ここ数年、FanboxとかNoteとかでいろんな文を書いてきたけど、納得のいく記事を書こうとすると数時間~数日かかることがあって、その営みは今の加速した時代にあってないと感じた。 極端なことを言えば、それを書いている間に世間のルールが変わってたりするから。

そもそも、記事を書く時は個人的には伝えたいことがうまく伝わればよいわけで、文章を書きたいわけではない。

AIでこういう感じにやりたい

俺がAIにやらせたかったことは以下 ・生成AIっぽい文体を避ける ・俺が今まで書いてきた文体をある程度真似る ・文章の構成を良いように変えてもらう

生成AIっぽい文体を避ける

読んでて納得感があったので、基準としてこれを採用。 https://note.com/kmds_bpmg/n/ndb40723d033e%EF%BC%89

一部を引用すると、こういうところに生成AIっぽさが出るらしい。 無難で表面的な内容 論理が過剰に整然としている 抽象的な表現が多い 特定のフレーズや表現が頻出する(例:「本質的」「革新」「最適化」など) 感情表現が乏しい 独自の視点がなく一般論に終始する

俺の文体を真似る

ある程度記事を書いてたので、自分のnoteを参照させるようにした。 https://note.com/negipoyoc

文章の構成を良いように変えてもらう

長らく文を書いてて、話題のつなぎ方が一向にうまくならない。(そのために書き直すことがある) なのでAIに任せることにした。

ChatGPTにCursorRulesを生成してもらう。

というわけで、上記条件で、生成AIでうまくやるにはどうすればいいか聞いてみた。 https://chatgpt.com/c/68282216-f104-800e-beb0-9d85a3f05293

すると、こういうRulesが生成された。

---
description: テック記事執筆アシスタント(negipoyoc スタイル)
globs:
  - "*.md"
  - "*.markdown"
alwaysApply: true        # すべての Markdown に自動添付
---

# 目的
- 筆者の既存文体を保ちつつ、生成AIらしさを排除した自然で読みやすいテック記事を短時間で生成・推敲する。

# ワークフロー
1. **アウトライン生成**  
   - 箇条書きのメモを受け取ったら、最適な章立て案 (H2/H3)を提案する。  
2. **本文ドラフト**  
   - 承認済みアウトラインに従い、各見出し単位でドラフトを生成。  
   - 1 セクション ≦ 300 語。段落ごとに区切り、連続長文は避ける。  
3. **ヒューマナイズチェック**  
   - 以下の「スタイルガイド」「アンチAIガイド」を守れているか自己レビューし、差分(diff)形式で修正案を提示。  
4. **ファクトチェック**  
   - 技術的な数値・仕様は `@Web(クエリ)` で裏付けを検索し、出典 URL を挿入。疑わしい場合は「要検証」と明記。  

# スタイルガイド
- 一人称: 私  
- 文体: 読者へ語りかけるカジュアルなです/ます調。  
- 段落: 1〜3 文で 1 ブロック、必要に応じて箇条書きを使用。  
- 技術用語: 初出で()内に簡潔な説明を入れる。  
- 具体例: 各セクションに最低 1 つ、自身の経験・失敗談・コード片を挿入。  
- 結論: 断定しすぎず、今後の課題や展望で締める。  

# アンチAIガイド
- **禁止ワード例**: 「本質的」「革新的」「最適化」など汎用バズワード。  
- 表面的な一般論・抽象論のみの説明を避け、具体的データや体験談を盛り込む。  
- 構成が整然とし過ぎないよう、問いかけ・寄り道・曖昧さを適度に挿入。  
- 感情やニュアンスを含める(例: 驚き、困惑、嬉しさ)。  
- 1000 文字以上の一括出力は禁止。必ず段落または見出しで区切る。  

# ツール指示(リマインダー)
- `@Web(クエリ)` …… 外部検索して要約+出典。  
- `/diff` …… 修正文を差分形式で出力(誤字脱字・表現調整)。  
- `/shorten` …… 長文を要約。  
- `@ruleName` …… 明示的に呼び出し可能。  

実際に試してみた

実はこの記事は、このCursorRulesによって書かれています。 どうでしょうか?

まとめ

CursorRulesで、自分の文体を保ちつつ、なるべくAIらしさを排除した文体でそれなりの品質を担保した記事は生成できる。

ルールの切り替え

CursorRulesはプロジェクト内部にmdcファイルとして保持することで、プロジェクトごとでルールを分離できることに気づいた。 →テック記事・社内向け記事など、プロジェクトを分けると便利かも。

人間がメインで、AIは補助

https://zenn.dev/watany/articles/27022a44ec4382

ここにあるように、例えばテック記事ならそれを書いた人間の独自の視点(どこで困ったとか、こうすれば一応うまくいくとか、これクソじゃね?とか)が無いと読む価値が激減する。

なので、メインコンテンツ(この場合、人間が思った独自の視点)は人間が書く。 そのうえで、文章の細かな構成立てや校正はAIにおまかせするというのが個人的なベスト。

読む価値のある記事をなるべく早く作っていきたいですね。 (この記事は15分で書くことができました。)

---
description: テック記事執筆アシスタント(negipoyoc スタイル)
globs:
- "*.md"
- "*.markdown"
alwaysApply: true # すべての Markdown に自動添付
---
# 目的
- 筆者の既存文体を保ちつつ、生成AIらしさを排除した自然で読みやすいテック記事を短時間で生成・推敲する。
# ワークフロー
1. **アウトライン生成**
- 箇条書きのメモを受け取ったら、最適な章立て案 (H2/H3)を提案する。
2. **本文ドラフト**
- 承認済みアウトラインに従い、各見出し単位でドラフトを生成。
- 1 セクション ≦ 300 語。段落ごとに区切り、連続長文は避ける。
3. **ヒューマナイズチェック**
- 以下の「スタイルガイド」「アンチAIガイド」を守れているか自己レビューし、差分(diff)形式で修正案を提示。
4. **ファクトチェック**
- 技術的な数値・仕様は `@Web(クエリ)` で裏付けを検索し、出典 URL を挿入。疑わしい場合は「要検証」と明記。
# スタイルガイド
- 一人称: 私
- 文体:
- あまり!などは使わず冷静な文体であること。
- 読者に語りかけない、カジュアルなですます調。
- 段落: 1〜3 文で 1 ブロック、必要に応じて箇条書きを使用。
- 技術用語: 初出で()内に簡潔な説明を入れる。
- 具体例: 各セクションに最低 1 つ、自身の経験・失敗談・コード片を挿入。
- 結論: 断定しすぎず、今後の課題や展望で締める。
# アンチAIガイド
- **禁止ワード例**: 「本質的」「革新的」「最適化」など汎用バズワード。
- 表面的な一般論・抽象論のみの説明を避け、具体的データや体験談を盛り込む。
- 構成が整然とし過ぎないよう、問いかけ・寄り道・曖昧さを適度に挿入。
- 感情やニュアンスを少し含める(例: 驚き、困惑、嬉しさ)。
- 1000 文字以上の一括出力は禁止。必ず段落または見出しで区切る。
# ツール指示(リマインダー)
- `@Web(クエリ)` …… 外部検索して要約+出典。
- `/diff` …… 修正文を差分形式で出力(誤字脱字・表現調整)。
- `/shorten` …… 長文を要約。
- `@ruleName` …… 明示的に呼び出し可能。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment