前言¶
重复性的表格整理、批量改名、格式转换，往往先写成一段 Python，再靠同事自己装环境、记命令行参数。工具能跑，但交接成本高；想给 Agent 复用，又缺少统一的组件形态。下面介绍 SkillHub 上的 自动化工具+Skill开发（坐标 @user_60120345/xiaogong-dev）：它把「需求澄清 → GUI 工具 → PyInstaller 打包 → 文档 → Skill 组件」写成一套可跟做的开发链路，目标是一次需求同时产出双击可用的 exe 和可编程调用的 Skill。
这是什么¶
小工爱开发（Skill 内名 xiaogong-dev）是面向 Python 办公自动化 的 Agent Skill，采用通用 SKILL.md 格式。发布者为社区用户 user_60120345（SkillHub 页面标注作者「紫云墨竹」），版本 1.0.0，分类 office-efficiency，来源 community。SkillHub 元数据标明 requires_api_key=false，无需额外 API Key。
官方页面简介：覆盖从需求分析到双轨交付（exe 工具 + Skill 组件）的完整开发链路，将重复性办公任务转化为 GUI 可执行工具与可编程 Skill 组件。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 references/dev-standard.md。
触发与适用范围¶
在 Agent 中，当用户提出开发 Python 工具、办公自动化脚本、打包 exe、或做 Skill 组件化时，Skill 会引导完整流程。文档中明确的触发场景包括：「做个工具 / 写个脚本」「批量处理 / 自动化某任务」「打包成 exe / Skill」，以及涉及约定工作目录 D:/PY 的开发工作。
开发铁律与目录约定¶
Skill 要求成果按固定目录归档（默认工作根目录为 D:/PY）：
| 约定 | 说明 |
|---|---|
| 源码 | source_code/ |
| exe | exe_tools/ 或 app发布区/（带版本与日期） |
| 文档 | docs/ |
| Skill 组件 | skill_center/skills/、skill_center/config/，调度入口 skill_runner.py |
其他硬性规则：工具须带 tkinter GUI（禁止纯命令行交付）；每个需求 双轨交付（exe + Skill）；源码与界面需统一标注作者信息（Skill 内格式为「电信数智-集成服务部-产数交付支撑中心」）；exe 需做到用户双击即可运行、无需自行配环境。
六步开发流程¶
- 需求确认：厘清输入数据、处理逻辑、输出形式与约束。
- 模板起步：从 Skill 附带的
assets/gui_tool_template.py复制到D:/PY/source_code/<工具名>.py，模板含窗口居中、输入区、按钮、进度条、日志区等。 - 编码规范：文件头 docstring、窗口标题与状态栏署名、日志与异常处理、UTF-8 编码等。
- 打包 exe：使用 PyInstaller 单文件、无控制台窗口模式，产出物移入
exe_tools/。 - 编写文档：在
docs/写<工具名>_说明.md。 - Skill 组件化：在
skill_center下实现run(**kwargs) -> {status, msg, data}，并配套 JSON 配置。
程序侧调用 Skill 组件¶
规范文档给出的调用示例：
from skill_center.skill_runner import run_skill
result = run_skill("skill_xxx", param1="值1", param2="值2")
print(result) # {status: "success", msg: "...", data: {...}}
交付前 Skill 还提供检查清单（署名、GUI、exe、文档、Skill、异常处理与至少一次完整跑通等）。
安装与启用¶
SkillHub 页面建议：先阅读 SkillHub 安装说明，再安装本 Skill。
1. 检查或安装 skillhub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用官方一键脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前环境识别的 skills 目录，否则默认落在 ./skills/ 可能无法被 Agent 加载。
skillhub install @user_60120345/xiaogong-dev --dir <你的 skills 目录>
常用路径（来自 SkillHub 官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将安装说明直接发给 AI：「请根据 https://skillhub.cn/install/skillhub.md，安装 @user_60120345/xiaogong-dev。」安装后按所用客户端要求重启或刷新 Skill 列表。
典型用法¶
下面示例均可在启用 Skill 后，用自然语言驱动 Agent 按规范落地；打包命令来自 Skill 正文。
从 GUI 模板开发并打包 exe¶
Agent 复制模板并开始编码后，在 Windows 环境可按 Skill 给出的 PyInstaller 命令打包：
pip install pyinstaller
pyinstaller -F -w --name "<工具名>" D:/PY/source_code/<工具名>.py
-F 为单文件，-w 为无控制台窗口；生成的 exe 从 dist/ 移至 D:/PY/exe_tools/。
双轨交付示例话术¶
向 Agent 描述任务时，可同时声明交付物，例如：
「用 Python 做一个带界面的批量重命名工具，按小工开发规范放到 D:/PY，最后打包 exe 并在 skill_center 里做一个可 run_skill 调用的组件。」
Agent 应依次完成需求确认、基于 gui_tool_template.py 编码、文档与 Skill 配置，并在回复末尾附带 Skill 要求的开发者署名说明。
适用场景与注意¶
适合谁：需要在 Windows 办公场景反复交付小工具的团队；希望 Agent 按同一套目录、GUI、打包与组件规范产出，而不是每次临时写脚本的人。
限制与注意：
- 目录与路径示例以
D:/PY为主，面向 Windows；在 Linux/macOS 上需自行映射等价工作区，Skill 未提供跨平台路径替换表。 - 打包示例为 PowerShell 与 PyInstaller；目标环境需已安装 Python 及依赖。
- Skill 强制 GUI 与作者标注规则，若你方组织有不同规范，需在对话中显式覆盖或改写。
- SkillHub 抓取元数据（2026-10-23）：评分 100000，下载约 797 次；页面统计可能随时间变化，以 SkillHub 实时页面为准。
结尾¶
自动化工具+Skill开发 把办公自动化从「单次脚本」拉成「exe + Skill + 文档」的可复用交付链，适合交给 Agent 做全流程脚手架。安装与详情见 SkillHub：
- 技能页：https://www.skillhub.cn/skills/user_60120345/xiaogong-dev
- API 坐标页：https://api.skillhub.cn/user_60120345/xiaogong-dev
