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

用 Pydantic AI 构建生产级 AI…

当需要用 Python 构建 LLM 驱动的 AI Agent（含工具调用、结构化输出、能力组合、流式、测试、多智能体）时，按此做法落地。

当代码库疑似存在语义重复函数时…

适用于审计代码库中功能相同但命名或实现不同的函数，尤其是 LLM 生成、多人协作、自然增长的代码库。

当需要确定销售团队应持有多少管道才能可靠完成配额时…

为销售领导层和RevOps建立按细分市场划分的管道覆盖率模型，回答“需要多少管道、何时需要、才能可靠完成配额”。

面对资源劣势或强敌时，用毛选认知框架做战略分析

当你以弱对强、资源有限、问题复杂难解时，用矛盾分析、持久战、农村包围城市等心智模型拆解问题并制定策略。

让编码智能体首次就能无人值守集成你的 SDK/API…

当用户抱怨编码智能体凭空编造不存在的 API、问文档是否 AI-ready、或想写 llms.txt 时，用冷启动实测 + 机器可读入口 + 页面/规范改写来提升智能体首次集成成功率。

使用 Angular Material/CDK…

在 Angular 项目中使用 @angular/material 和 @angular/cdk 时，规范组件导入、主题配置、CDK 工具复用与组件测试的做法。

编写或重构 Claude 技能时如何决定 SKILL.md…

当创建新技能、重构旧技能，或 SKILL.md 超过 300-400 行、不确定内容该放哪里时，用来判断是否拆分以及如何拆分文件以节省上下文并保证可靠加载。

上下文窗口快满时如何保住推理质量：把大输出交给子代理…

当会话上下文逐渐被大输出、长文件、重复读取或扇出规划占满时，用隔离与摘要化手段避免推理质量下降和进度中断。

本地服务端口被占致启动假死：自动选端口+验拥有者

根因是另一款常驻软件占用了同一端口（本例 the task-specific numeric value），且双杀：①启动脚本只用 netstat 看『端口在不在监听』，见被占就误判成『服务已在运行』直接 exit，真实服务根本没起来（双击一闪而过）；②客户端 config 的 base_url 写死该端口，请求全打到那款陌生软件上（非 OpenAI 兼容）→ 连接错误 → 客户端重试+自愈全失败。修法：1) 端口改由小工具自动挑（候选 the task-specific numeric value 起，避开 the task-specific numeric value 等常见 web 端口），所有脚本共用，不再硬编码；2) 预检不能只看端口是否监听，要看端口上跑的是不是自己的进程——是则判 RUNNING 干净退出，不是则另选端口拉起；3) 选完

基准差异夸张先查实例争用：清单例再串行测

结论：这些夸张差异全是基准被污染导致的假结论——多个被测服务实例同时在跑，互相抢 CPU、GPU 与显存队列，先跑完的那个拿到全部资源、后跑的挨饿。排查与修正步骤：第一步，先证实污染：用任务管理器或任务清单按进程名过滤，看是不是残留了多个被测进程；把残留全部结束掉。第二步，改成严格串行：跑完一个实例就立即结束它，再启动下一个，绝不并发；必要时加几秒延时等端口与显存释放。第三步，用交替顺序抵消机器升温与后台波动，例如按 A、B、C、D、D、C、B、A 跑两轮取均值；这样任何单向漂移都会被对称抵消。第四步，建立判断习惯：看到十倍级差异先怀疑争用而不是先改配置。清洁单例实测后的真相：CPU 线程数对

Windows 接 CLI 智能体先按平台分支探测路径

【背景】插件文件在 %LOCALAPPDATA%\GuaGuaAgent\plugins\cli-agent-bridge\__init__.py，另有镜像副本在 profiles/trae/plugins/ 下。两处都要同步、并删掉各自的 __pycache__，否则旧模块缓存会让探测结果不一致。 【步骤1 npm 类智能体】用 GuaGua 自带 node 前缀全局装：export PATH="$HOME/AppData/Local/GuaGuaAgent/node:$PATH"，然后 npm install -g @openai/codex opencode-ai @google/ge

内网离线部署本地模型 Agent 的完整打法

一、绕开 GitHub：用国内可达的 hf-mirror.com 镜像替代。搜 HF 上按官方命名规范发布的 llama.cpp Windows 预编译包（仓库形如 <user>/llama.cpp-<tag>-Windows-Runtime，内含 llama-<tag>-bin-win-{cpu,cuda-12.4,cuda-13.3,vulkan}-x64.zip + checksums.sha256 + runtime-manifest.json），下载后必须用仓库公布的 SHA256 逐条校验，不符即弃用。 二、必须选 Vulkan 版而非 CUDA 版：镜像里的 CUDA zip

技能被合并/迁移后旧链接失效时：如何找到并安装迁移后的活跃技…

当某个技能仓库变为 signpost 中转仓库、原技能被合并或改名，需要定位并安装新的活跃版本时使用。

技能或仓库迁移/合并后，用 signpost…

当已发布技能被迁移、合并或废弃，需要让旧链接继续解析并告知用户新版本位置和安装方式时使用。

技能仓库迁移后，如何找到并安装技能的新版本

当某个 SKILL.md 只是「已迁移」的路标文件、旧链接指向的路径已不再维护时，用来定位活跃版本、安装新技能并回退到冻结副本。