你是不是也经常卡在这些地方？
不是能力不够，而是没人把踩过的坑提前告诉你
打包好的 exe，一到客户电脑就崩
黑窗一闪、缺库报错、DLL 加载失败……在自己电脑好好的，发出去就各种问题，查到最后还是那几个老坑。
AI 答非所问，来回试错
同一句话反复描述需求，AI 给的却是网上抄来的通用答案，落不到你的项目里，越改越乱。
每次都要重新交代背景
换个会话、换个工具就得把项目背景、技术栈、约束再讲一遍，AI 记不住，你也讲烦了。
报错只会给「大概也许」
遇到异常，AI 泛泛而谈一堆可能性，却不知道你这个技术栈里真正的根因，只能自己一个个试。
文档 / 插件发布处处是坑
README、WordPress、Z-BlogPHP 发布规范能列一长串，审核被打回才知道哪没做对。
经验攒不起来，重复踩坑
踩过的坑、验证过的做法没被沉淀，下次换个项目又重新踩一遍，时间都浪费在重复劳动上。
这套技能，正是为这些人准备的
只要你在用 AI 做开发或办公自动化，它就值得拥有
独立开发者 / 接私活的工程师
一个人扛产品全流程，既要写界面又要打包授权，最缺的就是少走弯路。
办公自动化 / 提效从业者
经常要给同事做小工具、批量处理文档表格，想用 AI 提效却总被环境与打包卡住。
企业内部的工具开发者
为公司做内部系统与桌面工具，交付要稳、要能维护，不能靠试错。
需要分发软件的小团队
要把写好的程序打包发给客户，还要加授权保护，缺乏成熟做法可循。
WordPress / Z-BlogPHP 插件作者
想让插件顺利上架应用商店，却总在规范与审核细节上栽跟头。
刚上手 AI 编程的新手
工具会用，但不知道怎么让 AI 真正专业起来，常被「看起来很对」的答案带偏。
符合任意一条，这套技能大概率能帮你省下大量反复试错的时间。
什么是 Agent Skill（AI 技能）？
Agent Skill 是面向 AI 编程助手的标准化知识单元：一个目录 + 一个 SKILL.md 文件，用自然语言把某个领域的做法、规范与避坑经验写成 AI 可直接读取的说明书。
把它装进 AI 工具，AI 在该领域就会显著更专业——不必每次重复交代背景，也能按行业最佳实践给出可落地的方案。
softbangong AI 技能全集把 34 个打磨自真实项目的技能打包成一个离线包，一键装进你正在用的 AI 工具。
为什么值得拥有
不是零散的小技巧，而是从真实项目里沉淀下来、可直接复用的工程经验
覆盖完整工作流
从「搭环境 → 写界面 → 处理文档 → 打包 exe → 加授权 → 记日志 → 排错」，Python 桌面工具全链路技能一应俱全，不必东拼西凑。
沉淀实战避坑经验
打包黑窗、缺库、DLL 失败、线程崩溃、编码乱码、DPI 模糊……每个坑都给出「症状 → 根因 → 修法」，让 AI 直接对症下药。
即下即用跨工具
标准 SKILL.md 格式，一键脚本自动探测并安装到你已装的 40+ 种 AI 工具，重启即生效，无需任何配置。
不止 Python，还懂设计发布
同时覆盖 Adobe PS/AI/PDF 自动化、WordPress 与 Z-BlogPHP 插件开发发布、README 文档 SEO，横跨开发到上线。
自带智能索引
内置技能总索引与「症状→技能→小节」二级定位表，AI 能快速找到该用哪个技能，避免答非所问、反复试错。
持续更新可自助覆盖
技能来自真实项目持续打磨，新版本直接下载覆盖即可升级，版本号一目了然。
还附带开箱即用的模板
不止教你怎么做，更把可直接套用的界面模板与文档模板一起给你，省去从零搭架子的时间
tkinter 桌面工具模板
通用批处理工具骨架，界面、菜单、拖拽、日志、进度条都已搭好，套上业务逻辑即可运行。
- 通用 tk 模板 + tk 模板 2 号，两套可选
- 文件 / 文件夹 / Excel / 图像批量处理封装
- 可取消子进程与线程生命周期回调
PyQt5 现代 UI 模板
侧边栏导航 + 多页面 + 可编辑表格 + 图像画布，成熟界面直接引用，改业务即可交付。
- 侧边栏 + QStackedWidget 多页面架构
- 可编辑表格（复制 / 粘贴 / 拖拽）与菜单拖拽排序
- QGraphicsView 画布与多区域控制点
Word / Excel 模板填充
占位符映射 + 跨 Run 保格式替换，批量生成合同、报表、送货单，格式不跑偏。
- Excel 列 → Word 占位符映射
- 跨 Run / 表格 / 页眉页脚保格式替换
- 多行合并文档（自动插入分页符）
一套选型标准，同时适配 tkinter 与 PyQt5
默认用嵌套 Tab 型；功能扁平、模块少用外部 Tab 型；模块多、层级深的复杂项目升级为侧边栏型。选型逻辑两框架一致，换的只是控件名。
三步装好，即下即用
下载 → 解压 → 运行安装程序，自动装进你电脑上的 AI 工具
下载并解压
完成购买后获取技能包 .rar，解压到任意位置。
一键安装
在解压目录运行图形化安装器 install.exe（双击即用），界面自动检测并安装到你已装的 AI 工具。
重启生效
重启对应 AI 工具或新开会话即可使用。更新时重下最新版覆盖即可。
技能清单（34 个 · 8 大类）
按八大主题分组，每个技能列出 15 项核心能力（未尽之处以 … 表示，更多细节详见技能包）
系统说明：本技能包仅适配 Windows 系统（Windows 7 及以上 64 位操作系统），一键安装器为 Windows 图形化安装程序（install.exe，双击即用）。
Python 桌面应用开发
5 个技能 · 75 条要点用 tkinter / PyQt5 构建 Windows 桌面办公工具，覆盖界面、Word/Excel 文档、图像与 OCR 全流程。
用 tkinter / PyQt5 构建办公自动化批量工具的通用模式。
- 架构决策：tkinter / PyQt5+QTab / CLI 三种选型
- UI 模板优先级（tk 模板、tk 模板 2 号、qt 模板直引）
- About 页面四段式内容与格式规范
- 通用 tkinter 批处理工具骨架模板
- 文件 / 文件夹：安全递归处理、批量重命名（模式）
- 文件 / 文件夹：按关键词移动、目录扁平化、删除空文件夹
- Excel：带编码读取、带格式写入、整表带格式复制
- 图像：通用批量处理器、PIL / OpenCV 操作
- 文档透视变换（多区域检测与矫正算法）
- Word → PDF 多引擎（MS Office / WPS / LibreOffice）
- PDF：页数统计、按组合并、fontTools 警告消除
- FFmpeg：视频元数据读取、通用滤镜命令构建
- 文本：编码安全读写、乱码处理
- 可取消子进程管理、线程生命周期回调
- 关键实现原则与避坑
- 等……
PyQt5 桌面办公工具的现代 UI 模式库。
- 侧边栏导航 + QStackedWidget 多页面架构
- 最高优先级 UI 界面参考模板（qt 模板直引）
- 核心组件清单与最小可运行骨架
- 图片文件拖放加载（多区域支持）
- 批量文件列表：主窗口整窗拖入（列表区 + 空白区）
- 批量任务进度条：三态信号协议（防「开始即满格」）
- QGraphicsView 图像画布与多区域控制点
- 控制点图元：固定屏幕大小且贴住图像坐标（worldTransform）
- 多区域激活 / 非激活样式同步（_sync_items）
- 点击切换激活 + 拖动控制点交互
- 坐标体系（原图 ↔ 显示图）换算
- 可编辑数据表格（复制 / 粘贴 / 拖拽）
- 拖拽菜单排序与可视化落点指示
- 可折叠面板、缓冲日志、搜索过滤
- JSON 配置持久化 + CSS 现代样式
- 等……
PyQt5 批量 Word 文档文本替换工具。
- Word XML 级别替换（保留原格式）
- 灵活文本匹配（_find_flexible_span）
- 通配符替换（* 匹配单字符）
- 跨段落多行替换
- 表格单元格保留格式填充
- 多规则批量替换
- Excel 到 Word 模板填充
- 文件夹结构保留输出
- 段落 / 表格 / 页眉页脚全范围处理
- PyQt5 后台 Worker 模式（不卡界面）
- JSON 配置持久化与任务复用
- 核心技术栈与快速开发步骤
- 最高优先级 UI 参考模板（qt 模板）
- 独立可运行脚本
- 适用场景与边界说明
- 等……
tkinter Word 模板 + Excel 数据合并工具。
- 多组配置架构（一套数据多份模板）
- Excel 列映射机制（列 → 占位符）
- 构建替换对（_build_pairs_from_map）
- 跨 Run XML 替换（保留原格式）
- 多区域替换（段落 / 表格 / 页眉页脚 / 文本框）
- 多区域替换（批注 / 脚注 / 尾注 / 内容控件）
- 图片路径自动检测与插入
- 多行数据合并文档（插入分页符）
- 子目录按名称递归搜索文件
- 拖拽文件输入
- DPI 自适应缩放
- JSON 配置自动保存
- Worker 线程 + 消息队列
- 核心技术栈与核心工作流
- 独立可运行脚本
- 等……
「图片 OCR → 数据清洗 → Excel 模板填充」桌面工具。
- PaddleOCR + PyQt5 + PyInstaller onedir 架构
- 「图片 OCR → 数据清洗 → Excel 模板填充」全流程
- OCR 版式解析与识别结果缓存
- 数据清洗与字段规整
- Excel 模板保真填充业务规则
- openpyxl 富文本 / 合并单元格 / 边框保真
- windowed 打包部署（无黑窗）
- PyInstaller onedir 打包流程
- PaddleOCR 打包体积与缺库处理
- 系统约定（贯穿各模块，勿破坏）
- 开发 / 改业务功能 → 先读架构
- 打包发布 → 按打包流程走
- 排查问题 → 先查症状表
- 十余类实战问题（根因 + 修复）速查
- 附加资源与参考文件
- 等……
Python 问题排查与避坑
7 个技能 · 105 条要点以「症状 → 技能 → 小节」二级定位为核心的排查族群，遇到报错按现象即可精准命中解决方案。
Python 桌面开发问题排查总索引。
- 「症状 → 技能 → 小节」二级定位表（50+ 条症状）
- 覆盖环境依赖 / 打包 / Qt / Tk / 框架选型 / 文件数据
- 按报错现象一步直达对应解决方案
- 环境与依赖症状入口
- 打包发布症状入口
- Qt 版 GUI（PyQt5/PySide）症状入口
- Tk 版 GUI（tkinter）症状入口
- 框架选型与平台兼容症状入口
- 文件与数据类症状入口
- 六大子技能统一入口索引
- 技能分类总览
- 模板与参考文件
- 使用步骤（先匹配现象再跳转）
- 症状表维护与扩展约定
- 相关技能交叉引用
- 等……
开发环境搭建与依赖安装问题排查。
- 症状速查表（按报错直达小节）
- pip 安装失败与国内镜像源配置
- pip 权限不足处理
- 虚拟环境隔离与切换
- 依赖版本冲突（pandas/xlrd、PyPDF2、openpyxl）
- 中文路径与编码问题
- 32 / 64 位不匹配
- tkinter 缺失修复
- PyQt5 与 Python 版本兼容
- pip 缓存损坏清理
- Python 多版本环境切换
- 依赖锁定与 requirements 导出
- 离线安装与 whl 包
- 关键原则
- 相关技能交叉引用
- 等……
文件读写与数据处理问题排查。
- 症状速查表（按现象直达小节）
- 文本编码乱码（GBK / UTF-8、chardet 探测）
- subprocess 输出编码与乱码
- Excel 读取引擎选择（openpyxl / xlrd）
- Excel 公式缓存值读取（data_only）
- Word 跨 run 替换破坏格式
- 中文路径与超长路径处理
- 跨盘移动 / 复制
- os.walk 遍历顺序控制
- 图片 EXIF 方向自动纠正
- 文件被占用（拒绝访问）处理
- 输出目录自动创建
- 文本 / 二进制模式与缓冲刷新
- 关键原则
- 相关技能交叉引用
- 等……
GUI 框架选型与平台兼容性决策。
- 症状速查表
- tkinter 与 PyQt5 / PySide 框架对比
- 选型决策流程
- Intel / AMD 跨 CPU 平台表现不一致的原因
- 跨平台兼容性规避策略
- 双平台实测验证清单
- 打包体积与依赖差异对比
- 授权与商业许可考量（PyQt GPL）
- 开发效率与 UI 能力对比
- 迁移成本评估
- 目标用户环境适配建议
- 框架决策与平台兼容建议
- 快速选型速查表
- 常见误判与提醒
- 相关技能交叉引用
- 等……
打包发布与运行时问题排查。
- 症状速查表
- PyInstaller 打包命令速查
- __file__ 临时目录陷阱（onefile）
- 资源文件打包与路径解析
- stderr 为 None 导致的二次崩溃
- 日志位置与 TEMP 降级
- 日志滚动策略
- VC++ 运行库缺失
- 32 / 64 位不匹配
- 安全软件拦截跨盘操作
- 隐藏导入（hiddenimports）
- multiprocessing freeze_support
- 闪退诊断速查表
- 关键原则
- 相关技能交叉引用
- 等……
Qt 版 GUI 问题排查（PyQt5/PySide）。
- 最高优先级 UI 界面参考模板
- 症状速查表
- QThread 生命周期管理
- 线程对象释放竞态
- 跨线程信号排队延迟
- 进度信号堆积
- C++ 对象已删除（RuntimeError）
- platform plugin 缺失
- offscreen 无头测试
- 中文乱码与字体
- 样式表选择器失效
- 高 DPI 缩放
- 框架选型与平台兼容
- UI 布局与交互规范（完整模板）
- 关键原则
- 等……
Tk 版 GUI 问题排查（tkinter）。
- 最高优先级 UI 参考模板（1 号 / 2 号）
- 1 号模板架构速览
- 2 号模板架构速览（侧边滑块 + 紧凑布局）
- 症状速查表
- 线程安全（只能主线程操作 UI）
- threading + queue + after 轮询模式
- 高 DPI 缩放
- 日志刷新性能
- 文件拖拽
- 中文字体
- after 回调异常
- 关闭时线程处理
- 启动闪现（先左后中）
- 框架选型与平台兼容
- UI 布局与交互规范（完整模板）
- 等……
Python 打包·授权·日志
4 个技能 · 60 条要点把 Python 项目打成 exe、加授权保护，并让运行日志可精准定位崩溃。
PyInstaller 打包疑难问题排查。
- 何时使用 / 适用边界
- 一句话认知（打包问题定位观）
- 黄金判据：不要「见到 traceback 就判失败」
- 症状定位表（按现象直达）
- 启动黑窗闪现
- 运行时 ModuleNotFoundError / KeyError
- DLL load failed
- 「含 traceback 其实打包成功」误判识别
- 图标异常
- Qt / Tk 双框架互斥
- 体积暴涨治理
- 资源与字体丢失
- 日志乱码
- 「症状 → 根因 → 修法」定位方法
- 附加资源与参考文件
- 等……
PyInstaller spec 配置生成。
- 何时使用
- 一句话认知
- 工作流速查（先看四段结构）
- 依赖扫描：拿到真实用到的库清单
- 规则引擎：决定排什么、收什么
- AST 依赖扫描
- 离线「坑规则」引擎
- hiddenimports 收集判定
- datas 收集判定
- binaries 收集判定
- excludes 收集判定
- spec 四段拼接（Analysis / PYZ / EXE / COLLECT）
- 运行期守护钩子
- 运行时仍缺库 → 探针兜底
- 系统约定（改动时勿破坏）
- 等……
为 Python exe 增加授权校验与加密保护。
- 何时使用
- 一句话认知
- 工作流速查
- 本地授权注入（AST 识别启动点）
- 本地激活壳
- 发码 Excel 台账（一程序一密钥复用）
- 网络验证（kami SDK）集成
- 跨程序隔离
- pyarmor 源码混淆
- 「载荷加密 + 验证壳」二次打包防绕过
- 硬失败铁律（与「失败不阻断」不同）
- 关键约束（改动时勿破坏）
- 授权静默失效 / 自动识别失败排查
- 混淆后缺库排查
- 附加资源与参考文件
- 等……
Python 桌面工具日志模式与崩溃定位。
- 适用场景
- 核心原则
- 日志文件始终生成
- 日志生成位置（exe 打包场景核心代码）
- sys.frozen / sys.executable 与 __file__ 对比
- 目录不可写时降级到 TEMP
- 错误日志机制三层防线
- 启动必写 + 全局异常钩子
- 工作线程异常落盘（stderr=None 二次崩溃容错）
- 线程内直写 + 逐条目日志（闪退精准定位）
- 绕过 Qt 信号队列的线程内直写
- 闪退诊断速查表
- 关键陷阱
- 验证方法（offscreen 无头测试）
- 相关技能
- 等……
Windows 脚本自动化
4 个技能 · 60 条要点批处理与 VBScript 脚本，自动化 Windows 的文件、注册表、COM 应用与系统管理。
编写 Windows 批处理（.bat）脚本。
- 脚本骨架模板
- 变量与延迟扩展（setlocal enabledelayedexpansion）
- 字符串替换、子串截取与日期处理
- 三种核心循环结构（for /r、/d、/f、/l）
- 路径变量扩展速查（%~dp0 等）
- dir 命令常用组合与管道模式
- 条件判断（errorlevel / 文件存在 / 字符串比较 / findstr）
- 交互与循环模式（单次 / 循环 / 拖放文件执行）
- 字符串处理技巧（批量替换 / 删除字符 / 删除前 N 字符）
- WinRAR 命令行集成（自动检测路径、解压 / 压缩 / 删除 / 添加）
- 7-Zip 命令行（备选方案）
- 注册表操作与网络配置
- ImageMagick 集成
- 清理与维护（删空文件夹 / 删旧文件 / 删重复文件）
- 文件输出重定向与常见反模式
- 等……
Windows 自动化的核心 VBScript 编程模式。
- Essential Objects：FileSystemObject / WScript.Shell
- Text File I/O：读取文件
- Text File I/O：写入文件
- Text File I/O：追加内容
- Text File I/O：逐行过滤模式
- 文件夹遍历：按名称匹配子目录
- 文件夹遍历：按扩展名遍历文件
- 错误处理（On Error Resume Next）
- 脚本路径与环境变量
- 用户交互（MsgBox / InputBox）
- 程序流程：提前退出
- 程序流程：不存在则创建 / 删除重建文件夹
- 字符串与行结束符（CRLF / LF）
- 静默启动外部进程
- 脚本编码说明
- 等……
VBScript 自动化 Windows COM/OLE 应用。
- Adobe Acrobat Automation：对象层次
- Adobe：PDF → PPTX 转换
- Adobe：SaveAs 格式字符串
- Adobe：带错误处理的初始化
- Microsoft Excel：打开工作簿并操作单元格
- Excel 清理清单（避免残留进程）
- Python COM Interop：Python.Dictionary（IDispatchEx）
- Python COM Interop：Python.Interpreter
- 桌面与 Shell 自动化：切换显示桌面
- 创建桌面快捷方式 / WshShortcut 属性
- SpecialFolders 名称
- 通用 COM 技巧：对象创建方式
- 检测 COM 对象是否创建成功
- 始终清理释放 + 常见错误码
- 组合流程模式（Combined Process Flow）
- 等……
桌面工具内嵌 Windows 系统级管理功能。
- 适用场景
- 命令执行底座
- 检测 / 处理双页按钮架构
- 防火墙规则检测（入站 / 出站）
- 双语解析器（一次解析，中英文系统通吃）
- 按关键词筛选目标软件规则
- 防火墙策略检测（配置文件 + 服务）
- 程序化处理（需管理员 + 确认）
- 放行规则：幂等「先删后加」+ 入站 / 出站两条
- 删除阻止规则、恢复防火墙默认（分步 + 1056 特判）
- 手动打开通道（只读兜底）
- 软件安装位置探测（注册表兜底为权威数据源）
- 32 位进程路径重定向（最先排查的坑）
- 完整收集器（标准目录 + 注册表兜底 + normcase 去重）
- 版本化目录前缀匹配、插件子目录候选表
- 等……
Adobe 与 PDF 开发
5 个技能 · 75 条要点Photoshop / Illustrator / Acrobat 的脚本、插件、COM 自动化与 PDF 处理调试。
PS / AI 自动化的通用 ExtendScript 编码模式。
- 项目搭建模板（Project Setup Template）
- 核心操作三件套：ActionDescriptor / ActionReference / ActionList
- 分步函数执行模型（Step Function Execution Model）
- 命名空间封装（Namespace Encapsulation）
- 通用调整图层创建（Generic Adjustment Layer）
- 曲线调整（自定义点，Curves Adjustment）
- 蒙版操作（Mask Operations）
- Blend If / 混合选项（Blending Options）
- 文档与图层验证
- 图层操作（Layer Operations）
- 智能对象与高级操作
- 文件导出模式（File Export Patterns）
- ScriptUI 对话框模式
- 混合模式速查、颜色操作、选择画笔工具
- 关键 Action ID 速查表
- 等……
Adobe Illustrator 开发文档参考。
- 知识库位置
- 知识库结构速查
- ExtendScript 脚本（docs/scripting/）
- UXP 插件 / 脚本开发（docs/uxp/）
- C++ SDK 原生插件开发（docs/cpp-sdk/）
- COM/OLE 自动化（docs/com-automation/）
- 四种技术路径对比
- 按任务快速查找
- Illustrator 对象模型（关键层次）
- 坐标系要点
- 关键代码模式
- 核心开发概念汇总
- 在线资源
- 使用方式
- 相关技能交叉引用
- 等……
Adobe Photoshop 开发文档参考。
- 知识库位置与结构速查
- UXP 插件 / 脚本开发（docs/uxp/）
- ExtendScript 传统脚本
- COM/OLE 自动化（VBScript / Python / C#）
- Generator（Node.js 资源生成）
- Photoshop API / Cloud REST API
- 按任务快速查找
- 四种技术路径对比
- UXP vs ExtendScript 关键差异
- executeAsModal（UXP 核心模式）
- COM 对象模型（Photoshop.Application）
- 保存格式常量（COM）
- 开发工具速查
- 在线资源与使用方式
- 相关技能交叉引用
- 等……
Adobe PDF 开发文档参考。
- 知识库位置
- 知识库结构速查
- PDF 规范（docs/pdf-spec/，ISO 32000）
- Acrobat SDK（docs/acrobat-sdk/）
- PDF Library SDK（docs/pdfl-sdk/）
- 按任务快速查找
- 三种开发路径
- IAC（应用程序间通信）COM 对象层次
- SaveAs 格式字符串
- Acrobat API 四层架构
- Acrobat JavaScript 要点
- 插件开发要点
- 许可限制
- 在线资源与使用方式
- 相关技能交叉引用
- 等……
调试 OCR PDF 不可见搜索层问题。
- 根本原因（不可见搜索层错位）
- 诊断流程 1：确认问题是布局而非内容
- 诊断流程 2：排除不可见字符污染
- 应用修复：水平缩放文本矩阵（Tm）
- 诊断流程 4：验证修复效果
- 常见陷阱
- 速查：Tm vs Tf vs TJ
- 修复选中文本高亮「白色尾巴」
- 文本矩阵 Tm 水平缩放修复
- 不可见字符清洗
- 搜索层与页面坐标系对齐
- OCR PDF 生成流程回顾
- 诊断工具与验证方法
- 常见错误认知与排查顺序
- 相关技能交叉引用
- 等……
WordPress 开发与发布
2 个技能 · 30 条要点WordPress 插件 / 主题开发文档，以及插件发布规范与后台 UI 标准。
WordPress 官方开发文档参考。
- 知识库位置
- 知识库结构速查
- 插件开发（plugins/）：插件结构
- 主题开发（themes/）：主题类型
- 钩子（Hook）系统（Actions / Filters）
- REST API
- 区块编辑器
- Settings API
- 短代码
- 自定义文章类型与分类法
- HTTP API
- 国际化与安全三原则
- theme.json 核心配置
- 版本要求与发布到 WordPress.org
- 使用方式
- 等……
WordPress 插件发布规范与后台 UI 规范。
- Part A：发布元信息规范（插件头部 / 清单 / 版本号同步）
- Part B：中英文双语界面（描述 / 设置链接 / 内部切换）
- 三种语言模式（auto / zh_CN / en_US）
- 重要规则
- Part C：管理界面 CSS 样式隔离与自适应布局
- 容器与自适应宽度、字体 / 色彩规范
- UI 组件结构与组件 CSS 模板
- Part D：模块总开关与实时折叠展开
- Part E：子项开关与配置区域联动显隐
- Part F：功能项 UI 组件规范（F1–F7）
- Toggle Row / 滑动开关 / 说明文字 / Grid 布局
- 左侧竖线视觉规范与完整 DOM 结构
- Part G：常见问题与解决方案（G1–G5）
- Checkbox 事件、FOUC 闪烁、addEventListener 失效
- Part H：PHP 静态缓存性能优化
- 等……
Z-BlogPHP 开发与发布
2 个技能 · 30 条要点Z-BlogPHP 插件 / 主题开发文档，以及应用商店发布合规与后台布局标准。
Z-BlogPHP 官方开发文档参考。
- 知识库位置
- 知识库结构速查
- 入门指南（start-*.md）
- 开发指南（dev-*.md）核心文档
- API 参考（api-*.md）
- API 模块速查表
- 按任务快速查找
- 插件结构
- 钩子（Hook）系统
- API 统一入口
- 链式查询（ChainQuery）
- 主题开发
- 路由
- 版本要求及应用发布
- 使用方式
- 等……
Z-BlogPHP 插件发布与合规规范。
- plugin.xml 元数据标准化与作者模板
- 文件编码（UTF-8 无 BOM）
- 必需资源（logo 128×128 等）
- JavaScript 规范（var → let/const）
- main.php 入口引导（Correct Bootstrap）
- include.php vs main.php 守卫差异
- 后台表单提交按钮（HTML / CSS / POST 处理）
- 提交后重定向的必要性
- 纯 CSS 滑动开关、表单字段类型速查
- 后台菜单注册（MakeTopMenu 顶部菜单）
- 左侧菜单 → 顶部菜单迁移清单
- 安全检查（CSRF / XSS / 权限 / 重定向）
- CSS 作用域隔离与自适应布局
- 命名空间隔离、卸载清理、打包 zbignore
- 12 类常见问题与解决方案
- 等……
文档 · SEO · 技能导航
5 个技能 · 75 条要点README 排版优化与 SEO 元数据，全部技能的分类索引，解决经验自动沉淀入库，以及产品落地页构建。
每次解决问题后自动把经验沉淀进技能库并自动归类。
- 最高优先级：触发即记录，无需每次提醒
- 五步流程：提炼 → 归类 → 查重 → 写入 → 登记
- 自动归类规则（主题 → 8 大类 → 目标技能）
- 报错类优先归问题排查与打包类
- 做法 / 模式类归对应技术大类
- 跨类通用方法归文档·SEO·技能导航
- 经验条目四要素：症状 / 根因 / 修法 / 边界
- 标题即结论，关键词前置便于检索
- 先查重再写，同主题合并更新
- 无归属时新建独立技能（目录名==name）
- 新增技能同步登记 SKILLS-INDEX 与索引
- 有据才记，只写真实验证过的结论
- 剥离项目专有名词，保留通用结构
- 涉及删除 / 覆盖或归类歧义时才询问
- 等……
单文件自包含、高级感高转化的产品落地页（销售页）构建。
- 单文件自包含，零外部依赖，内联 SVG 图标与 data URI
- 转化型区块顺序：首屏 → 痛点 → 能力 → 清单 → FAQ → CTA
- 首屏价格卡 + 限时倒计时
- 深墨黑 + 单一品牌色高级感视觉系统
- 玻璃态吸顶导航 + 渐变微光阴影
- 全屏铺满布局与 clamp 流式字号
- 响应式断点与移动端汉堡导航
- 小屏时表格转卡片堆叠
- SEO 基础：title / description / keywords / canonical / hreflang
- Open Graph 与 Twitter Card 社交分享
- JSON-LD 结构化数据（@graph 图谱）
- SoftwareApplication + Offer + AggregateRating
- HowTo 与 FAQPage（GEO / AEO）
- 滚动淡入 + 数字滚动 + 评价跑马灯 + 无障碍
- 等……
生成和优化项目 README 文档。
- 适用场景与触发关键词
- 核心原则
- 一、版式规范
- 二、章节结构模板
- 三、通俗化写作手法
- 四、SEO 元数据规范总览
- Title（自定义 SEO 标题）
- Keywords（自定义 SEO 关键词）
- Description（自定义 SEO 描述）
- Tags（标签）
- SEO 信息章节位置与格式
- 五、禁止项
- 六、完整工作流程
- 七、发布检查清单（GitHub / Gitee）
- 附加资源
- 等……
为插件、主题、项目优化 README.md 的 SEO 元数据。
- 适用场景与触发关键词
- SEO 字段约束与编写规范总览
- Title（自定义 SEO 标题）
- Keywords（自定义 SEO 关键词）
- Description（自定义 SEO 描述）
- Tags（标签）
- 文档编写附加规范：禁止项
- 授权说明规范化
- 真实功能原则
- SEO 元数据位置与 SEO 信息章节
- 全搜索引擎兼容清单
- 价值导向描述
- emoji 与超链接清理
- 格式参考文档、完整工作流程
- 多平台（GitHub / Gitee / 应用商店）元数据
- 等……
技能分类索引。
- Python 桌面应用开发分类索引
- Python 问题排查与避坑分类索引
- Python 打包·授权·日志分类索引
- Windows 脚本自动化分类索引
- Adobe 与 PDF 开发分类索引
- WordPress 开发与发布分类索引
- Z-BlogPHP 开发与发布分类索引
- 文档 · SEO · 技能导航分类索引
- 按八大类汇总全部 34 个技能
- 技能名称与用途说明
- 技能相对路径定位
- 按场景快速选择合适技能
- 分类索引与导航
- 使用方法
- 相关技能交叉引用
- 等……
持续更新
以上为当前 v1.0.0 的全部技能，每个技能列出的仅是核心能力（未尽处以 … 表示）；均来自真实项目的持续打磨，新版本会不断新增与深化——下载最新版覆盖即可升级，无需重装。
我要做这些事，该用哪个技能？
按实际任务快速对号入座，AI 会自动调用对应技能
| 你想做的事 / 遇到的问题 | 推荐技能 |
|---|---|
| 做一个 PyQt5 / tkinter 桌面办公工具 | python-office-batch-toolkit、pyqt5-office-ui-patterns |
| 做 Word 模板填充 / 合同批量生成 | word-excel-template-filler、word-batch-replace-tool |
| 做图片 OCR → Excel 的桌面工具 | ocr-excel-delivery-slip |
| 不确定该用 tkinter 还是 PyQt5 | python-gui-framework-selection |
| 把 Python 程序打包成 exe | python-exe-spec-builder、python-exe-packing-pitfalls |
| 给 exe 加授权 / 卡密 / 混淆 | python-exe-license-shell |
| 排查程序闪退 / 找不到日志 | python-log-error-location、python-dev-issues |
| 写 .bat / .vbs 脚本自动化 Windows | windows-bat-scripting、vbs-core-patterns、vbs-com-automation |
| 用脚本自动化 Photoshop / Illustrator | adobe-extendscript-patterns、adobe-photoshop-dev-docs、adobe-illustrator-dev-docs |
| 自动化 PDF / Acrobat 或调试 OCR PDF | adobe-pdf-dev-docs、pdf-ocr-search-layer-debug |
| 开发 / 发布 WordPress 插件主题 | wordpress-dev-docs、wordpress-publish-standards |
| 开发 / 发布 Z-BlogPHP 插件主题 | zblogphp-dev-docs、zblog-plugin-publish |
| 优化 README / 文档 SEO | readme-optimizer、readme-seo-optimizer |
| 解决问题后自动沉淀经验 / 维护技能库 | skill-experience-autolog |
| 做产品落地页 / 销售页 / 单页官网 | skill-pack-landing-page |
省下的不是一点时间，是被反复试错吃掉的钱
自己硬扛，最贵的从来不是工具费，而是看不见的隐性成本
你正在默默流失的 4 笔隐性成本
这些钱不开票、不进账，却每天都在从你的项目里蒸发
- AI Token 成本没有技能时，AI 反复兜圈子、答非所问，同样的需求要消耗数倍 Token 来回试错，账单在悄悄变厚。
- 时间成本一个坑翻文档、搜帖子、逐个试，半天就没了；按开发者时薪算，这一天就是几百元。
- 返工成本打包黑窗、缺库、DLL 失败、线程崩溃……交付后被打回重改，等于把同样的活干两遍。
- 沟通成本每开一个新会话都要重新交代项目背景与技术栈，讲一遍是时间，讲一百遍是负担。
而 softbangong 技能包只需一次买入，就把这些看不见的成本一次性按下暂停键。
| 对比项 | 自己 / 通用 AI 摸索 | 用 softbangong 技能包 |
|---|---|---|
| 找一个坑的答案 | 翻文档、搜帖子，0.5～2 小时 | AI 按「症状 → 根因 → 修法」直接给方案 |
| 打包 exe 一次成功 | 黑窗、缺库、DLL 失败反复试 | 按技能清单逐条对照排查 |
| PyQt5 / tkinter 选型 | 凭感觉，做一半才发现不合适 | 先按决策技能定框架再动手 |
| 给 exe 加授权 / 卡密 / 混淆 | 不知从何下手，加壳还容易被绕过 | 现成的授权壳与卡密接入范式 |
| Word / Excel 批量处理 | 反复试脚本，格式还容易跑偏 | 模板填充与批量替换的成熟套路 |
| PS / AI / PDF 自动化 | 翻 API 文档，坑一个接一个 | ExtendScript 与 Acrobat 实战模式 |
| 排查闪退 / 找不到日志 | 盲猜原因，改半天不见好 | 日志定位与异常钩子的排查路径 |
| 插件发布过审核 | 被打回后逐条猜错在哪 | 对照发布规范清单逐项自检 |
| 重复向 AI 交代背景 | 每次开新会话都要重讲一遍 | 技能常驻，AI 自己就懂 |
| 成本 | 免费，却持续吃掉你的时间与 Token | 一次买断，永久可用，随用随查 |
他们用过之后这么说
来自不同岗位的开发者真实反馈
以前打包 exe 一报错就卡半天，现在直接问 AI，它按技能里的「症状→根因→修法」给方案，一次就说到了点子上。
同一个需求反复给 AI 解释背景的时代结束了。装上技能后它知道 PyQt5 的坑在哪，少走了太多弯路。
接了个 Word 模板批量生成的活，技能里的模板填充思路直接套用，原本两天的活一天就交了。
给公司做了个送货单 OCR 工具，从环境搭建到打包全程有据可查，不用再花钱找人。
插件提交审核被打回几次，照着发布规范逐条改，这次一次就过了。
PS 批量处理脚本以前全靠试，ExtendScript 的坑技能里写得清清楚楚，省了我不少时间。
做数据报表工具时，日志老是乱码找不到原因，用技能里的定位方法几分钟就查出来了。
创业团队没有专人搞自动化，照着技能包把内部工具一个个做出来，省下了外包的钱。
常见问题
购买与使用前，你可能想先了解这些
这套技能多少钱？怎么购买？
价格与优惠请点击页面上的「立即购买」按钮，在详情页查看并完成支付；一次买断、永久可用、无订阅，支付后即可获取技能包下载链接与安装说明。
购买后怎么拿到技能？更新要额外付费吗？
支付完成后即可下载完整的技能包 .rar，解压后运行图形化安装器 install.exe 一键安装。后续小版本更新免费，下载新版本覆盖即可，无需再次付费。
什么是 AI 技能（Agent Skill）？
AI 技能是一个目录，内含 SKILL.md 文件，用自然语言把某个领域的做法、规范与避坑经验教给 AI。装进支持技能的 AI 工具后，AI 在该领域会显著更专业、更少出错。
这套技能包含多少个技能、覆盖哪些领域？
共 34 个技能，分为 8 大类：Python 桌面应用开发、Python 问题排查与避坑、Python 打包·授权·日志、Windows 脚本自动化、Adobe 与 PDF 开发、WordPress 开发与发布、Z-BlogPHP 开发与发布、文档 · SEO · 技能导航。
买回来就能直接用吗？有现成的模板和示例吗？
可以。技能包内附带开箱即用的模板：tkinter 桌面工具模板（含通用 tk 模板与 tk 模板 2 号）、PyQt5 现代 UI 模板、Word / Excel 模板填充等，并配套 SKILL.md 中的界面结构、占位符映射、跨 Run 保格式替换等做法与示例，可直接套用到你的项目里，改完业务逻辑即可交付。
适配哪些 AI 工具？
适配 40+ 种支持 Agent Skill 规范的 AI 工具，例如 Qoder、Cursor、Claude Code、Codex、Windsurf、Cline 等。安装器会自动检测本机已安装的工具并写入技能目录，重启工具或新开会话即可使用。
对系统有什么要求？
本技能包仅适配 Windows 系统（Windows 7 及以上 64 位操作系统），一键安装器为 Windows 图形化安装程序（install.exe，双击即用）。若为 Mac 用户，可参照文档中的目录结构手动把技能文件夹复制到所用 AI 工具的 skills 目录。
如何安装和使用？
下载 rar 并解压，运行图形化安装器 install.exe 一键安装，界面自动探测并安装到你已装的 AI 工具，重启工具或新开会话即可使用。升级时下载新版本覆盖即可。
技能会持续更新吗？
会。技能来自真实项目的持续打磨，页面顶部与「更新日志」区都会标注最新版本号，看到新版本直接下载覆盖即可完成升级。
需要联网吗？安装后如何确认已生效？
安装过程无需联网，技能包已完整包含 34 个技能文件。安装完成后重启对应 AI 工具或新开会话，让它读取一个技能主题，能按技能规范作答即表示已生效。
会和 AI 工具里已有的技能冲突吗？
不会。每个技能都是目录名与 name 一致的独立 SKILL.md，安装器仅向技能目录写入，不修改你已有的技能。如有同名技能，按提示覆盖或改名即可。
别再一个人反复踩坑，让 AI 直接专业起来
把 34 个实战技能一次性装进你的 AI 工具，覆盖从 Python 桌面开发、打包授权，到 Adobe、WordPress、脚本自动化与文档 SEO 的完整链路。
立即购买 （一次买断 · 永久可用）更新日志
是否更新，看版本号即可
首个版本，包含 34 个技能，覆盖 Python 桌面应用开发、Python 问题排查与避坑、Python 打包·授权·日志、 Windows 脚本自动化、Adobe 与 PDF 开发、WordPress 开发与发布、Z-BlogPHP 开发与发布、文档·SEO·技能导航八大领域。 仅适配 Windows 系统（Windows 7 及以上 64 位操作系统），提供一键安装器与技能总索引。