用途:把本地 library 中已生成的 CLI 发布到 printing-press-library 仓库,通过 PR 提交;另有一个仅记录被阻塞 API 的日志模式。
主要能力与用法:
- 常规发布:/printing-press publish notion-pp-cli、/printing-press publish notion,可用 --from-polish 承接 polish 交接,用 --skip-live-test=<reason> 跳过发布时实时测试门禁(仅限 auth-unavailable、上游故障、局域网硬件不可达等具体情形)。
- 阻塞日志模式:/printing-press publish notion --blocked-api-journal notion,只更新 blocked-apis.json,需提供 slug、attempted_at、verdict=hold、reason、blocking_issue、permanent 等字段,随后创建分支并开 PR。
- 发布 PR 只允许生成 CLI 的发布或日志 PR,不会用文档、计划、提案类 PR 替代未就绪的 CLI。
限制与约定:
- 必须由用户在新消息中直接发起;若由 polish 的 Publish Offer 链式触发,应停止并让用户重新发送 /printing-press-publish <cli-name> --from-polish。
- 发布 PR 不得修改 registry.json、README 目录单元格或 cli-skills/pp-<api-slug>/SKILL.md,这些由仓库工作流在合并后重新生成;也不得手动更新 CHANGELOG.md、.printing-press-release.json 或运行时版本号。
- 需要 Go 工具链(资料要求 Go 1.26.9 或更新)与 cli-printing-press 二进制,最低二进制版本 4.0.0;安装命令为 go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest。
- 发布配置存于 .publish-config-<scope>.json,包含 repo_url、access、protocol、clone_path、scope_dir、module_path_base 等字段。
- 若生成、校验或实时测试被阻塞,应报告具体阻塞原因并停止。
适用场景:需要把生成的 CLI 贡献到公共库、或记录会重复出现的 API 阻塞时使用。其他细节资料未提供。