把本地 ljg-* skills 同步到 GitHub…

当 ~/.agents/skills/ljg-* 下的 skills 有更新，需要一键同步到 ljg-skills 仓库的 master（org-mode）和 md（markdown）两个分支时使用。

适用场景

解决思路

1. 确认硬编码路径：SKILLS_REPO="$HOME/code/ljg-skills"、SKILLS_LOCAL="$HOME/.agents/skills"、REPO_URL="git@github.com:lijigang/ljg-skills.git"；若 $SKILLS_REPO 不存在则自动 clone，若存在但不是 ljg-skills 的 git repo 则报错退出，不破坏现有目录。
2. 按 Workflows/Push.md 的步骤执行，调用 Tools/Push.sh。
3. 先推 master 分支（org-mode 输出风格，.org 扩展，*bold* 加粗，#+title: 文件头），再切到 md 分支（markdown 输出风格，.md 扩展，**bold** 加粗，YAML frontmatter）做基础 markdown 化后推，推完 md 后自动切回 master，让本地 repo 始终停在源分支。
4. push 前强制做 README 一致性硬 gate：列出 ~/.agents/skills/ljg-* 全部 skill 名，grep $SKILLS_REPO/README.md 里出现的 ljg-xxx，找出 local 有但 README 没有的；命中则中止 push 并报告差异。
5. 每次 push 时检视 README：新增 skill 要在 README 的 skill 清单/安装命令加一行；删除 skill 要删对应行；某 skill 描述大改要同步 README 简介。
6. 确认 README 已审、确实不需要更新时，用 /ljg-push --skip-readme-check 绕过 gate。
7. md 分支同步时自动转换 org 文件本体（assets/ 除外）：每个 .org 转成同名 .md 并删除原件——org 头块转 YAML frontmatter（含 --- 围栏，filetags→tags）、* 标题转 # 标题（保留层级）、删除 #+ATTR_* 行、[[file:x]]→、#+begin_src→``` 围栏；同时同步改写 Markdown 与运行时文本文件（.ts/.js/.json/.sh）里对实际被改名文件的引用。
8. 自动转换 Markdown 内嵌的完整 Org 示例：```org 模板以及首行就是 #+key: 的无语言围栏模板转为 ```markdown；连续头块变为带 --- 的 YAML frontmatter，标题、链接、强调、等宽文本与分隔线随模板一起转换；原文件使用纯 CRLF 时保留其换行风格。
9. 自动转换文件扩展引用（__qa.org→__qa.md、__paper.org→__paper.md 等 denote 命名约定）和关键词（org-mode→markdown、Org-mode→Markdown）。
10. 自动转换 org 式格式指令：加粗用 *bold*（单星号）→加粗用 **bold**（双星号）、标题层级从 * 开始→从 # 开始、Org 文件头→Markdown 文件头、行首 #+title: 等 8 个示例键→YAML 键行。
11. 自动转换结构化强调标签：行首 - *标签*：→ - **标签**：；紧邻这类标签的 org 围栏同步#为 markdown。
12. 自动转换输出契约与运行时默认值：evals/*.json 中明确要求保存 Org 的提示与期望改为 Markdown；stdin__*.org 默认值改为 .md，同时保留显式 Org 输入与测试夹具。
13. 自动转换 ljg-is 的生成合同：输出标题、默认文件扩展、路径称谓、元数据名、tags 与双格式验收句统一切到 Markdown/YAML + Denote，并删除 Org 专用 lint 阻断表述；提交前残留审计拒绝任何未转换的 Org 输出指令。
14. 检测与同步共用同一文件边界：按校验和比较内容，可靠识别文件新增、删除、内容和可执行位变化；纯时间戳、目录元数据、空目录不会单独触发发布；任意层级的 .git/、node_modules/、.DS_Store 不进入同步；忽略清单只含这三类明确杂物，.bak、.backup 等真实备份仍会触发同步和发布审查。
15. 正文里的 *bold* 标记不自动转换（markdown 里 *x* 是斜体，盲替会破坏文档自身格式），只有「行首 bullet + 全角冒号」标签会安全转换，其余按需手工处理。
16. 执行 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**...。
17. 用 /ljg-push --dry-run 查看会推什么但不真推：列出会被同步的 skills 和会做的 markdown 化转换，不执行 rsync/commit/push。
18. 脚本会自动 bump patch version 在 plugin.json + marketplace.json；若要 bump minor/major，先手动改完再跑脚本，脚本只追加 patch。
19. 若 md 分支的远端比本地新（另一台机器推过），脚本会 pull --rebase，失败时尝试一次 reset --hard origin/md 重新应用（会丢弃本地未推的 md 分支 commit），脚本前会提示。
20. skill 源固定在 ~/.agents/skills/，工作 repo 固定在 ~/code/ljg-skills/；不要从历史备份目录读取或推送。

适用边界 · 注意事项

• 不要用于推送非 ljg-* 的 skills 或任意 git repo。
• 脚本前提是 git credentials 已配好（ssh key 或 PAT），ljg-push 不处理认证，认证失败时直接报错。
• master 必须先推——md 分支的 markdown 化基于 master 的 org 版本做转换，反过来推会破坏顺序。