neo-stop-slop

Neo Stop Slop

neo-stop-slopは、中国語や英語の文章からAIらしさを示す表現、埋め草、型にはまった冗長な表現を取り除くためのライティングスキルです。コピー、技術文書の草稿、コードコメント、Gitコミット、PRの説明、明確で正確な記事に仕上げる必要があるメモや資料に対応します。

中核となる2つのワークフローを組み合わせています。テキストを診断するReviewerと、書き換えるGeneratorです。Article Rewriteのルールでは、必要に応じて原文への忠実さと台湾繁体字中国語のライティングガイダンスを加えます。

---

注意点

• 短くしすぎるリスク：書き換えの際は、重要な技術的詳細や事実をすべて残してください。AIらしさを示す表現を取り除くとは、埋め草や装飾的な構成を取り除くことであり、内容を削除することではありません。
• Article Rewriteにおける事実の境界：草稿、メモ、記事、資料を扱う際は、ユーザーが提供し、裏付けている情報だけを使用してください。外部の背景情報、データ、因果関係、動機、影響、検証されていない結論を加えてはいけません。不確実性、情報の帰属、矛盾はそのまま残してください。詳細なルールについては、references/article-rewrite.mdを参照してください。
• コードの構文とコメントマーカー：コードコメントを簡潔にする際、C#の<summary>や<param>などのXMLドキュメント構造、またはJSDoc／TSDocのマーカーを壊さないでください。
• アナライザーの実行：analyze-slop.jsは、--fileまたは--inputを指定して非対話形式で実行してください。必要に応じて--format jsonを使用します。エージェントが停止するおそれのあるTTYプロンプトは起動しないでください。

---

ワークフローチェックリスト

進捗：

• ステップ1 — 把握する：言語、内容の文脈、出力の目的を特定します。依頼をReview、一般的なRewrite、またはArticle Rewriteに振り分けます。
• ステップ2 — 検討する：文脈に関連するreferences/のリソースだけを読み込みます。Article Rewriteではarticle-rewrite.mdを読み込む必要があります。
• ステップ3 — 実行する：レビュー：ユーザーがAIらしさを示す表現の診断を求めた場合に限り、analyze-slop.jsを実行します。
• ステップ4 — 実行する：書き換え：情報のない埋め草、型にはまった構成、曖昧な表現を取り除きます。Article Rewriteモードでは、簡潔にするために事実を削除せず、提供された情報の順序を入れ替えます。
• ステップ5 — 検証する：選択したモードに従って、スタイル、原文への忠実さ、出力形式、技術的なマーカーを確認します。アナライザーのスコアは診断の手がかりとして扱い、すべてのモードで必須の基準とはしません。

---

詳細ガイドライン

ステップ1 — 把握する

ユーザーの依頼とテキストを注意深く分析します。

1. 言語を判定する：主な言語が台湾繁体字中国語か英語かを判断します。
2. 文脈を分類する：
   • 一般的なコピーや草稿：phrases-zh.mdまたはphrases-en.mdに加えて、structures.mdを読み込みます。
   • 開発者向けのテキスト（コメント、コミット、PR）：dev-slop.mdを読み込みます。
   • Article Rewrite（粗いメモ、資料、ニュース、技術的な内容）：article-rewrite.mdを読み込み、原文への忠実さと自然な物語の流れを優先します。
3. モードを選択する：
   • テキストにAIらしさを示す表現が含まれているか尋ねられた場合、またはテキストのレビューを求められた場合は、Review modeを使用します。
   • テキストの書き換えや、AIらしさを示す表現の削除を直接求められた場合は、Rewrite modeを使用します。
   • 草稿、メモ、記事、資料を整理して完全な記事にするよう求められた場合は、Article Rewrite modeを使用します。

---

ステップ2 — 検討してリファレンスを読み込む

スキルの対象を絞ったリファレンス資料を、必要に応じて読み込みます。ステップ1に基づいて、該当するパスを読み込みます。

• 一般的な英語：references/phrases-en.md
• 一般的な中国語：references/phrases-zh.md
• 型にはまった構成：references/structures.md
• 開発者向けのガイダンス：references/dev-slop.md
• Article Rewriteのガイダンス：references/article-rewrite.md
• 変更前／変更後の例：references/examples.md

---

Step 3 — Act: レビュー

1. ユーザーのテキストを一時ファイルに書き込むか、引数としてアナライザーに直接渡します。
2. analyze-slop.js を非対話モードで実行します。

   node skills/neo-stop-slop/scripts/analyze-slop.js --input "[user input text]" --format json
   

3. JSON 出力を解析し、次の項目を抽出します。
   • スロップ密度スコア
   • グレード
   • 違反
4. 出力テンプレートを使って、違反箇所の行番号、カテゴリ、具体的な再構成案を含むスロップ診断を提示します。

---

Step 4 — Act: 書き直し

一般的な「書き直し」モードでは、以下のルールに従います。「記事の書き直し」には、代わりに references/article-rewrite.md を使用します。

1. 冗長な表現を削る：「注目すべきは」「見過ごせない」といった書き出しや、「Here's the thing」などの表現を削除します。
2. 能動態を使う：各文に、動作を行う人やコンポーネントなど、具体的な主語を置きます。「コードが望んでいる」のような擬人化は避けます。
3. 定型的な導入を崩す：「X ではなく Y だからです」のような二項対立や、「想像してみてください：」のような修辞的な問いかけを削除します。
4. 具体的に書く：「パフォーマンスを大幅に向上させ、課題を解決します」のような曖昧な主張は、「メモリ使用量を 80% 削減します」のような具体的な結果に置き換えます。
5. 内容を保つ：固定の文字数削減目標を設けたり、事実、条件、制約、技術的な詳細を犠牲にしたりせず、情報のない冗長な表現や繰り返しを削除します。
6. 開発者向けの慣例に従う：コードコメントや Git コミットでは、dev-slop.md の簡潔な文章のルールに従います。

「記事の書き直し」モードでは、まず提供された情報を抽出して並べ替え、その後、記事本文だけを出力します。一般的な「書き直し」モードの文字数目標やレポート形式は使用しません。

---

Step 5 — 検証

1. 一般的な「書き直し」モードでは、書き直したテキストを再度アナライザーにかけてもかまいません。

   node skills/neo-stop-slop/scripts/analyze-slop.js --input "[rewritten text]" --format json
   

2. slopDensityScore を、スタイルを確認するための指標として元のテキストと比較します。ユーザーから特別な指示がない限り、A+ や < 0.5% を必須条件として扱わないでください。
3. 「記事の書き直し」モードでは、事実確認にアナライザーを使わないでください。article-rewrite.md に記載された事実確認と自然さのチェックを行い、記事本文だけを出力します。
4. 一般的な「書き直し」の回答に診断の概要を含める場合、文字数やスロップ密度の変化を報告してもかまいませんが、スコアを上げるために内容を削除してはいけません。

---

出力テンプレート

1. レビューレポートのテンプレート

ユーザーがテキストのレビューや診断を求めた場合、次の形式で回答します。

### 🔍 AI Slop Review

*   **Word count**: [total words]
*   **AI tell count**: [violation count]
*   **Slop density score**: **[score]%** ([violation count] matches per 100 words)
*   **Grade**: **[grade]**

#### ⚠️ Violations and restructuring suggestions
| Line | Detected phrase | Category | Diagnosis and restructuring suggestion |
| :--- | :--- | :--- | :--- |
| Line X | "值得注意的是" | Throat-clearing opener | Delete the transition and state the following fact directly. |
| Line Y | "賦能生態系" | AI slop word | Replace it with 「提供技術支持」 or 「構建合作社群」. |

#### 📝 Summary of recommendations
1. [A concrete recommendation about the article's structure]
2. [A recommendation about adverbs or passive voice]

2. 一般的な書き直し結果のテンプレート

ユーザーが一般的な書き直しを求めた場合、次の形式で回答します。「記事の書き直し」にはこのテンプレートを使用しないでください。

### ✨ AI-Slop-Free Rewrite

*   **Word-count change**: [original count] ➡️ **[rewritten count]** (include the reduction percentage only when useful)
*   **Slop density**: [original density]% ➡️ **[rewritten density]%** (diagnostic only)

---

#### 📄 Rewritten text
> [Insert the concise, natural rewrite here. Keep the formatting clean and avoid AI filler.]

---

#### 💡 Key restructuring notes
1. **[Restructuring point 1]**: Changed 「[before text]」 to 「[after text]」, removed 「[AI tell]」, and made the tone more [active/direct].
2. **[Restructuring point 2]**: Removed filler and replaced the vague 「[before wording]」 with the concrete fact 「[specific content]」.

3. 記事の書き直しの出力

references/article-rewrite.md に従って書き直した後、記事本文だけを出力します。ユーザーが明示的にタイトルを求めている場合、または元の文章にタイトルがある場合を除き、タイトルを追加しないでください。再構成のメモ、分析、事実の一覧、編集内容の要約、確認結果、補足コメントは出力しないでください。