/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后，紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}
别让你的 AI Agent 在 Windows 上“开口跪”：通过Skill解决 Agent 运行时的 Linux 幻觉
你是否有过这种经历：给 Cursor 或 Trae 下达一个指令，让它在 Windows 目录下搜索并删除某个文件。
结果，你眼睁睁看着它在 PowerShell 窗口里敲下了：
cd src && ls | grep "test" | xargs rm -rf
砰！报错。 因为：
这就是我开发 Agent PowerShell Standardizer 这个Skill的初衷：它不是为了教 AI 写脚本，而是为了给 AI Agent 穿上一层“环境适配器”，防止它在执行任务时因为“母语偏见”而翻车。
🧠 核心痛点：AI 的“母语”是 Linux
由于全球绝大多数的代码语料和服务器环境都基于 Linux，AI 默认逻辑是：
- 链式操作：用 && 连接命令。
- 路径分割：习惯 / 而非 \\。
- 字符处理：默认 UTF-8，忽略 Windows 烦人的 GBK/UTF-16 编码问题。
当这种逻辑碰撞上 Windows PowerShell，Agent 就会陷入**“不断报错 -> 不断重试 -> 消耗 Token -> 最终失败”**的死循环。
🛠️ Agent PowerShell Standardizer 是如何解决的？
这个 Skill 相当于为你的 AI Agent 植入了一个 “Windows 运行守则”。
1. 语法重塑：告别 && 陷阱
规范强制 Agent 在 Windows 环境下使用 PowerShell 原生语法。
- ❌ AI 惯性：mkdir test && cd test
- ✅ 规范要求：New-Item -ItemType Directory -Name "test"; Set-Location -Path "test"
2. 路径安全：终结字符串拼接
Windows 的路径拼接是报错重灾区。规范要求 AI 放弃 dir + "\\" + file 的原始写法，强制使用 Join-Path。
# 规范要求 AI 必须这样执行：
$target = Join-Path –Path $PSScriptRoot –ChildPath "logs"
if (Test-Path –Path $target) { ... }
3. 编码防御：消灭中文乱码
在执行文件读写任务时，Agent 往往忽略 Windows 的编码差异。本规范强制要求显式指定编码，确保 AI 生成的配置文件不会在 Windows 上变成一堆乱码。
4. 风险控制：内置 -WhatIf 意识
当 Agent 试图执行破坏性指令（如删除、覆盖）时，本规范会触发“预飞行检查”，优先使用 -WhatIf 进行模拟运行，防止 AI 误删你的重要工程文件。
📂 它是如何工作的？（以 Trae/Cursor 为例）
你只需要将规范放入项目的 .trae/skills/ 或 .cursor/rules/ 文件夹。
当 Agent 准备执行任何命令前，它会先匹配该规则：
🚀 带来的改变
使用这个规范后，你的 AI 助手将从一个 “笨手笨脚的跨平台移民” 变成一个 “土生土长的 Windows 专家”：
- 执行成功率提升：减少因语法错误导致的重试。
- 环境兼容性更好：生成的指令同时兼容 PowerShell 5.1 和 7+。
- 代码更具“Windows 味”：充分利用 .NET 对象流的优势，而非低效的字符串解析。
💡 结语
Agent 的能力边界不仅取决于模型本身，更取决于它对运行环境的理解。Agent PowerShell Standardizer 填补了 AI 在 Windows 生态下的最后一块短板。
让 AI 归 AI，让 Windows 归 PowerShell。
项目开源地址： https://github.com/hqy2435662352/agent-powershell-standardizer
欢迎提交 Issue： 如果你发现了 AI 更多的 Windows 翻车姿势，欢迎告诉我！
