# workbuddy-skills **Repository Path**: superLake/workbuddy-skills ## Basic Information - **Project Name**: workbuddy-skills - **Description**: workbuddy自用常用技能 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-09-08 - **Last Updated**: 2026-09-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # workbuddy-skills WorkBuddy **用户级自定义技能(Skill)集合**,采用「单仓库多子目录(monorepo)」结构,用于跨设备(公司 / 家里)同步与版本备份。 > 远程仓库:`https://gitee.com/superLake/workbuddy-skills.git`(私有仓,仅个人多端同步用) --- ## 一、目录结构 ``` workbuddy-skills/ ├── README.md # 本说明 ├── sync.sh # 把仓库里的 skill 同步(软链/复制)到 WorkBuddy 的 skills 目录 ├── batch-office-edit/ # 一个 skill = 一个独立子目录 │ ├── SKILL.md # 技能定义(必需,WorkBuddy 据此发现并加载技能) │ └── batch_edit.py # 该技能附带的可复用脚本(可选) ├── competitor-launch-brief/ # 竞品 / 发布会总结(营销向,含 AGENT.md 口径与 PDF 输出) │ ├── SKILL.md │ ├── templates/ # 提问清单 / 事实底稿 schema / 十章大纲 / 一页纸模板 │ └── references/ # 信源分级、事实陷阱等写作约束 ├── md-to-pdf-cjk/ # Markdown → 中文 PDF(ReportLab,含避头尾补丁、wordWrap=CJK) │ ├── SKILL.md │ └── scripts/ │ ├── md2pdf.py # 主转换脚本 │ └── ensure_env.py # 幂等准备 Python 运行环境(镜像回退) └── dsh-preset-doctor/ # 排查 dsh 自定义 agent preset 挂载失败 ├── SKILL.md └── check-preset.mjs # 逐行校验 preset 配置是否符合各插件 schema ``` **规则:每个 skill 必须是独立子目录,且目录下必须有 `SKILL.md`**,WorkBuddy 才会识别它。 --- ### 已收录技能清单 | 子目录 | 用途 | 触发场景 | | --- | --- | --- | | `batch-office-edit` | 单进程批量编辑本地 Office(docx/xlsx/pptx) | 一篇文档 3 处以上修改时 | | `competitor-launch-brief` | 友商产品 / 发布会总结,产出决策可用报告 + 一页纸 + 事实底稿 + PDF | marketing 做竞品 / 发布会梳理 | | `md-to-pdf-cjk` | 把 Markdown 渲染为排版正确的中文 PDF | 任何需要把 md 导出为 PDF 的场景 | | `html-katex-to-pdf-cjk` | 含数学公式的 HTML / 外文译文 → 中文 PDF(KaTeX 预渲染) | 公式密集的论文、技术文档转 PDF | | `dsh-preset-doctor` | 排查 dsh 自定义 agent preset 挂载失败(SessionCreateError / failed to mount) | dsh 报错开不了新会话、升级后 preset 失效、需临时停用某 preset | | `php-learn-new-case` | 给本地 PHP 高并发学习项目新增一个「案例 N」 | 说「加多一个案例」时 | | `sensitive-corpus-clean` | 敏感词库 / 语料的**零曝光清洗**与脱敏自检(不读原文完成整理) | 整理审核词表、黑名单、舆情语料;要体检报告但不便暴露内容 | | `tech-course-authoring` | **课程式技术教学文档**:固定五步骨架(朴素实现→真跑→撞墙→引技术→再测),每段代码可跑、每个数字实测、配断言验证脚本 | 说「把我当大学生讲」「列一个教学文档」「从简单到复杂迭代到企业级」时 | --- ## 二、WorkBuddy 是怎么「拿到」这些 skill 的 1. **扫描位置**:WorkBuddy 启动时扫描 `~/.workbuddy/skills/` 目录,找出所有含 `SKILL.md` 的子目录,登记为「用户级技能」,出现在对话的可用技能列表里。 2. **加载时机**:技能不常驻内存,只有当对话命中技能描述(`SKILL.md` 顶部 `description`)或被显式调用时,才把正文注入上下文。 3. **生效条件**:新增 / 修改 skill 后,**重启 WorkBuddy(或重开会话)**才生效——扫描发生在启动时。 > 所以本仓库与 `~/.workbuddy/skills/` 之间需要一个「同步」动作:把仓库里的 skill 目录放进 `~/.workbuddy/skills/`(软链或复制均可)。`sync.sh` 就是干这个的。 --- ## 三、首次同步到本机(每台机器执行一次) ```bash # 1) 克隆仓库(任意位置,下面以 ~/.workbuddy/workbuddy-skills 为例) git clone https://gitee.com/superLake/workbuddy-skills.git ~/.workbuddy/workbuddy-skills cd ~/.workbuddy/workbuddy-skills # 2) 把仓库里每个含 SKILL.md 的子目录,软链到 WorkBuddy 的 skills 目录 ./sync.sh # 3) 重启 WorkBuddy,技能即出现在可用列表 ``` `sync.sh` 默认用**软链(symbolic link)**:仓库是单一事实来源,你在仓库里改 `SKILL.md` 会立即反映到 `~/.workbuddy/skills/`,无副本漂移。 若担心软链不被识别,改用真实文件副本模式:`./sync.sh --copy`(内部用 rsync)。 --- ## 四、日常使用流程 ``` 在仓库里新增 / 修改某个 skill 的 SKILL.md │ ▼ ./sync.sh # 重新软链(新增 skill 时需要这步) │ ▼ git add -A && git commit -m "feat: 新增/调整 xxx skill" && git push # 推到 Gitee │ ▼ # 在另一台机器上: cd ~/.workbuddy/workbuddy-skills && git pull && ./sync.sh # 拉取并同步 ``` --- ## 五、新增一个 skill 的标准动作 1. 在仓库根目录新建子目录:`mkdir my-new-skill` 2. 写 `my-new-skill/SKILL.md`,至少包含 frontmatter: ```markdown --- name: my-new-skill description: 一句话说明这个技能在什么场景下被触发(WorkBuddy 靠它判断是否加载) --- # 技能正文:给 AI 的执行步骤、工具、约束、示例 ... ``` 3. 运行 `./sync.sh` → 重启 WorkBuddy → 在对话里用相关指令验证是否被触发。 --- ## 六、SKILL.md 编写要点 - `name`:与目录名一致,小写中划线。 - `description`:**必需且关键**,写清触发场景;WorkBuddy 靠语义匹配决定何时加载本技能。 - 正文:给 AI 的具体步骤、可用工具名、铁律(必做 / 禁止)、输入输出示例。 - 可附带脚本 / 模板文件,正文中写明路径与调用方式(参考 `batch-office-edit`)。 --- ## 七、注意事项 - 本仓库只管理**你自建的用户级 skill**;从技能市场安装的 skill 由 WorkBuddy 账户体系管理,不在此列。 - **项目级 skill** 放在 `<项目>/.workbuddy/skills/`,不在本仓库范围,按需另建仓库管理。 - 推送 Gitee 建议用**私人令牌(PAT)**作为 HTTPS 密码,或在 Gitee 配置 SSH 公钥,避免每次输账号密码。 - 需要对外分享某个 skill 时,单独抽取该子目录发布,不要整仓公开。