refactor(config): migrate .claude/CLAUDE.md to .agents/AGENTS.md with compatibility symlinks
This commit is contained in:
Zhengshou Lai
@@ -0,0 +1,87 @@
|
||||
---
|
||||
name: mytoolkit
|
||||
description: |
|
||||
个人 CLI 工具集 mytoolkit 的入口。涵盖：通用格式转换 (convert)、Markdown→PDF (Typst)、
|
||||
PDF 处理、图片转换、LaTeX 编译、BibTeX 处理、视频转换、Docusaurus 网站构建、邮件管理等。
|
||||
用于：文件格式转换、批量处理、压缩优化、文档生成。
|
||||
详情见 references/ 子目录（convert.md / pdf.md / image.md / latex.md / bib.md / video.md / webpage.md / mail.md / others.md）。
|
||||
user-invocable: true
|
||||
triggers:
|
||||
- mytoolkit
|
||||
- convert
|
||||
- 转换格式
|
||||
- md-to-pdf
|
||||
- markdown转pdf
|
||||
- 转pdf
|
||||
- 压缩pdf
|
||||
- 合并pdf
|
||||
- 图片转pdf
|
||||
- 压缩图片
|
||||
- latex编译
|
||||
- bib转markdown
|
||||
- avi转mp4
|
||||
- 更新mytoolkit
|
||||
---
|
||||
|
||||
# MyToolkit 个人 CLI 工具集
|
||||
|
||||
`mytoolkit` 是日常文件处理、格式转换、批量操作的便捷工具集。所有命令统一在 `mytoolkit` 命名空间下，支持 zsh/bash tab completion。补全脚本由 `mytoolkit completion install` 自动安装到当前 Python prefix，首次运行任意命令时若缺失会自动补齐。
|
||||
|
||||
```bash
|
||||
mytoolkit completion doctor # 检查补全安装状态
|
||||
mytoolkit completion zsh # 打印 zsh 补全脚本
|
||||
```
|
||||
|
||||
## 与其他 Skill 的分工
|
||||
|
||||
| 场景 | 该用哪个 Skill |
|
||||
|------|---------------|
|
||||
| 通用格式转换（MD→PDF、图片→PDF、PDF 压缩等） | **mytoolkit** `convert` |
|
||||
| PDF/图片/视频 细节操作 | **mytoolkit** `pdf` / `image` / `video` |
|
||||
| LaTeX 编译 | **mytoolkit** `latex compile` |
|
||||
| 简历内容更新 + 生成 PDF | **mycv**（`mytoolkit convert cv-zh.md -o cv-zh.pdf -t cv`） |
|
||||
| 课题组网站内容更新 | **mywebpages**（Docusaurus 内容维护） |
|
||||
| 邮件收发 | **mail**（`mytoolkit mail` 命令，由 mail skill 主导） |
|
||||
|
||||
## 子命令导航
|
||||
|
||||
| 子命令 | 场景 | 详情 |
|
||||
|--------|------|----------|
|
||||
| `convert` | 通用格式转换：MD→PDF/Word、图片→PDF、PDF 压缩、EPS→PDF、AVI→MP4、BibTeX→Markdown | `mytoolkit info docs convert` |
|
||||
| `pdf` | PDF 细粒度操作：压缩、裁剪、合并、书签层级调整、PDF→TIFF | `mytoolkit info docs pdf` |
|
||||
| `image` | 图片处理：压缩、EPS 修复、AI 生图 | `references/image.md` |
|
||||
| `latex` | LaTeX 编译、字数统计 | `references/latex.md` |
|
||||
| `bib` | BibTeX→Markdown、CV 引用更新 | `references/bib.md` |
|
||||
| `video` | 视频格式转换 | `references/video.md` |
|
||||
| `webpage` | Docusaurus 网站构建、部署、server 管理 | `mytoolkit info docs webpage` |
|
||||
| `mail` | 邮箱管理（inbox、read、draft） | `references/mail.md` |
|
||||
| `env/git/ssh/server/update/uninstall/completion` | 其他辅助命令 | `references/others.md` |
|
||||
|
||||
> 注：`convert`、`pdf`、`webpage` 的完整参考文档已随 mytoolkit 包安装，通过 `mytoolkit info docs <name>` 直接读取；技能内 `references/` 仅保留速查。
|
||||
|
||||
## 快速决策表
|
||||
|
||||
| 需求 | 推荐命令 |
|
||||
|------|---------|
|
||||
| Markdown 转 PDF | `mytoolkit convert doc.md -o doc.pdf [-t cv/textbook/manual]` |
|
||||
| 压缩 PDF | `mytoolkit convert large.pdf -o small.pdf -q screen` |
|
||||
| 合并 PDF/图片 | `mytoolkit pdf merge *.pdf *.png -o out.pdf` |
|
||||
| EPS 插图转 PDF | `mytoolkit convert fig.eps -o fig.pdf` |
|
||||
| 图片太大需压缩 | `mytoolkit image compress *.jpg -t 2.0` |
|
||||
| 照片合成 PDF | `mytoolkit convert *.jpg -o album.pdf` |
|
||||
| LaTeX 编译 | `mytoolkit latex compile paper.tex` |
|
||||
| BibTeX 转 Markdown | `mytoolkit convert refs.bib -o refs.md` |
|
||||
| AVI 视频转 MP4 | `mytoolkit convert video.avi -o video.mp4` |
|
||||
| 更新工具本身 | `cd mytoolkit && make install` |
|
||||
|
||||
## 安装与更新
|
||||
|
||||
```bash
|
||||
cd ~/workspace/contrib/mytoolkit && make install
|
||||
mytoolkit --version
|
||||
mytoolkit templates list
|
||||
```
|
||||
|
||||
> **重要**：修改 `contrib/mytoolkit` 中的源码、或用 `git pull` / `git submodule update` 拉取更新后，**都必须重新执行 `make install`**（或 `mytoolkit update`）。Python 的 editable 安装不会自动跟踪源码改动，不重装则 CLI 调用的仍是旧版本。验证方式：`mytoolkit --version` 或 `which mytoolkit`。
|
||||
|
||||
> **唯一真源**：mytoolkit 的具体用法、命令参数、模板说明以 **已安装的 mytoolkit 包** 为准（`mytoolkit info paths` 查路径、`mytoolkit info docs <name>` 打印参考文档）。**设计决策与仓库约定**（脚手架取舍、文档生成工作流、命名等）见仓库 `AGENTS.md`。若 `mytoolkit` 命令不可用，可按默认开发路径 `~/workspace/contrib/mytoolkit/` 查找。本 skill 的 `references/` 仅作为 `info docs` 未覆盖命令的速查补充。
|
||||
@@ -0,0 +1,8 @@
|
||||
# BibTeX（bib）
|
||||
|
||||
> 详细用法以 **mytoolkit 项目 README.md** 为准（可用 `mytoolkit info paths` 辅助定位）。
|
||||
|
||||
```bash
|
||||
mytoolkit bib to-markdown refs.bib -o refs.md
|
||||
mytoolkit bib cv-update
|
||||
```
|
||||
@@ -0,0 +1,22 @@
|
||||
> 完整文档：`mytoolkit info docs convert`（不依赖 workspace 路径）。
|
||||
> 本文档仅保留最常用速查。
|
||||
|
||||
```bash
|
||||
# Markdown → PDF
|
||||
mytoolkit convert doc.md -o doc.pdf
|
||||
mytoolkit convert doc.md -o doc.pdf -t cv
|
||||
mytoolkit convert ch1.md ch2.md -o book.pdf -t textbook
|
||||
|
||||
# Markdown → Word
|
||||
mytoolkit convert doc.md -o doc.docx
|
||||
|
||||
# 图片 / EPS → PDF
|
||||
mytoolkit convert fig.eps -o fig.pdf
|
||||
mytoolkit convert *.jpg -o album.pdf
|
||||
|
||||
# PDF 压缩 / PDF → TIFF / AVI → MP4 / BibTeX → Markdown
|
||||
mytoolkit convert large.pdf -o small.pdf -q screen
|
||||
mytoolkit convert scan.pdf -o scan.tiff -d 300
|
||||
mytoolkit convert video.avi -o video.mp4
|
||||
mytoolkit convert refs.bib -o refs.md
|
||||
```
|
||||
@@ -0,0 +1,15 @@
|
||||
# 图片处理（image）
|
||||
|
||||
> 详细用法以 **mytoolkit 项目 README.md** 为准（可用 `mytoolkit info paths` 辅助定位）。
|
||||
|
||||
```bash
|
||||
# 压缩图片（自动调整尺寸/质量）
|
||||
mytoolkit image compress *.png -t 2.0
|
||||
mytoolkit image compress photo.jpg -w 1920 -q 85
|
||||
|
||||
# EPS 修复
|
||||
mytoolkit image eps-fix broken.eps
|
||||
|
||||
# AI 生成图片（豆包/Seedream）
|
||||
mytoolkit image generate "prompt" -o output.png
|
||||
```
|
||||
@@ -0,0 +1,23 @@
|
||||
# LaTeX（latex）
|
||||
|
||||
> 详细用法以 **mytoolkit 项目 README.md** 为准（可用 `mytoolkit info paths` 辅助定位）。
|
||||
|
||||
```bash
|
||||
mytoolkit latex compile paper.tex
|
||||
mytoolkit latex compile paper.tex -e xelatex
|
||||
mytoolkit latex count paper.tex
|
||||
```
|
||||
|
||||
## 论文脚手架 / 投稿模板
|
||||
|
||||
```bash
|
||||
mytoolkit init paper <dir> # 新建论文项目（elsarticle 脚手架，xelatex，可移植；精确配置见生成的 main.tex 头部注释，设计约束见仓库 AGENTS.md §3）
|
||||
mytoolkit init journal # 列出投稿套件
|
||||
mytoolkit init journal elsevier # Elsevier / ieee / springer 套件 → ./submit-<name>/
|
||||
```
|
||||
|
||||
投稿套件自带文档类与 bst，`make`（pdflatex+bibtex）直接编译；自动复用当前目录 `references.bib`。Springer 切样式只改 `\documentclass[...,sn-xxx]{sn-jnl}` 选项，勿写 `\bibliographystyle`。详见 AGENTS.md §3。
|
||||
|
||||
### PDF 命名约定
|
||||
|
||||
脚手架默认输出 `main.pdf`，初始化后应将其重命名为简短、有意义的项目关键词。若目录采用 `lai2026-irregular-drag` 这类 `<作者><年份>-<关键词>` 形式，PDF 命名时应**去掉 `lai2026`/`liu2026` 等作者年份前缀**，只取后面关键词部分（如 `irregular-drag.pdf`）。也可在编译前把 `main.tex` 改为该目标名，让 `make` 直接生成目标 PDF，避免交付/归档时出现多个无区分的 `main.pdf`。
|
||||
@@ -0,0 +1,14 @@
|
||||
# 邮件（mail）
|
||||
|
||||
> 详见 `mail` skill。核心命令如下，完整用法以 **mytoolkit 项目 README.md** 为准（可用 `mytoolkit info paths` 辅助定位）。
|
||||
|
||||
```bash
|
||||
mytoolkit mail inbox --limit 10
|
||||
mytoolkit mail read <UID>
|
||||
mytoolkit mail download <UID> -o ~/Downloads
|
||||
mytoolkit mail draft --to xxx@example.com --subject "..." --body "..."
|
||||
```
|
||||
|
||||
**注意**：
|
||||
- `<UID>` 为真 IMAP UID（`inbox` 列出的就是），跨会话稳定
|
||||
- ⚠️ **绝对禁止发送邮件** —— `draft`/`reply`/`forward` 仅保存到 Drafts，**不会**且**不应**自动发送；即便用户说“发出去”，也只能生成草稿并提示用户去 Web 端点击发送
|
||||
@@ -0,0 +1,14 @@
|
||||
# 其他命令
|
||||
|
||||
> 详细用法以 **mytoolkit 项目 README.md** 为准（可用 `mytoolkit info paths` 辅助定位）。
|
||||
|
||||
```bash
|
||||
mytoolkit init paper <dir> # 初始化 LaTeX 论文项目
|
||||
mytoolkit env # 环境变量管理
|
||||
mytoolkit git # Git 辅助工具
|
||||
mytoolkit ssh # SSH 快捷连接
|
||||
mytoolkit server # 开发服务器管理
|
||||
mytoolkit update # 从本地仓库更新
|
||||
mytoolkit uninstall # 卸载
|
||||
mytoolkit completion # 安装/查看/卸载 shell 补全（install / uninstall / doctor / zsh / bash）
|
||||
```
|
||||
@@ -0,0 +1,15 @@
|
||||
> 完整文档：`mytoolkit info docs pdf`（不依赖 workspace 路径）。
|
||||
> 本文档仅保留最常用速查。
|
||||
|
||||
```bash
|
||||
# 压缩
|
||||
mytoolkit pdf compress paper.pdf -q ebook
|
||||
|
||||
# 裁剪 / 合并 / 调整书签层级
|
||||
mytoolkit pdf crop figure.pdf
|
||||
mytoolkit pdf merge ch*.pdf -o book.pdf
|
||||
mytoolkit pdf bookmark report.pdf --depth 2
|
||||
|
||||
# PDF → TIFF
|
||||
mytoolkit pdf to-tiff scan.pdf -d 300
|
||||
```
|
||||
@@ -0,0 +1,7 @@
|
||||
# 视频（video）
|
||||
|
||||
> 详细用法以 **mytoolkit 项目 README.md** 为准（可用 `mytoolkit info paths` 辅助定位）。
|
||||
|
||||
```bash
|
||||
mytoolkit video avi-to-mp4 recording.avi
|
||||
```
|
||||
@@ -0,0 +1,10 @@
|
||||
> 完整文档：`mytoolkit info docs webpage`（不依赖 workspace 路径）。
|
||||
> 本文档仅保留最常用速查。
|
||||
|
||||
```bash
|
||||
mytoolkit webpage list
|
||||
mytoolkit webpage mywebpage build --serve
|
||||
mytoolkit webpage mywebpage rebuild
|
||||
mytoolkit webpage mywebpage push
|
||||
mytoolkit webpage mywebpage pdf build
|
||||
```
|
||||
Reference in New Issue
Block a user