关于 printing-press
printing-press 是一项引导 Agent 调研 API、生成 Go CLI、对真实目标测试并归档运行材料的技能,面向需要经过测试的 CLI 和完整开发记录的用户。它依据阶段回执推进流程,而非依赖记忆。
主要功能
- 01API 调研与简报编写
- 02生成 Go CLI
- 03构建与发布检查
- 04针对真实目标进行试用测试
- 05阶段回执跟踪
- 06归档运行材料
适用场景
- 01为 API 创建 CLI
- 02在真实目标上测试生成的命令
- 03记录实现过程与验证证据
- 04为后续润色或发布技能准备 CLI
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mvanhorn/ cli-printing-press --skill printing-press安装后在 Claude Code 中输入/printing-press确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
phases/01-preflight.md02-run-initialization.md03-resolve-and-reuse.md04-research-brief.md05-pre-browser-sniff-auth-intelligence.md06-browser-sniff-gate.md07-crowd-sniff-gate.md08-ecosystem-absorb-gate.md09-api-reachability-gate.md10-generate.md11-build-the-goat.md12-shipcheck.md13-sync-param-drop-gate.md14-agentic-skill-review.md15-readme-skill-agents-correctness-audit.md16-agentic-output-review.md17-local-code-review.md18-dogfood-testing.md19-polish.md20-promote-and-archive.md21-next-steps.mdreferences/absorb-scoring.mdaggregator-pattern.mdauth-companion.mdbrowser-sniff-capture.mdcodex-delegation.mdcrowd-sniff.mddeepwiki-research.mddevice-sniff-ble.mddogfood-testing.md详细介绍
/printing-press
结果: 在 $PRESS_LIBRARY/<api-slug>/ 中生成可运行的 Go CLI,并在 $PRESS_MANUSCRIPTS/<api-slug>/<run-id>/ 中归档最多五份内容详实的手稿:研究简报、吸收清单、构建日志、shipcheck 证明,以及运行了在线测试时的在线冒烟测试证明。
后续使用者: 运行或发布 CLI 的用户,以及接手后续工作的同系列技能:用于第二轮打磨的 printing-press-polish、用于公共库的 printing-press-publish,以及用于总结 Press 本身相关发现的 printing-press-retro。
完成标准: 吸收关卡批准的所有功能均已实现,shipcheck 已达到 ship 状态,已针对真实目标运行在线 dogfood 矩阵,CLI 已晋升,且收据账本在最后阶段结清。
意图: 为 API 打造尽可能实用的 CLI,避免耗费一小时走过场。优先缩短交付时间,而不是文档编写时间:已有研究足够完善时就复用,尽早运行成本低、信号强的检查,并在打磨前修复阻塞问题。
边界
- 绝不泄露秘密。 API 密钥值、令牌值、密码和会话 Cookie 绝不能进入源码、手稿、证明、README、HAR、收据或任何提交的内容。环境变量名称和占位符是安全的。第 5.6 阶段和发布流程遵循 references/secret-protection.md。
- 绝不发布未经测试的内容。
go build和verify通过率是结构性指标,不是正确性指标。未经 phases/18-dogfood-testing.md 中的在线矩阵测试的 CLI 不可发布;只需修改 1-3 个文件就能解决的 bug,必须立即修复,不能留到 v0.2。 - 绝不引用子任务所需的人类时间估算(例如“约 15-30 分钟”“快速修复”)。工作由 Agent 执行,而非用户;应描述工作范围。例外仅限确实受时间约束的事项:整个运行流程(30-60 分钟)、工具安装,以及受网络限制的 printing-press 子命令。
- 绝不凭记忆安排阶段顺序。 接下来要进行哪个阶段由收据账本决定;请参见 references/phase-receipts.md。
授权范围
调用即授权在 $PRESS_RUNSTATE/、$PRESS_LIBRARY/ 和 $PRESS_MANUSCRIPTS/ 下读写,运行 printing-press 二进制文件和 Go 工具链,并通过公开网络研究 API。调用并未授权向公共库发布内容、创建拉取请求,或在用户机器上的其他位置写入内容。
步骤
在任何面向用户的提示词之前,先进入 phases/01-preflight.md, 然后阅读 references/run-resolution.md:它会确定 API 目标、简报上下文,以及组合运行的来源优先级。
绝不要凭记忆执行某个阶段。进入阶段时,先从 phases/ 读取其文件。
phases/10-generate.md 中的代码编排会为 <api>_read 提供读取服务,并预览会更改状态的 <api>_execute 调用,直到 confirm 为布尔值 true。
遵循每个文件末尾的 Next: 指引,并记录每个阶段指定的交接回执。后续流程位于阶段文件中,或位于该阶段加载的、以角色命名的参考文件中
(references/phase-receipts.md、references/codex-delegation.md、
references/fetch-docs.md)。不要在此处复述这些文件的内容。