libersum-cli

libersum-cli 是 LiberSum99 的个人 Agent 工具宝典安装脚手架。

它把内置 Skill 安装到 Codex、Claude Code 或 Pi 的全局 Skill 目录中。

🕸️ 🕷 · AI · 连接 · 探索

内置 Skill

| Skill | 用途 | | --- | --- | | analyze-project-architecture | 基于项目文档和代码，输出简洁的中文架构、技术栈、场景、核心链路和竞品分析。 | | libersum99-social-publishing | 按 LiberSum99 品牌规范排版公众号原文、提炼小红书图文，交付图片与可修改 HTML。 | | prepare-pr-mr | 提交 PR/MR 前检查分支、改动、测试和敏感信息，并排除无关内容。 | | roguelike-game-design | 设计和比较轻量肉鸽游戏的循环、房间、路线、构筑、奖励和成长系统。 |

Skill 源文件已随 CLI 发布包内置，使用者不需要先准备 ~/.codex/skills/。

使用

交互安装：

npx libersum-cli

按向导选择 Skill 和 Agent，多选时使用 Space，使用 Enter 确认。 Skill 默认不选，完成选择后会先显示安装预览，提交确认后才执行安装。

直接安装：

npx libersum-cli skill install \
  --skill analyze-project-architecture \
  --agent codex \
  --yes

可重复传入 --skill 和 --agent 安装多个 Skill 或 Agent：

npx libersum-cli skill install \
  --skill analyze-project-architecture \
  --skill prepare-pr-mr \
  --skill roguelike-game-design \
  --agent codex \
  --agent claude-code \
  --agent pi \
  --yes \
  --format json

默认使用 symlink，也可以使用 --copy；执行前可用 --dry-run 预览安装计划。

支持的全局目录：

• Codex：~/.codex/skills/
• Claude Code：~/.claude/skills/
• Pi：~/.pi/agent/skills/

其他功能

也可以从本地目录或 GitHub 仓库安装外部 Skill：

npx libersum-cli skill install ./my-skills \
  --skill my-skill \
  --agent codex \
  --yes

查看 Agent 和本地安装状态：

npx libersum-cli agent list
npx libersum-cli doctor

本地开发

pnpm install
pnpm dev
pnpm check

个人品牌自媒体排版

新增内置 Skill：libersum99-social-publishing。源码位于 skills/libersum99-social-publishing。 它独立携带品牌规范、头像与 SVG、两个场景模板以及准备和导出脚本；不依赖原 design-system 仓库。

从当前本地构建安装：

pnpm build
node dist/cli.js skill install --skill libersum99-social-publishing --agent codex --yes

也可选择 --agent claude-code 或 --agent pi；实际排版需要对应 Agent 的文件与浏览器能力。 npm 版本 0.1.3 起内置此 Skill，可将上面的 node dist/cli.js 换成 npx libersum-cli@latest。

使用示例：

使用 $libersum99-social-publishing，把这篇 Markdown 排成公众号文章，并提炼成小红书图文。公众号保留原文，直接交付发布材料。

公众号默认保留原文，小红书允许提炼但保留事实与限定。未提供配图时以文字和品牌素材完成设计；默认不搜图、不生成图片、不操作账号发布。

准备脚本使用 Python 3 标准库；导出脚本使用 Node.js、Playwright 与 Chrome，可通过 BROWSER_EXECUTABLE 使用其他 Chromium。 这些是使用排版 Skill 时的依赖，不是 CLI 安装依赖。生成内容不使用 CDN，跨电脑使用系统字体可能导致换行差异，需要重新检查。 公众号本地预览与图片内嵌不代表平台粘贴验证通过。

来源：从 LiberSum99 Personal IP Design System 提取，原系统基于 ESTHER不二（esthersjw）的 esther-design-system。此 Skill 的衍生规范、模板和素材保留 CC BY-NC-SA 4.0 及来源署名。

浏览器导出回归测试（环境已有 Playwright 和 Chrome 时）：

node --test tests/social-render.test.cjs