WorkBuddy 可复用技能（Skills）集——把验证有效的 AI 工作流沉淀成可安装技能，随时复用、持续扩展。
| 技能 | 一句话 | 入口 | 状态 |
|---|---|---|---|
| scenario-walkthrough 场景走查 | 先按真实功能生成操作剧本（点哪→输什么→得什么），再逐条读代码模拟执行，找链路断裂/权限漏洞/状态机矛盾 | skills/scenario-walkthrough/SKILL.md | v3 稳定 |
| minimal-repro-diagnosis 最小单元链路诊断 | 排查"效果不对/只还原一部分"——新建最小单元复现（必须真实数据）→ 链路拆 N 步逐步对比特征差异（lost/gained）→ 差异集中步即根因，权威资料交叉验证后修复、全链路回归；附还原开关实验台反推外部程序行为 | skills/minimal-repro-diagnosis/SKILL.md | v1 稳定 |
| github-env-fix GitHub 环境修复 | git 推送/发布前置步骤——根治凭据弹窗 credentialhelperselector/GCM（设全局 credential.helper=），确认保留 7890(Clash) 代理（墙内必须走代理才连得上 github，绝不"清代理直连"）；跑完环境即就绪再交棒 |
skills/github-env-fix/SKILL.md | v1 稳定 |
| github-connect-diag GitHub 连接诊断 | 诊断 git push 失败/挂起/弹 credentialhelperselector 的根因——症状→根因对照表（凭据弹窗为元凶/curl 劫持假失败/schannel SSL/空代理覆盖兜底）+ Python urllib 判网（不用 curl）+ 保留 7890 代理 | skills/github-connect-diag/SKILL.md | v1 稳定 |
| github-push-universal GitHub 代码推送 | 本地代码推到 GitHub 分支——git 优先，失败自动回退 GitHub Contents API（幂等对齐）；Python push_repo.py，全程不弹 GCM |
skills/github-push-universal/SKILL.md | v1 稳定 |
| github-release GitHub 版本发布 | 打 tag + 建/更新 Release + 传 zip 资产，纯 API（Python release_repo.py），幂等；先推码后发布 |
skills/github-release/SKILL.md | v1 稳定 |
| docs-ssot-convergence 文档 SSOT 收敛 | 分散多文档收敛为单一权威源(SSOT)+派生视图,按 主线→支线→模块化 三视角组织总领文档,手册去重引用,旧快照降级标注,最后文档级场景走查挖净死角(声明≠可操作/触发边界防环/版本语义真值表) | skills/docs-ssot-convergence/SKILL.md | v1 稳定 |
| isolated-diag-page 隔离诊断页 | 写独立诊断页实测环境/API 可用性与数据落盘（写后读回自证），用真实数据定位根因，不靠猜——适用 API/iframe/权限类反复修不好的 bug | skills/isolated-diag-page/SKILL.md | v1 稳定 |
| wpf-visual-tree-ai-eyes WPF AI 眼睛 | 让 AI 直接"看"运行中的 WPF 程序：self-hosted 接入（DEBUG-only，Release 纯净）→ 读元素树 / 按 name·文本·类型定位 → screenBounds 量化坐标间距位移 → 模拟点击驱动状态，给数字当证据替代截图往返；附布局位移（行高收缩/拉伸）量化验收法 | skills/wpf-visual-tree-ai-eyes/SKILL.md | v1 稳定 |
| superellipse-icon 超椭圆图标 | 把方形源图按 WindowTinter 超椭圆标准裁成应用图标——超椭圆裁剪（n=4 大尺寸/n=8 小尺寸）+ 6 分辨率 ICO(16/32/48/64/128/256, 32bpp PNG 条目)；附零配置 make_icon.py（仅需 Pillow） |
skills/superellipse-icon/SKILL.md | v1 稳定 |
| png-sequence-to-webp 序列帧转 WebP | 设计序列帧（PNG/SVG/WebP）→ WebP 交付：按组跑全量基准定无损/有损（扁平·单色组无损更小且零误差，只有软渐变组才值得有损，混合模式严格占优）+ 容器级 mux 合成动态 WebP（复用原始 VP8L 码流，避开 Pillow 偷合并帧、透明区残留上一帧两个坑）+ --recolor 配色替换（alpha 原样保留）；附 2 个零依赖脚本，均带双重核验 |
skills/png-sequence-to-webp/SKILL.md | v1 稳定 |
| 技能 | 一句话 | 归档说明 |
|---|---|---|
| git-push-proxy-fix | 旧：git push 反复失败但代理正常时的空代理覆盖诊断 | 被 github-connect-diag 吸收（空代理覆盖列为兜底分支） |
| github-contents-api-push | 旧：Contents API 逐文件 PUT（Node 版） | 被 github-push-universal 取代（Python 版，含自动回退） |
每个技能是一个目录，内含 SKILL.md。安装到 WorkBuddy 用户技能目录：
# Windows
# 复制 skills/<技能名>/ 到你的用户技能目录
# 例：scenario-walkthrough → C:\Users\<你>\.workbuddy\skills\scenario-walkthrough\安装后在对话中说对应触发词（见各技能 description）即可使用。
- 四件套：README（用户向）/ AGENTS（AI 向+文档基线）/ DEVELOPMENT（开发者向）/ CHANGELOG（版本记录）
- 文档基线：AGENTS.md 顶部标日期 + commit hash，改后更新（断点续传）
- 生长式拆分：主文件超阈值才拆（README >150 行、AGENTS >150 词、DEVELOPMENT >200 行），平时保持精简
- 新增技能五件事：
skills/加目录 + README 技能列表加行 + CHANGELOG 加版本节 + AGENTS 基线行更新 + DEVELOPMENT 补坑记录（一坑一篇）
- 知识库（跨项目文档沉淀）：https://github.com/Simiely/knowledge-base