@@ -74,14 +74,123 @@ MCPサーバの詳しい設定方法は [textlint MCP documentation](https://tex
74
74
75
75
リストアイテムで機械的な印象を与える可能性のある記述パターンを検出します。
76
76
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
+
77
115
### no-ai-hype-expressions
78
116
79
117
AIライティングで過度に使用されがちな誇張表現やハイプ的な表現を検出します。
80
118
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
+
81
172
### no-ai-emphasis-patterns
82
173
83
174
AIが機械的に生成しがちな強調パターンを検出します。
84
175
176
+ #### 検出される例
177
+
178
+ ``` markdown
179
+ これは**非常に**重要な項目です。
180
+ **注意**してください。
181
+ ```
182
+
183
+ #### より自然な表現
184
+
185
+ ``` markdown
186
+ これは重要な項目です。
187
+ 注意してください。
188
+ ```
189
+
190
+ #### オプション
191
+
192
+ - ` allows ` : 指定したパターンにマッチする場合、エラーを報告しません
193
+
85
194
### no-ai-colon-continuation
86
195
87
196
コロンの直後にブロック要素が続く英語的なパターンを検出します。日本語として自然な表現を促進するルールです。
@@ -107,7 +216,7 @@ command
107
216
- 具体的な例
108
217
````
109
218
110
- #### より自然な日本語表現
219
+ #### より自然な表現
111
220
112
221
```` markdown
113
222
実行方法は以下の通りです。
@@ -130,17 +239,21 @@ command
130
239
- 具体的な例
131
240
````
132
241
242
+ #### オプション
243
+
244
+ - ` allows ` : 指定したパターンにマッチする場合、エラーを報告しません
245
+ - 文字列: ` "許可したいテキスト" `
246
+ - 正規表現: ` "/パターン/フラグ" ` (例: ` "/使用方法.*/i" ` )
247
+ - ` disableCodeBlock ` : ` true ` にするとコロン後のコードブロック検出を無効にする
248
+ - ` disableList ` : ` true ` にするとコロン後のリスト検出を無効にする
249
+ - ` disableQuote ` : ` true ` にするとコロン後の引用検出を無効にする
250
+ - ` disableTable ` : ` true ` にするとコロン後のテーブル検出を無効にする
251
+
133
252
### ai-tech-writing-guideline
134
253
135
254
テクニカルライティングのベストプラクティスに基づいて、文書品質の改善提案を行います。
136
255
詳細なガイドラインについては [ docs/tech-writing-guidelines.md] ( ./docs/tech-writing-guidelines.md ) を参照してください。
137
256
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
-
144
257
#### 検出される内容
145
258
146
259
- 簡潔性: 冗長表現の排除
@@ -153,145 +266,20 @@ command
153
266
- 一貫性: 用語と表現の統一(同一対象への異なる用語使用の検出)
154
267
- 構造化: 文の長さと情報整理(長い文の分割提案など)
155
268
156
- #### リストアイテムの強調表現
269
+ #### オプション
157
270
158
271
- `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`にすると文書全体の分析を有効にする
172
279
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
+ #### 推奨する組み合わせ
293
281
294
- 基本的な日本語技術文書の品質担保と、より高度な文書品質向上の組み合わせ:
282
+ このルールは [textlint-rule-preset-ja-technical-writing](https://github.com/textlint-ja/textlint-rule-preset-ja-technical-writing) との組み合わせを推奨します。
295
283
296
284
```json
297
285
{
@@ -349,26 +337,6 @@ AIを利用しやすくするプラットフォームです。
349
337
}
350
338
```
351
339
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
-
372
340
### 正規表現パターンの使用例
373
341
374
342
` allows ` オプションでは、[ regexp-string-matcher] ( https://github.com/textlint/regexp-string-matcher ) の形式で正規表現パターンを指定できます。
0 commit comments