| name | windows-ops-guide |
| description | 当某项工作需要用户在 Windows 机器上手动执行(命令、火绒/杀软操作、系统设置、文件检查等),而对话窗口只在另一台机器(如 macOS)上看得到时,把操作步骤整理成一份独立的 md 指导文件写进仓库,让用户切到 Windows 后照着做、回填结果。适用于安全排查、环境配置、打包部署等跨机器协作场景。触发词:「需要在 Windows 操作」「我在 Windows 看不到这个窗口」「写个 md 指导我」「整理成文件」。 |
这个 skill 解决一个具体痛点:对话发生在 A 机器(如开发用的 Mac),但实际操作要在 B 机器(Windows)上做,用户切过去就看不到聊天记录了。 口头/聊天里的步骤一离开窗口就丢,所以要落成仓库里的 md 文件,让用户在 Windows 上打开照做。
何时用
- 用户明确说「需要在 Windows 上操作 / 我那边看不到这个对话 / 写成 md 指导我」。
- 你正在给出一串需要在另一台机器执行的命令或 GUI 操作(杀软查杀、注册表/计划任务检查、conda 环境重建、打包传输、驱动/CUDA 安装等),而那台机器不是当前对话所在的机器。
不用于:操作就在当前机器、或几条命令当场跑完即可的情况——那种直接在对话里给就行,不必造文件。
产物
仓库 docs/ 下一份独立 md(命名见下),用户在 Windows 上打开即可独立执行,不依赖任何聊天上下文。做完每步把结果填回文件,发回来给你判断下一步。
命名
docs/<主题>-<用途>指南.md,例如:
安全排查-清除后复查指南.md
环境配置-CUDA安装指南.md
主题用中文短词,能一眼认出在解决什么。若是某个既有排查/任务文档的延续,主题词保持一致(同一件事的文件聚在一起)。
编写规则(顺序即优先级)
-
自包含 — 文件里必须复述清楚背景:现在处于什么状态、为什么要做这些、上一步结论是什么。假设读者没有聊天记录,只有这一个文件。
-
环境前提写在最顶上 — 用什么终端(cmd 还是 PowerShell,二者命令常不通用)、路径占位怎么替换(如「把 obsidian 换成你实际的环境名」)、需要管理员权限吗。这些一错全错,必须开篇点明。
-
可勾选 + 可回填 — 步骤用 - [ ] 复选框;每一步末尾留一个「📝 结果」代码块占位,让用户把命令输出/看到的现象直接贴进去。文件因此同时是「操作清单」和「结果记录单」。
-
命令可直接复制 — 用 bat / bash 代码块,一条命令一行,行内用 ::(cmd)或 # 注释说明每条在干嘛。不要把多条揉成一行让用户去拆。
-
判断标准随命令给 — 每条命令后面紧跟「有输出 = …,无输出 = …」式的判读规则,让用户自己就能初判,而不是所有结果都攒着等你看。
-
危险操作设护栏 — 删注册表项、删计划任务、conda env remove、rm -rf 这类不可逆操作,明确写「先记下内容发回来确认,别自己删」或给出确认前提。
-
按优先级排序 + 标关键步 — 最该先做、最能定位问题的步骤排最前并标「最关键,先做这个」。可顺带做的排后面。
-
收尾留汇总区 — 文件末尾一个「做完汇总」段落,列出要回报的几项,方便用户一次性发回、你一次性判断。
写完之后
- 告诉用户文件路径,简述每一步在做什么。
- 若这份指南是某个既有文档(如排查记录)的延续,提议把进度回填到原文档的结果区,保持单一事实源。
- 不替用户在 Windows 上执行——你在另一台机器上,执行和回填由用户完成。