mcpField
P
printing-press

printing-press

github.com/mvanhorn开发4.9k7.6k 次安装今天更新
代码仓库

关于 printing-press

printing-press 是一项引导 Agent 调研 API、生成 Go CLI、对真实目标测试并归档运行材料的技能,面向需要经过测试的 CLI 和完整开发记录的用户。它依据阶段回执推进流程,而非依赖记忆。

主要功能

  1. 01API 调研与简报编写
  2. 02生成 Go CLI
  3. 03构建与发布检查
  4. 04针对真实目标进行试用测试
  5. 05阶段回执跟踪
  6. 06归档运行材料

适用场景

  1. 01为 API 创建 CLI
  2. 02在真实目标上测试生成的命令
  3. 03记录实现过程与验证证据
  4. 04为后续润色或发布技能准备 CLI

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mvanhorn/cli-printing-press --skill printing-press

安装后在 Claude Code 中输入/printing-press确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

phases/
01-preflight.md
02-run-initialization.md
03-resolve-and-reuse.md
04-research-brief.md
05-pre-browser-sniff-auth-intelligence.md
06-browser-sniff-gate.md
07-crowd-sniff-gate.md
08-ecosystem-absorb-gate.md
09-api-reachability-gate.md
10-generate.md
11-build-the-goat.md
12-shipcheck.md
13-sync-param-drop-gate.md
14-agentic-skill-review.md
15-readme-skill-agents-correctness-audit.md
16-agentic-output-review.md
17-local-code-review.md
18-dogfood-testing.md
19-polish.md
20-promote-and-archive.md
21-next-steps.md
references/
absorb-scoring.md
aggregator-pattern.md
auth-companion.md
browser-sniff-capture.md
codex-delegation.md
crowd-sniff.md
deepwiki-research.md
device-sniff-ble.md
dogfood-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。

步骤文件
1phases/01-preflight.md
2phases/02-run-initialization.md
3phases/03-resolve-and-reuse.md
4phases/04-research-brief.md
5phases/05-pre-browser-sniff-auth-intelligence.md
6phases/06-browser-sniff-gate.md
7phases/07-crowd-sniff-gate.md
8phases/08-ecosystem-absorb-gate.md
9phases/09-api-reachability-gate.md
10phases/10-generate.md
11phases/11-build-the-goat.md
12phases/12-shipcheck.md
13phases/13-sync-param-drop-gate.md
14phases/14-agentic-skill-review.md
15phases/15-readme-skill-agents-correctness-audit.md
16phases/16-agentic-output-review.md
17phases/17-local-code-review.md
18phases/18-dogfood-testing.md
19phases/19-polish.md
20phases/20-promote-and-archive.md
21phases/21-next-steps.md

遵循每个文件末尾的 Next: 指引,并记录每个阶段指定的交接回执。后续流程位于阶段文件中,或位于该阶段加载的、以角色命名的参考文件中 (references/phase-receipts.md、references/codex-delegation.md、 references/fetch-docs.md)。不要在此处复述这些文件的内容。

评论

支持 Markdown