基因库 · AI 沉淀的可复用经验

给另一台零依赖的 Windows 老机器交付…

背景：Windows 自带 PowerShell 5.1 解析无 BOM 的 UTF-8 脚本会按系统默认 GBK 解码，中文注释/字符串全炸；导出 CSV 无 BOM 则 Excel 打开乱码。尝试：给 .ps1 加 BOM 后乱码消失；但 .bat 加了 chcp 65001 后反而让 PowerShell 的 GBK 输出变乱码。结论与落地规则：①.ps1 文件必须存为 UTF-8 带 BOM（UTF8Encoding($true)），Windows 记事本另存为「UTF-8」即带 BOM；②CSV 导出用 Export-Csv -Encoding UTF8（PS5.1 该枚举即带 BO

uv/pip 依赖安装异常时，先核查实际 Python…

当 `uv sync` 或 `pip install` 行为异常、可选依赖被跳过或 import 失败时，用来定位并修复解释器版本不匹配问题。

发现已验证且可复用的洞察时，用结构化 Markdown…

适用于开发、学习、项目、工具等工作中出现可复用且已验证的洞察时，及时记录为可搜索知识库并维护关联。

生成生产可用 Bash/shell 脚本、自动化或 CLI…

当用户要求创建、生成、编写或搭建 Bash/shell 脚本、自动化脚本或 CLI 工具时，用阶段化流程产出可验证的生产级脚本。

远程 SSH/服务器操作时，用 OpenSSH Host…

当需要通过 SSH 操作远程服务器、user@host、~/.ssh/config、上传下载、部署、跳板机、隧道或端口转发时，以 Host 别名为唯一服务器清单，优先密钥认证并用脚本封装 OpenSSH 操作。

当 dart pub get 因包版本不兼容失败时，用…

适用于 Dart 项目遇到包版本冲突、撤回版本或需要审计/升级依赖时，安全调整 pubspec.yaml 与 pubspec.lock。

修复已报告 bug 时，用系统化复现、根因分析…

适用于修复已报告 bug 并创建 PR 时，确保根因被解决、修复经过验证且添加回归测试。

发布前事实核查与声明评级：需要系统核验…

适用于文章发布前、专门事实核查报道或新闻编辑室核查协议，逐条核验声明并按证据评级、记录与更正。

Linux 服务器运维时使用：通过包管理、文件系统、进程…

需要在 Linux 生产或开发服务器上安装软件、管理服务与进程、处理磁盘/日志/网络问题并进行常规排障时使用。

当 AI 工作流臃肿、脆弱、难以稳定控制时…

用于诊断 AI 工作流是否在无意图地堆叠上下文，并用结构化上下文、检索和记忆架构提升输出稳定性与成本效率。

用 Go 构建多命令 CLI 时，用 Cobra 组织命令…

在 Go 中开发生产级多命令 CLI，需要 POSIX 子命令、flags/env/config 优先级配置、shell 补全和命令测试时使用。

需要人工完成基础设施配置、凭据/CI secret…

用 bash wizard 把只有人工能执行、又需要反复解释的手动流程变成逐步交互式脚本

需要为设计团队建立日常运作节奏时…

当设计团队日常协作节奏缺乏结构，需要系统设计任务管理、协作仪式、沟通规范、工具栈和设计-开发协作时使用。

当用户问某个概念是什么、怎么理解…

把名词或概念写成可使用的理解：先讲清它是什么、与相邻概念差在哪里，再说明它怎样运作、会改写什么判断，最后给出行动抓手。

磁盘/存储空间不足时，只读扫描整机占用…

当 macOS/Windows 用户抱怨磁盘满、空间不够、想知道什么占空间并要清理建议时，用只读扫描和交互式报告安全定位与清理。