feat: 機械的な段落と箇条書きの組み合わせパターンを検出する機能を追加

Author: azu

src/rules/ai-tech-writing-guideline.ts

@@ -187,9 +187,9 @@ const rule: TextlintRuleModule<Options> = (context, options = {}) => {
     };
 
     /**
-     * コロン（：）で終わる段落の直後に箇条書きが続くパターンを検出
+     * 機械的な段落と箇条書きの組み合わせパターンを検出
      */
-    const detectColonListPattern = (node: any) => {
+    const detectMechanicalListIntroPattern = (node: any) => {
         const children = node.children || [];
 
         for (let i = 0; i < children.length - 1; i++) {
@@ -209,8 +209,24 @@ const rule: TextlintRuleModule<Options> = (context, options = {}) => {
                 });
                 const paragraphText = paragraphSource.toString();
 
-                // 「：」で終わる段落の後にリストが続く場合を検出
+                // 機械的なパターンを検出
+                let isDetected = false;
+                let message = "";
+
+                // パターン1: コロン（：、:）で終わる段落
                 if (/[：:][\s]*$/.test(paragraphText.trim())) {
+                    isDetected = true;
+                    message =
+                        "【構造化】コロン（：）で終わる文の直後の箇条書きは機械的な印象を与える可能性があります。「たとえば、次のような点があります。」のような導入文を使った自然な表現を検討してください。";
+                }
+                // パターン2: 「例えば。」「具体的には。」など、接続表現+句点で終わる段落
+                else if (/(?:例えば|具体的には|詳細には|以下|次に|また)。[\s]*$/.test(paragraphText.trim())) {
+                    isDetected = true;
+                    message =
+                        "【構造化】接続表現と句点で終わる文の直後の箇条書きは機械的な印象を与える可能性があります。「たとえば、次のような点があります。」のような自然な導入文を検討してください。";
+                }
+
+                if (isDetected) {
                     // 許可パターンのチェック
                     if (allows.length > 0) {
                         const matches = matchPatterns(paragraphText, allows);
@@ -223,8 +239,7 @@ const rule: TextlintRuleModule<Options> = (context, options = {}) => {
                     hasDocumentIssues = true;
 
                     report(currentNode, {
-                        message:
-                            "【構造化】コロン（：）で終わる文の直後の箇条書きは機械的な印象を与える可能性があります。「たとえば、次のような点があります。」のような導入文を使った自然な表現を検討してください。"
+                        message: message
                     });
                 }
             }
@@ -240,7 +255,7 @@ const rule: TextlintRuleModule<Options> = (context, options = {}) => {
         }
 
         // コロン + 箇条書きパターンの検出
-        detectColonListPattern(node);
+        detectMechanicalListIntroPattern(node);
         // 将来的にここに他の文書レベルの構造化パターンを追加できます
         // 例：
         // detectExcessiveNestedLists(node);

test/rules/ai-tech-writing-guideline.test.ts

@@ -26,6 +26,19 @@ tester.run("ai-tech-writing-guideline", rule, {
         {
             text: "JSXはJavaScriptの中でUIを記述するため、プログラマーにとって理解しやすいです。\nたとえば、JSXの次のような点がわかりやすいと思っています。\n\n- 条件分岐やループは通常のJavaScriptの記法",
             options: { enableDocumentAnalysis: false }
+        },
+        // 自然な接続表現の例
+        {
+            text: "モダンフレームワークには多くの利点があります。たとえば、次のような点が挙げられます。\n\n- パフォーマンスの最適化\n- 開発効率の向上",
+            options: { enableDocumentAnalysis: false }
+        },
+        {
+            text: "データベース設計では重要な要素を考慮します。具体的には、以下の要素を検討します。\n\n- 正規化\n- インデックス設計",
+            options: { enableDocumentAnalysis: false }
+        },
+        {
+            text: "パフォーマンス改善の手法を紹介します。以下にその手法を示します。\n\n- コード最適化\n- キャッシュ活用",
+            options: { enableDocumentAnalysis: false }
         }
     ],
     invalid: [
@@ -135,6 +148,37 @@ tester.run("ai-tech-writing-guideline", rule, {
                 }
             ]
         },
+        // 構造化の問題（接続表現と句点の組み合わせ）
+        {
+            text: "モダンフレームワークには多くの利点があります。例えば。\n\n- パフォーマンスの最適化\n- 開発効率の向上",
+            options: { enableDocumentAnalysis: false },
+            errors: [
+                {
+                    message:
+                        "【構造化】接続表現と句点で終わる文の直後の箇条書きは機械的な印象を与える可能性があります。「たとえば、次のような点があります。」のような自然な導入文を検討してください。"
+                }
+            ]
+        },
+        {
+            text: "データベース設計では重要な要素を考慮します。具体的には。\n\n- 正規化\n- インデックス設計",
+            options: { enableDocumentAnalysis: false },
+            errors: [
+                {
+                    message:
+                        "【構造化】接続表現と句点で終わる文の直後の箇条書きは機械的な印象を与える可能性があります。「たとえば、次のような点があります。」のような自然な導入文を検討してください。"
+                }
+            ]
+        },
+        {
+            text: "パフォーマンス改善の手法を紹介します。以下。\n\n- コード最適化\n- キャッシュ活用",
+            options: { enableDocumentAnalysis: false },
+            errors: [
+                {
+                    message:
+                        "【構造化】接続表現と句点で終わる文の直後の箇条書きは機械的な印象を与える可能性があります。「たとえば、次のような点があります。」のような自然な導入文を検討してください。"
+                }
+            ]
+        },
         // 複数の問題が同時に存在する場合
         {
             text: "まず最初に高速なパフォーマンスの実装を実施することができます。",