SuperAPI AI 工具集

printing-press-amend

智能体与模型

查看项目

更新于 10-16 01:31

技能介绍

用途:/printing-press-amend 用于在 CLI 发布后,基于真实使用中出现的摩擦或用户新诉求,对公共库中的已发布 CLI 做修订。它与 /printing-press-publish(新增 CLI)、/printing-press-polish(发布前改进)、/printing-press-retro(反思机器本身)互为兄弟技能,专门覆盖发布后的修订场景。产物在语义上是一个“补丁”,由公共库的 .printing-press-patches/ 目录跟踪,每个补丁一个文件;源码内联的 // PATCH(...) 注释是可选的导航辅助。

主要能力:支持两种输入来源。dogfood 模式挖掘当前 Claude Code 会话记录,提取非零退出码、错误消息、手写 API 负载、失败后重试、缺失标志、静默空返回、认证困惑等摩擦信号,并分类为 bug(行为错误)或 feature(行为缺失)。direct-input 模式使用斜杠命令提示中用户明确提出的诉求。二者可合并运行。发现项统一为带 id、kind、category、classification、evidence、target_cli、rationale、provenance 的类型化列表。目标 CLI 支持短名、全名或绝对路径;未显式指定时按信号出现次数自动检测并让用户确认。

使用方式:命令形式包括 /printing-press-amend(从会话自动检测目标 CLI)、/printing-press-amend superhuman、/printing-press-amend superhuman-pp-cli、/printing-press-amend "$PRESS_LIBRARY/superhuman"。先运行 setup 契约,捕获 PRINTING_PRESS_BIN=<绝对路径>,后续每次 cli-printing-press 调用都必须使用该绝对路径(export PATH 只影响单个 Bash 调用)。随后检测输入模式并写入 $PRESS_RUNSTATE/current/mode.txt,模式为 dogfood、direct 或 both。dogfood 模式要解析当前会话记录文件,且读取前须经用户确认。安装命令:go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest。

限制与前置条件:需要 Go 工具链;技能声明 min-binary-version: 4.0.0,低于最低版本需先升级。若 setup 输出 [upgrade-required](低于发布的最低支持版本,older releases regenerate CLIs with since-fixed bugs),这是硬性门槛,只能升级或中止,没有跳过选项。可能还会输出 [go-toolchain-old] 或 [low-disk] 等提示。该流程可能需要数 GiB 空间用于生成文件、Go 构建缓存、模块下载或仓库克隆。其余具体步骤与文件细节暂未提供。