Skip to content

Commit 3529ca3

Browse files
azuclaude
andcommitted
docs: README.mdのルール説明を統一フォーマットに整理
- 各ルールの説明を「ルール名」→「説明」→「検出される例」→「より自然な表現」→「オプション」の統一フォーマットに変更 - 重複していたオプションの説明を整理し、各ルール内に統合 - 全体の構成を見直し、読みやすさを向上 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 74dfee4 commit 3529ca3

File tree

1 file changed

+130
-162
lines changed

1 file changed

+130
-162
lines changed

README.md

Lines changed: 130 additions & 162 deletions
Original file line numberDiff line numberDiff line change
@@ -74,14 +74,123 @@ MCPサーバの詳しい設定方法は [textlint MCP documentation](https://tex
7474

7575
リストアイテムで機械的な印象を与える可能性のある記述パターンを検出します。
7676

77+
#### 検出される例
78+
79+
```markdown
80+
- **重要**: これは重要な項目です
81+
- **注意**: 注意が必要な項目です
82+
- ✅ 完了した項目
83+
- ❌ 失敗した項目
84+
- 💡 アイデア項目
85+
- 🔥 ホットな話題
86+
- 🚀 開始準備完了
87+
- ⭐ 重要項目
88+
- 🎯 目標設定
89+
- 📝 メモ項目
90+
```
91+
92+
#### より自然な表現
93+
94+
```markdown
95+
- 重要な項目: これは重要な項目です
96+
- 注意事項: 注意が必要な項目です
97+
- 完了した項目
98+
- 失敗した項目
99+
- アイデア項目
100+
- 注目の話題
101+
- 開始準備完了
102+
- 重要項目
103+
- 目標設定
104+
- メモ項目
105+
```
106+
107+
#### オプション
108+
109+
- `allows`: 指定したパターンにマッチする場合、エラーを報告しません
110+
- 文字列: `"許可したいテキスト"`
111+
- 正規表現: `"/パターン/フラグ"` (例: `"/重要.*/i"`)
112+
- `disableBoldListItems`: `true`にすると強調リストアイテムの検出を無効にする
113+
- `disableEmojiListItems`: `true`にすると絵文字リストアイテムの検出を無効にする
114+
77115
### no-ai-hype-expressions
78116

79117
AIライティングで過度に使用されがちな誇張表現やハイプ的な表現を検出します。
80118

119+
#### 検出される例
120+
121+
```markdown
122+
革命的な技術で業界を変えます。
123+
これはゲームチェンジャーです。
124+
世界初のソリューションを提供します。
125+
究極のパフォーマンスを実現します。
126+
完全に問題を解決します。
127+
すべての課題を解決します。
128+
最高の品質を保証します。
129+
魔法のように動作します。
130+
奇跡的な結果を生み出します。
131+
可能性を解き放つソリューションです。
132+
AIを民主化するプラットフォームです。
133+
業務をスーパーチャージします。
134+
業界を再定義する革新です。
135+
未来を変える技術です。
136+
パラダイムシフトを起こします。
137+
不可避の変化が起こります。
138+
次世代のソリューションです。
139+
```
140+
141+
#### より自然な表現
142+
143+
```markdown
144+
効果的な技術で業界に変化をもたらします。
145+
これは大きな変化をもたらすでしょう。
146+
新しいソリューションを提供します。
147+
高いパフォーマンスを実現します。
148+
多くの問題を解決します。
149+
主要な課題を解決します。
150+
高い品質を保証します。
151+
スムーズに動作します。
152+
優れた結果を生み出します。
153+
新たな機会を創出するソリューションです。
154+
AIを利用しやすくするプラットフォームです。
155+
業務を効率化します。
156+
業界に新しい視点をもたらす革新です。
157+
将来に影響を与える技術です。
158+
大きな変化を起こします。
159+
重要な変化が起こるでしょう。
160+
新しいソリューションです。
161+
```
162+
163+
#### オプション
164+
165+
- `allows`: 指定したパターンにマッチする場合、エラーを報告しません
166+
- 文字列: `"許可したいテキスト"`
167+
- 正規表現: `"/パターン/フラグ"` (例: `"/革命的な.*/"`)
168+
- `disableAbsolutenessPatterns`: `true`にすると絶対性・完全性を演出する表現の検出を無効にする
169+
- `disableAbstractPatterns`: `true`にすると抽象的・感覚的効果を演出する表現の検出を無効にする
170+
- `disabledPredictivePatterns`: `true`にすると権威的・予言的な表現の検出を無効にする
171+
81172
### no-ai-emphasis-patterns
82173

83174
AIが機械的に生成しがちな強調パターンを検出します。
84175

176+
#### 検出される例
177+
178+
```markdown
179+
これは**非常に**重要な項目です。
180+
**注意**してください。
181+
```
182+
183+
#### より自然な表現
184+
185+
```markdown
186+
これは重要な項目です。
187+
注意してください。
188+
```
189+
190+
#### オプション
191+
192+
- `allows`: 指定したパターンにマッチする場合、エラーを報告しません
193+
85194
### no-ai-colon-continuation
86195

87196
コロンの直後にブロック要素が続く英語的なパターンを検出します。日本語として自然な表現を促進するルールです。
@@ -107,7 +216,7 @@ command
107216
- 具体的な例
108217
````
109218

110-
#### より自然な日本語表現
219+
#### より自然な表現
111220

112221
````markdown
113222
実行方法は以下の通りです。
@@ -130,17 +239,21 @@ command
130239
- 具体的な例
131240
````
132241

242+
#### オプション
243+
244+
- `allows`: 指定したパターンにマッチする場合、エラーを報告しません
245+
- 文字列: `"許可したいテキスト"`
246+
- 正規表現: `"/パターン/フラグ"` (例: `"/使用方法.*/i"`)
247+
- `disableCodeBlock`: `true`にするとコロン後のコードブロック検出を無効にする
248+
- `disableList`: `true`にするとコロン後のリスト検出を無効にする
249+
- `disableQuote`: `true`にするとコロン後の引用検出を無効にする
250+
- `disableTable`: `true`にするとコロン後のテーブル検出を無効にする
251+
133252
### ai-tech-writing-guideline
134253

135254
テクニカルライティングのベストプラクティスに基づいて、文書品質の改善提案を行います。
136255
詳細なガイドラインについては [docs/tech-writing-guidelines.md](./docs/tech-writing-guidelines.md) を参照してください。
137256

138-
#### 推奨する組み合わせ
139-
140-
このルールは [textlint-rule-preset-ja-technical-writing](https://github.com/textlint-ja/textlint-rule-preset-ja-technical-writing) との組み合わせを推奨します。
141-
`ja-technical-writing` はfalse positiveが少ない確実なルールセットで、基本的な日本語技術文書の品質を担保します。
142-
本ルール(`ai-tech-writing-guideline`)は、より高度な文書品質向上のためのサジェストとして使用することを想定しています。
143-
144257
#### 検出される内容
145258

146259
- 簡潔性: 冗長表現の排除
@@ -153,145 +266,20 @@ command
153266
- 一貫性: 用語と表現の統一(同一対象への異なる用語使用の検出)
154267
- 構造化: 文の長さと情報整理(長い文の分割提案など)
155268
156-
#### リストアイテムの強調表現
269+
#### オプション
157270
158271
- `allows`: 指定したパターンにマッチする場合、エラーを報告しません
159-
- 文字列: `"許可したいテキスト"`
160-
- 正規表現: `"/パターン/フラグ"` (例: `"/以下のような.*/"`)
161-
162-
#### no-ai-hype-expressions
163-
164-
- `allows`: 指定したパターンにマッチする場合、エラーを報告しません
165-
- 文字列: `"許可したいテキスト"`
166-
- 正規表現: `"/パターン/フラグ"` (例: `"/革命的な.*/"`)
167-
- `disableAbsolutenessPatterns`: `true`にすると絶対性・完全性を演出する表現の検出を無効にする
168-
- `disableAbstractPatterns`: `true`にすると抽象的・感覚的効果を演出する表現の検出を無効にする
169-
- `disabledPredictivePatterns`: `true`にすると権威的・予言的な表現の検出を無効にしますパターン
170-
171-
検出される例:
272+
- `severity`: `"info"`にするとサジェストとして扱う
273+
- `disableRedundancyGuidance`: `true`にすると冗長性の検出を無効にする
274+
- `disableVoiceGuidance`: `true`にすると能動態・受動態の検出を無効にする
275+
- `disableClarityGuidance`: `true`にすると明確性の検出を無効にする
276+
- `disableConsistencyGuidance`: `true`にすると一貫性の検出を無効にする
277+
- `disableStructureGuidance`: `true`にすると構造化の検出を無効にする
278+
- `enableDocumentAnalysis`: `true`にすると文書全体の分析を有効にする
172279
173-
```markdown
174-
- **重要**: これは重要な項目です
175-
- **注意**: 注意が必要な項目です
176-
```
177-
178-
書き換えた例:
179-
180-
```markdown
181-
- 重要な項目: これは重要な項目です
182-
- 注意事項: 注意が必要な項目です
183-
```
184-
185-
#### 絵文字を使ったリストアイテム
186-
187-
AIが機械的に使いがちな装飾的な絵文字の使用を検出します。
188-
検出対象は、特に「華やか」で機械的な印象を与える絵文字に限定されています。
189-
190-
検出される例:
191-
192-
```markdown
193-
- ✅ 完了した項目
194-
- ❌ 失敗した項目
195-
- 💡 アイデア項目
196-
- 🔥 ホットな話題
197-
- 🚀 開始準備完了
198-
- ⭐ 重要項目
199-
- 🎯 目標設定
200-
- 📝 メモ項目
201-
```
202-
203-
書き換えた例:
204-
205-
```markdown
206-
- 完了した項目
207-
- 失敗した項目
208-
- アイデア項目
209-
- 注目の話題
210-
- 開始準備完了
211-
- 重要項目
212-
- 目標設定
213-
- メモ項目
214-
```
215-
216-
注意: 普通の絵文字(😀, 🍎, 🐱, 🌸など)は検出されません。
217-
218-
### 2. no-ai-hype-expressions
219-
220-
AIライティングで過度に使用されがちな誇張表現やハイプ的な表現を検出します。自然で読みやすい文章を促進するためのルールです。
221-
222-
#### 絶対性・完全性を演出する表現
223-
224-
検出される例:
225-
226-
```markdown
227-
革命的な技術で業界を変えます。
228-
これはゲームチェンジャーです。
229-
世界初のソリューションを提供します。
230-
究極のパフォーマンスを実現します。
231-
完全に問題を解決します。
232-
すべての課題を解決します。
233-
最高の品質を保証します。
234-
```
235-
236-
書き換えた例:
237-
238-
```markdown
239-
効果的な技術で業界に変化をもたらします。
240-
これは大きな変化をもたらすでしょう。
241-
新しいソリューションを提供します。
242-
高いパフォーマンスを実現します。
243-
多くの問題を解決します。
244-
主要な課題を解決します。
245-
高い品質を保証します。
246-
```
247-
248-
#### 抽象的・感覚的効果を演出する表現
249-
250-
検出される例:
251-
252-
```markdown
253-
魔法のように動作します。
254-
奇跡的な結果を生み出します。
255-
可能性を解き放つソリューションです。
256-
AIを民主化するプラットフォームです。
257-
業務をスーパーチャージします。
258-
```
259-
260-
書き換えた例:
261-
262-
```markdown
263-
スムーズに動作します。
264-
優れた結果を生み出します。
265-
新たな機会を創出するソリューションです。
266-
AIを利用しやすくするプラットフォームです。
267-
業務を効率化します。
268-
```
269-
270-
#### 権威的・予言的な表現
271-
272-
検出される例:
273-
274-
```markdown
275-
業界を再定義する革新です。
276-
未来を変える技術です。
277-
パラダイムシフトを起こします。
278-
不可避の変化が起こります。
279-
次世代のソリューションです。
280-
```
281-
282-
書き換えた例:
283-
284-
```markdown
285-
業界に新しい視点をもたらす革新です。
286-
将来に影響を与える技術です。
287-
大きな変化を起こします。
288-
重要な変化が起こるでしょう。
289-
新しいソリューションです。
290-
```
291-
292-
### 推奨構成: ja-technical-writing との組み合わせ
280+
#### 推奨する組み合わせ
293281
294-
基本的な日本語技術文書の品質担保と、より高度な文書品質向上の組み合わせ:
282+
このルールは [textlint-rule-preset-ja-technical-writing](https://github.com/textlint-ja/textlint-rule-preset-ja-technical-writing) との組み合わせを推奨します。
295283
296284
```json
297285
{
@@ -349,26 +337,6 @@ AIを利用しやすくするプラットフォームです。
349337
}
350338
```
351339

352-
### Options説明
353-
354-
#### no-ai-list-formatting
355-
356-
- `allows`: 指定したパターンにマッチする場合、エラーを報告しません
357-
- 文字列: `"許可したいテキスト"`
358-
- 正規表現: `"/パターン/フラグ"` (例: `"/重要.*/i"`)
359-
- `disableBoldListItems`: `true`にすると強調リストアイテムの検出を無効にする
360-
- `disableEmojiListItems`: `true`にすると絵文字リストアイテムの検出を無効にする
361-
362-
#### no-ai-colon-continuation
363-
364-
- `allows`: 指定したパターンにマッチする場合、エラーを報告しません
365-
- 文字列: `"許可したいテキスト"`
366-
- 正規表現: `"/パターン/フラグ"` (例: `"/使用方法.*/i"`)
367-
- `disableCodeBlock`: `true`にするとコロン後のコードブロック検出を無効にする
368-
- `disableList`: `true`にするとコロン後のリスト検出を無効にする
369-
- `disableQuote`: `true`にするとコロン後の引用検出を無効にする
370-
- `disableTable`: `true`にするとコロン後のテーブル検出を無効にする
371-
372340
### 正規表現パターンの使用例
373341

374342
`allows`オプションでは、[regexp-string-matcher](https://github.com/textlint/regexp-string-matcher)の形式で正規表現パターンを指定できます。

0 commit comments

Comments
 (0)