# XzhLoongSkills

Codex / OpenCode AI agent 技能合集，通过 clone + 复制 按需安装。

## 安装

```bash
# 1. 克隆到本地
git clone https://gogs.1808366.xyz/kekezack/XzhLoongSkills.git
cd XzhLoongSkills

# 2. 复制技能到项目目录
cp -r skills/<category>/<skill-name> /project/path/.agents/skills/
```

> 全局安装：`cp -r skills/* ~/.agents/skills/`
> 技能已按类别分入 `essential/`, `code-dev/`, `data-science/`, `academic/`, `office/`, `obsidian/`。
> 项目级安装：将下方命令中的 `/project/path/.agents/skills/` 替换为实际路径。

## 技能分类

### 通用必装

核心工作流技能，无论什么项目类型都推荐安装。

```bash
cp -r skills/essential/{brainstorming,planning-with-files,writing-plans,executing-plans,finishing-a-development-branch,dispatching-parallel-agents,subagent-driven-development,systematic-debugging,karpathy-guidelines,verification-before-completion,handoff-doc,handoff-receive,handoff-review,using-superpowers,writing-skills} ~/.agents/skills/
```

| 技能                               | 说明                                   |
| ---------------------------------- | -------------------------------------- |
| `brainstorming`                  | 创意头脑风暴 — 所有实现工作前必须使用 |
| `planning-with-files`            | 文件式任务规划（Manus 风格）           |
| `writing-plans`                  | 编写实施计划                           |
| `executing-plans`                | 执行实施计划                           |
| `finishing-a-development-branch` | 分支完成流程（合并/PR/清理）           |
| `dispatching-parallel-agents`    | 并行派发独立子任务                     |
| `subagent-driven-development`    | 子代理驱动开发                         |
| `systematic-debugging`           | 系统化调试流程                         |
| `karpathy-guidelines`            | LLM 编码行为准则                       |
| `verification-before-completion` | 完成前验证 — 必须先验证再声称完成     |
| `handoff-doc`                    | 生成交接文档                           |
| `handoff-receive`                | 接收交接，快速上手                     |
| `handoff-review`                 | 审查交接质量                           |
| `using-superpowers`              | 技能使用总入口                         |
| `writing-skills`                 | 编写/调试新技能                        |

### 代码开发

代码审查、重构、TDD、测试自动化、Git 工作流。

```bash
cp -r skills/code-dev/{code-reviewer,code-simplifier,requesting-code-review,receiving-code-review,test-driven-development,ralph-loop,using-git-worktrees,ui-ux-pro-max,ponytail,ponytail-audit,ponytail-debt,ponytail-gain,ponytail-help,ponytail-review} /project/path/.agents/skills/
```

| 技能                        | 说明                                           |
| --------------------------- | ---------------------------------------------- |
| `code-reviewer`           | 代码审查自动化（TS/JS/Python/Go/Swift/Kotlin） |
| `code-simplifier`         | 代码简化重构                                   |
| `requesting-code-review`  | 请求代码审查                                   |
| `receiving-code-review`   | 接收代码审查反馈                               |
| `test-driven-development` | 测试驱动开发                                   |
| `ralph-loop`              | 自动化开发循环                                 |
| `using-git-worktrees`     | Git Worktree 隔离开发                          |
| `ui-ux-pro-max`           | UI/UX 设计规范数据库                           |
| `ponytail`              | 极简主义开发（YAGNI/最懒方案/标准库优先）     |
| `ponytail-review`       | 过度工程代码审查（找可删除的复杂度）          |
| `ponytail-audit`        | 全仓库过度工程审计                            |
| `ponytail-debt`         | ponytail 快捷方式债务追踪                     |
| `ponytail-gain`         | Ponytail 基准测试效果看板                     |
| `ponytail-help`         | Ponytail 命令速查卡                           |

### 数据科学与机器学习

数据分析、可视化、ML/DL 建模、GPU 加速。

```bash
cp -r skills/data-science/{scikit-learn,transformers,exploratory-data-analysis,statistical-analysis,matplotlib,seaborn,polars,dask,vaex,optimize-for-gpu,pydicom} /project/path/.agents/skills/
```

| 技能                          | 说明                                     |
| ----------------------------- | ---------------------------------------- |
| `scikit-learn`              | 机器学习（分类/回归/聚类/调参）          |
| `transformers`              | 预训练 Transformer 模型（NLP/CV/多模态） |
| `exploratory-data-analysis` | 探索性数据分析（200+ 科学文件格式）      |
| `statistical-analysis`      | 统计检验选择与 AP 格式报告               |
| `matplotlib`                | 科学绘图（精细控制）                     |
| `seaborn`                   | 统计可视化（pandas 集成）                |
| `polars`                    | 高性能 DataFrame（内存级，pandas 替代）  |
| `dask`                      | 分布式计算（超内存数据）                 |
| `vaex`                      | 超大表格数据分析（百亿行）               |
| `optimize-for-gpu`          | GPU 加速（CuPy/Numba CUDA/cuDF/cuML 等） |
| `pydicom`                   | 医学影像 DICOM 处理                      |

### 学术研究

论文检索、引用管理、科研写作、文献调研。

```bash
cp -r skills/academic/{paper-lookup,citation-management,research-lookup,scientific-writing,pyzotero,parallel-web} /project/path/.agents/skills/
cp -r skills/academic/research-skills /project/path/.agents/skills/research-skills
```

| 技能                      | 说明                                           |
| ------------------------- | ---------------------------------------------- |
| `paper-lookup`          | 学术论文检索（PubMed/arXiv/Crossref 等 10 库） |
| `citation-management`   | 学术引用管理（Google Scholar/BibTeX）          |
| `research-lookup`       | 科研信息检索（自动路由最佳后端）               |
| `parallel-web`          | 网页搜索/提取/深度调研                         |
| `scientific-writing`    | 科学论文写作（IMRAD 结构）                     |
| `pyzotero`              | Zotero 文献库 API 操作                         |
| **research-skills** | ⬇ 学术研究子合集（详见下文）                  |

`research-skills/` 包含：

| 技能                       | 说明                                                                       |
| -------------------------- | -------------------------------------------------------------------------- |
| `medical-imaging-review` | 医学影像 AI 文献综述（7 阶段流程）                                         |
| `paper-slide-deck`       | 论文→PPT 自动生成（含图表提取）                                           |
| `research-proposal`      | 博士研究计划书（Nature Reviews 风格）                                      |
| 多智能体调研系统           | 5 个中文角色（研究主管/文献侦查员/论文分析师/撰写员/编辑）协同撰写综述论文 |

### 文档办公

Office 文档、PDF、幻灯片、Markdown 写作。

```bash
cp -r skills/office/{docx,pdf,pptx,xlsx,markdown-mermaid-writing,markitdown,humanizer-zh} /project/path/.agents/skills/
```

| 技能                         | 说明                                               |
| ---------------------------- | -------------------------------------------------- |
| `docx`                     | Word 文档生成（目录/页眉/模板）                    |
| `pdf`                      | PDF 操作（合并/拆分/OCR/水印）                     |
| `pptx`                     | PPT 生成与编辑                                     |
| `xlsx`                     | Excel 文件处理（公式/图表/清洗）                   |
| `markdown-mermaid-writing` | Markdown + Mermaid 写作（24 种图表/9 种文档模板）  |
| `markitdown`               | 文档转 Markdown（PDF/DOCX/PPTX/图片 OCR/音频转录） |
| `humanizer-zh`           | 中文文本去 AI 味（润色/改写/审阅长文本）          |

### Obsidian & 知识管理

Obsidian 集成子技能 + LLM Wiki 知识库。

```bash
cp -r skills/obsidian/obsidian-skills /project/path/.agents/skills/obsidian-skills
cp -r skills/obsidian/xzh-obsidian-llm-wiki /project/path/.agents/skills/
```

| 技能                      | 说明                                              |
| ------------------------- | ------------------------------------------------- |
| `obsidian-cli`          | Obsidian CLI 操作（笔记/搜索/插件开发）           |
| `obsidian-markdown`     | Obsidian 风格 Markdown（wikilinks/callouts/属性） |
| `obsidian-bases`        | Obsidian Bases（.base 数据库视图）                |
| `json-canvas`           | JSON Canvas（.canvas 可视化画布）                 |
| `defuddle`              | 网页→Markdown 提取（去除导航/广告）              |
| `xzh-obsidian-llm-wiki` | LLM Wiki 知识库（构建/查询/审计/教学）            |

---

## 全部技能（按字母序）

| 技能                               | 说明                                      |
| ---------------------------------- | ----------------------------------------- |
| `brainstorming`                  | 创意头脑风暴                              |
| `citation-management`            | 学术引用管理                              |
| `code-reviewer`                  | 代码审查自动化                            |
| `code-simplifier`                | 代码简化重构                              |
| `dask`                           | 分布式计算（大数据）                      |
| `dispatching-parallel-agents`    | 并行派发子代理                            |
| `docx`                           | Word 文档生成                             |
| `executing-plans`                | 执行实施计划                              |
| `exploratory-data-analysis`      | 探索性数据分析                            |
| `finishing-a-development-branch` | 分支完成流程                              |
| `handoff-doc`                    | 生成交接文档                              |
| `handoff-receive`                | 接收交接，快速上手                        |
| `handoff-review`                 | 审查交接质量                              |
| `humanizer-zh`                   | 中文文本去 AI 味（润色/改写/审阅长文本）  |
| `karpathy-guidelines`            | LLM 编码行为准则                          |
| `markdown-mermaid-writing`       | Markdown + Mermaid 写作                   |
| `markitdown`                     | 文档转 Markdown                           |
| `matplotlib`                     | 科学绘图                                  |
| `obsidian-skills/*`              | Obsidian 集成子技能（5 个）               |
| `optimize-for-gpu`               | GPU 加速（CUDA）                          |
| `paper-lookup`                   | 学术论文检索（10 库）                     |
| `parallel-web`                   | 网页搜索/提取/调研                        |
| `pdf`                            | PDF 操作                                  |
| `planning-with-files`            | 文件式任务规划                            |
| `polars`                         | 高性能 DataFrame                          |
| `ponytail`                     | 极简主义开发（YAGNI/最懒方案）            |
| `ponytail-audit`               | 全仓库过度工程审计                        |
| `ponytail-debt`                | ponytail 快捷方式债务追踪                 |
| `ponytail-gain`                | Ponytail 基准测试效果看板                 |
| `ponytail-help`                | Ponytail 命令速查卡                       |
| `ponytail-review`              | 过度工程代码审查                          |
| `pptx`                           | PPT 生成                                  |
| `pydicom`                        | 医学影像 DICOM                            |
| `pyzotero`                       | Zotero 文献管理                           |
| `ralph-loop`                     | 自动化开发循环                            |
| `receiving-code-review`          | 接收代码审查反馈                          |
| `requesting-code-review`         | 请求代码审查                              |
| `research-lookup`                | 科研信息检索                              |
| `research-skills/*`              | 学术研究子合集（3 单智能体 + 5 多智能体） |
| `scientific-writing`             | 科学论文写作                              |
| `scikit-learn`                   | 机器学习                                  |
| `seaborn`                        | 统计可视化                                |
| `statistical-analysis`           | 统计分析                                  |
| `subagent-driven-development`    | 子代理驱动开发                            |
| `systematic-debugging`           | 系统化调试                                |
| `test-driven-development`        | 测试驱动开发                              |
| `transformers`                   | 预训练 Transformer 模型                   |
| `ui-ux-pro-max`                  | UI/UX 设计规范数据库                      |
| `using-git-worktrees`            | Git Worktree 隔离开发                     |
| `using-superpowers`              | 技能使用指南                              |
| `vaex`                           | 超大数据集分析                            |
| `verification-before-completion` | 完成前验证                                |
| `writing-plans`                  | 编写实施计划                              |
| `writing-skills`                 | 编写/调试技能                             |
| `xlsx`                           | Excel 文件处理                            |
| `xzh-obsidian-llm-wiki`          | Obsidian LLM Wiki 知识库                  |

## 更新技能

```bash
cd XzhLoongSkills && git pull
# 重新复制 ~/.agents/skills/ 下对应目录（覆盖即可）
```
