cli-printing-press

环境要求

• Go 1.26.6 或更高版本
• Claude Code 或其他支持 skills 的智能体（推荐 Claude Code）
• Node/npm（用于 npx 安装技能）
• $GOPATH/bin 需在 PATH 中，否则命令找不到

安装与启动步骤

1. 1一键安装二进制与技能

   脚本会先 go install 生成器二进制，再通过 skills@latest 刷新全部技能，二者需同时安装。

   curl -fsSL https://raw.githubusercontent.com/mvanhorn/cli-printing-press/main/scripts/install.sh | bash

   复制

2. 2重启智能体会话

   安装完成后重启或重新加载 agent 会话，才能加载刷新后的技能文本。

3. 3只装二进制

   只要研究、生成、验证、评分能力时使用，会跳过策展好的 agent 工作流。

   curl -fsSL https://raw.githubusercontent.com/mvanhorn/cli-printing-press/main/scripts/install.sh | bash -s -- --cli-only

   复制

4. 4只装技能

   仅刷新 Printing Press 技能，不重新安装二进制时使用。

   curl -fsSL https://raw.githubusercontent.com/mvanhorn/cli-printing-press/main/scripts/install.sh | bash -s -- --skills-only

   复制

5. 5为 Codex 安装技能

   默认目标是 Claude Code，想装到 Codex 需显式传 --agent codex 参数。

   curl -fsSL https://raw.githubusercontent.com/mvanhorn/cli-printing-press/main/scripts/install.sh | bash -s -- --skills-only --agent codex
   npx -y skills@latest list -g -a codex --json

   复制

6. 6手动安装（可选）

   不想用安装脚本时，分别用 go install 装二进制、用 skills CLI 装技能。

   go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest
   npx -y skills@latest add mvanhorn/cli-printing-press/skills --skill '*' -g -a claude-code -y

   复制

7. 7验证版本

   打印版本号即说明二进制安装成功，可再用 verify 命令对生成的 CLI 做运行期验证。

   cli-printing-press --version
   cli-printing-press verify --dir ./my-pp-cli --spec ./openapi.json --api-key $TOKEN

   复制

8. 8开发者本地加载

   编辑 Printing Press 本项目时，从克隆目录直接加载本地技能，改动下次会话生效。

   git clone https://github.com/mvanhorn/cli-printing-press.git
   cd cli-printing-press
   claude --plugin-dir .

   复制

关键配置

如何确认成功

执行 cli-printing-press --version 能正常输出版本号，即代表二进制安装成功。

常见问题

注意事项

• 默认安装目标为 Claude Code，官方称其测试最充分；Codex 可用 --agent codex 尝试同样工作流。
• 安装脚本内部会执行 go install 与 npx skills，需保证网络可访问对应源。
• 开发者路径还可用 claude --plugin-dir . -w 在新建 git worktree 中并行运行；长期本地配置见 docs/PLUGIN-DEV.md。