neo-stop-slop

Neo Stop Slop

neo-stop-slop 是一项写作技能，用于从中文和英文文本中去除 AI 痕迹、填充语和程式化的冗长表达。它适用于文案、技术草稿、代码注释、Git 提交信息、PR 描述，以及需要整理成清晰、准确文章的粗略笔记或源材料。

它结合了两种核心工作流：Reviewer 用于诊断文本，Generator 用于改写文本。在需要时，文章改写规则还会加入源材料忠实度和台湾繁体中文写作指导。

---

注意事项

• 过度精简风险：改写时，请保留所有重要的技术细节和事实。去除 AI 痕迹意味着删除填充语和装饰性结构，而不是删掉实质内容。
• 文章改写的事实边界：处理草稿、笔记、文章或源材料时，只能使用用户提供并支持的信息。不得添加外部背景、数据、因果关系、动机、影响或未经核实的结论。保留不确定性、归属信息和矛盾之处。完整规则请参见 references/article-rewrite.md。
• 代码语法和注释标记：精简代码注释时，不得破坏 C# <summary> 和 <param> 等 XML 文档结构，也不得破坏 JSDoc/TSDoc 标记。
• 分析器执行：以非交互方式运行 analyze-slop.js，使用 --file 或 --input，并可选择使用 --format json；切勿调用可能导致 Agent 挂起的 TTY 提示。

---

工作流检查清单

进度：

• 步骤 1 — 感知：识别语言、内容背景和输出目标。将请求分流到 Review、通用 Rewrite 或 Article Rewrite。
• 步骤 2 — 推理：仅加载与背景相关的 references/ 资源。文章改写必须加载 article-rewrite.md。
• 步骤 3 — 执行：审阅：仅在用户要求诊断 AI 痕迹时运行 analyze-slop.js。
• 步骤 4 — 执行：改写：删除无信息量的填充语、程式化结构和含糊措辞。在文章改写模式下，重新组织提供的信息，但不得为追求简洁而删除事实。
• 步骤 5 — 验证：根据所选模式检查风格、源材料忠实度、输出格式和技术标记。将分析器评分视为诊断信号，而不是每种模式都必须满足的硬性门槛。

---

详细指南

步骤 1 — 感知

仔细分析用户的请求和文本：

1. 检测语言：判断主要语言是台湾繁体中文还是英文。
2. 分类背景：
   • 通用文案或草稿：加载 phrases-zh.md 或 phrases-en.md，以及 structures.md。
   • 开发者文本（注释、提交信息或 PR）：加载 dev-slop.md。
   • 文章改写（粗略笔记、源材料、新闻或技术内容）：加载 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
• 文章改写指南：references/article-rewrite.md
• 改写前后示例：references/examples.md

---

第 3 步 — 执行：审查

1. 将用户文本写入临时文件，或直接作为参数传递给分析器。
2. 非交互式运行 analyze-slop.js：

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

3. 解析 JSON 输出并提取：
   • Slop 密度分数
   • 等级
   • 违规项
4. 使用输出模板呈现 slop 诊断，其中包括违规行号、类别和具体的重组建议。

---

第 4 步 — 执行：改写

在常规改写模式下遵循以下规则；文章改写模式请改用 references/article-rewrite.md：

1. 删去填充语：删除「值得注意的是」、「不容忽视」和 “Here's the thing” 等开场语。
2. 使用主动语态：为每个句子指定一个执行动作的具体主语，例如某个人或组件。避免拟人化表达，例如 “The code wants to...”。
3. 打破公式化铺垫：删除「不是因为 X，而是因为 Y」等二元对比，以及「试想一下：」等设问。
4. 具体明确：将「大幅提升性能、解决痛点」等模糊说法替换为具体结果，例如「减少 80% 的内存开销」。
5. 保留实质内容：删除没有信息量的填充语和重复内容，但不要设定固定的字数缩减目标，也不要牺牲事实、条件、限制或技术细节。
6. 遵循开发者规范：编写代码注释或 Git 提交信息时，遵循 dev-slop.md 中的简洁写作规则。

在文章改写模式下，先提取并重新组织所提供的信息，然后只输出文章正文。不要使用常规改写的字数目标或报告格式。

---

第 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. 如果常规改写的回复中包含诊断摘要，可以报告字数和 slop 密度的变化，但不得为了提高分数而删减实质内容。

---

输出模板

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 中的要求后，只输出文章正文。除非用户明确要求添加标题，或源文本已有标题，否则不要添加标题。不要输出重组说明、分析、事实清单、编辑摘要、检查结果或其他评论。