lijigang/ljg-push
skills/ljg-push/SKILL.md
把 ~/.claude/skills/ljg-* 里所有更新过的 skills 同步到 github repo (ljg-skills)，先推 master 分支（org-mode 输出风格），再切 md 分支（markdown 输出风格）做基础 markdown 化后推。Use when user says '/ljg-push', 'push skills', '推送 skills', '同步 skills', 'sync ljg', or whenever ljg-* skills get updated and need shipping. NOT FOR pushing non-ljg skills or arbitrary git repos.
$ install --global
skillsauthnpx skillsauth add lijigang/ljg-skills ljg-pushInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 19, 2026, 7:39 AM126.8s3 files scanned
SKILL.md
- name:
- ljg-push
- description:
- 把 ~/.claude/skills/ljg-* 里所有更新过的 skills 同步到 github repo (ljg-skills)，先推 master 分支（org-mode 输出风格），再切 md 分支（markdown 输出风格）做基础 markdown 化后推。Use when user says '/ljg-push', 'push skills', '推送 skills', '同步 skills', 'sync ljg', or whenever ljg-* skills get updated and need shipping. NOT FOR pushing non-ljg skills or arbitrary git repos.
- user_invocable:
- true
ljg-push: 推送 ljg-* skills
把本地 ~/.claude/skills/ljg-* 里改过的 skills，一键同步到 github repo，覆盖 master 和 md 两个分支。
仓库路径（硬编码）
SKILLS_REPO="$HOME/code/ljg-skills" # 本地工作 repo
SKILLS_LOCAL="$HOME/.claude/skills" # 本地 skill 源
REPO_URL="[email protected]:lijigang/ljg-skills.git"
如果 $SKILLS_REPO 不存在，脚本会自动 clone。如果它存在但不是 ljg-skills 的 git repo，脚本会报错退出（不破坏现有目录）。
两条分支的差异
| 分支 | 输出格式 | 文件扩展 | 加粗 | 文件头 |
|------|---------|---------|------|--------|
| master（默认） | org-mode | .org | *bold* | #+title: 等 |
| md | markdown | .md | **bold** | YAML frontmatter |
~/.claude/skills/ 里的 skill 是 master 风格（源版本）。md 分支的差异由脚本自动转换 + 必要时手工补。
工作流
按 Workflows/Push.md 步骤执行 → 调用 Tools/Push.sh。
README 一致性（硬 gate）
每次 push 前，脚本强制做一件事：把 README 跟 local skills 对一遍。
- 列出
~/.claude/skills/ljg-*全部 skill 名 - grep
$SKILLS_REPO/README.md里出现的ljg-xxx - 找出 local 有但 README 没有的——几乎肯定意味着 README 漏更新
- 命中 → push 中止，报告差异
每次 push 都是检视 README 的机会。问自己：
- 新增 skill 了吗？README 的 skill 清单 / 安装命令需要加一行
- 删了 skill 吗？README 对应行要删
- 某个 skill 的描述大改了吗？README 的简介可能要同步
确认 README 已审、确实不需要更新时，绕过 gate：
/ljg-push --skip-readme-check
自动转换的范围
md 分支同步时自动替换的字符串：
- 文件扩展引用：
__qa.org→__qa.md、__paper.org→__paper.md等（denote 命名约定） - 模板引用：
template.org→template.md - 关键词：
org-mode→markdown、Org-mode→Markdown
不会自动转换 的内容（脚本不动，需要手工维护）：
*bold*→**bold**：在 markdown 文件里*bold*是斜体，自动替换会破坏文档自身格式- org 头
#+title:#+date:→ YAML frontmatter：太复杂，留人工 - 文件本体重命名：如
references/template.org文件 →references/template.md
碰到这些差异，脚本推完 md 分支后会列出 仍有差异 的文件清单，给一个 review checklist。
Voice Notification
curl -s -X POST http://localhost:31337/notify \
-H "Content-Type: application/json" \
-d '{"message": "Running Push in ljg-push"}' \
> /dev/null 2>&1 &
输出文本：Running **Push** in **ljg-push**...
Examples
Example 1: 一键推送
User: /ljg-push
→ 检测 ~/.claude/skills/ljg-* 中跟 repo 有差异的 skills
→ master: rsync + bump version + commit + push
→ md: rsync + mdize + bump version + commit + push
→ 报告：哪些 skills 推了，新版本号，剩余手工差异
Example 2: 看会推什么但不真推
User: /ljg-push --dry-run
→ 列出会被同步的 skills
→ 列出会做的 markdown 化转换
→ 不执行 rsync / commit / push
Gotchas
- README 漂移是最容易被忽略的——加完新 skill 直接推，README 还停在老清单。脚本现在有硬 gate 拦这一刀；拦下来时不要无脑加
--skip-readme-check，先去看一下 README - 脚本前提是 git credentials 已配好（ssh key 或 PAT）—— ljg-push 不处理认证，认证失败时直接报错
- master 必须先推——md 分支的 markdown 化基于 master 的 org 版本做转换。反过来推会破坏顺序
- untracked 杂物（如
assets/measure.js）会被 rsync 同步到 repo——如果不想推，先在本地删掉，或加进.gitignore - 自动 markdown 化只动字符串——
*bold*和 org 头不动。md 分支的复杂差异（如 ljg-paper 的template.org→template.md）需要继刚手工维护 - 脚本会自动 bump patch version 在 plugin.json + marketplace.json——如果你想 bump minor / major，先手动改完再跑脚本，脚本只追加 patch
- 如果 md 分支的远端比本地新（继刚另一台机器推过），脚本会
pull --rebase失败时尝试一次reset --hard origin/md重新应用——这会丢弃本地未推的 md 分支 commit。脚本前会提示 - 搬迁记录：repo 历史曾在
~/.claude.backup-20260502/ljg-skills-repo/（路径名带 backup 是历史遗留），2026-05-02 搬到~/code/ljg-skills/
Related Skills
lijigang/ljg-book
research
VerifiedTrustedCommunity
拆一本书。冷静简洁犀利直白，五件事说清：作者在答什么问题，立在什么不证之物上，用什么框架看，得出什么结论，最后萃出一个 takeaway（取景框/模型/洞见/概念/金句五选一）作为这本书的精神内核。最后把作者的取景框（这本书的参考系）画成一张地图——提炼参考系、把观点钉到位置上、走两步做预测，让你不光看懂，还能自己拿它预测书外的新事。Use when user says '拆书', '拆这本', '分析这本书', '这本书在讲什么', '上帝之眼看这本书', '压缩一本书', 'book', or shares a book name wanting structural analysis. NOT FOR 章节摘要（用 Fabric extract_wisdom）、论文（用 ljg-paper）、单一观点深钻（用 ljg-think）、一个领域降秩（用 ljg-rank）.
5,459SKILL.mdUpdated May 19, 2026
lijigang/ljg-rank
testing
VerifiedTrustedCommunity
给一个领域，找出背后真正撑着它的几根独立的力。十几个现象砍到不可再少的生成器——砍完能把现象一个个生回来，才算数。Use when user says '降秩', '找秩', '秩是什么', '这个领域靠什么撑着', '背后是什么', or wants to decompose any domain to its irreducible generators.
5,459SKILL.mdUpdated Apr 18, 2026
lijigang/ljg-paper
content-media
VerifiedTrustedCommunity
Paper reader for non-academics. Reads a paper and tells it back as one continuous story to someone who doesn't know the field — built on a seven-beat spine (主角 / 困境 / 旧路 / 转折 / 解法 / 结局 / 内核). The job is storytelling that makes the paper land, not academic critique. Use when user shares an arxiv link, paper URL, PDF, or asks to analyze a research paper. Trigger words: '读论文', '讲论文', '把这篇讲给我听', '分析论文', 'paper', or when user shares an academic paper.
5,230SKILL.mdUpdated Apr 18, 2026
lijigang/ljg-qa
testing
VerifiedTrustedCommunity
信息提问机。给一篇文章/论文/书，把核心观点抽成 Q-A 对——Question 切要害，不教科书；Answer 简洁清晰，有形式化收口，逻辑链完整。读者顺 Q 链走过，每个 A 砸下一枚钉子，复现作者整套推理。Use when user says '问答', 'Q&A', 'QA', '提问', '抽取问题', '/ljg-qa', or shares an article/paper/book and asks for Q-A extraction. Triggers when the user wants ideas extracted not as a summary but as a sequence of incisive questions with answered. NOT FOR FAQ generation, glossary creation, or comprehension quizzes — this is intellectual scaffolding, not study aids.
3,998SKILL.mdUpdated May 8, 2026