Răsfoiți Sursa

docs: add README with git install instructions

kekeZack 1 lună în urmă
părinte
comite
c3d436af7b
1 a modificat fișierele cu 101 adăugiri și 0 ștergeri
  1. 101 0
      README.md

+ 101 - 0
README.md

@@ -0,0 +1,101 @@
+# XzhLoongSkills
+
+Codex AI agent 技能合集,可从 Git 仓库直接安装。
+
+## 安装方式
+
+### 方式一:一键安装单个技能(推荐)
+
+需要先有 `skill-installer` 技能(默认已安装):
+
+```bash
+python ~/.agents/skills/.system/skill-installer/scripts/install-skill-from-github.py \
+  --repo kekezack/XzhLoongSkills \
+  --path <skill-name>
+```
+
+示例 — 安装交接系列技能:
+
+```bash
+python ~/.agents/skills/.system/skill-installer/scripts/install-skill-from-github.py \
+  --repo kekezack/XzhLoongSkills \
+  --path handoff-doc handoff-receive handoff-review
+```
+
+### 方式二:直接复制
+
+```bash
+git clone https://gogs.1808366.xyz/kekezack/XzhLoongSkills.git
+# 将需要的技能目录复制到 ~/.agents/skills/
+cp -r XzhLoongSkills/<skill-name> ~/.agents/skills/
+```
+
+### 方式三:全部安装
+
+```bash
+git clone https://gogs.1808366.xyz/kekezack/XzhLoongSkills.git
+# 或者建立符号链接
+ln -s $(pwd)/XzhLoongSkills/* ~/.agents/skills/
+```
+
+## 技能列表
+
+| 技能 | 说明 |
+|------|------|
+| `handoff-doc` | 生成交接文档 |
+| `handoff-receive` | 接收交接,快速上手 |
+| `handoff-review` | 审查交接质量(5维评分) |
+| `brainstorming` | 创意头脑风暴 |
+| `citation-management` | 学术引用管理 |
+| `code-reviewer` | 代码审查自动化 |
+| `code-simplifier` | 代码简化重构 |
+| `dask` | 分布式计算(大数据) |
+| `dispatching-parallel-agents` | 并行派发子代理 |
+| `docx` | Word 文档生成 |
+| `executing-plans` | 执行实施计划 |
+| `exploratory-data-analysis` | 探索性数据分析 |
+| `finishing-a-development-branch` | 分支完成流程 |
+| `karpathy-guidelines` | LLM 编码行为准则 |
+| `markdown-mermaid-writing` | Markdown + Mermaid 写作 |
+| `markitdown` | 文档转 Markdown |
+| `matplotlib` | 科学绘图 |
+| `obsidian-skills/*` | Obsidian 集成子技能 |
+| `optimize-for-gpu` | GPU 加速(CUDA) |
+| `paper-lookup` | 学术论文检索 |
+| `parallel-web` | 网页搜索/提取/调研 |
+| `pdf` | PDF 操作 |
+| `planning-with-files` | 文件式任务规划 |
+| `polars` | 高性能 DataFrame |
+| `pptx` | PPT 生成 |
+| `pydicom` | 医学影像 DICOM |
+| `pyzotero` | Zotero 文献管理 |
+| `ralph-loop` | 自动化开发循环 |
+| `receiving-code-review` | 接收代码审查反馈 |
+| `requesting-code-review` | 请求代码审查 |
+| `research-lookup` | 科研信息检索 |
+| `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/ 下对应的目录
+```
+
+重启 Codex 后生效。