printing-press について
printing-pressは、APIの調査、Go CLIの生成、実際の対象を使ったテスト、実行成果物のアーカイブをエージェントに案内するスキルです。テスト済みのCLIと開発記録を必要とするユーザー向けで、記憶ではなくフェーズごとのレシートに従って進行します。
主な機能
- 01API調査とブリーフ作成
- 02Go CLIの生成
- 03ビルドと出荷チェック
- 04実際の対象でのドッグフードテスト
- 05フェーズレシートの追跡
- 06実行成果物のアーカイブ
活用シーン
- 01API用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 を、さらに最大 5 つの詳細な原稿を $PRESS_MANUSCRIPTS/<api-slug>/<run-id>/ にアーカイブします。原稿は、調査概要、吸収マニフェスト、ビルドログ、出荷確認の証跡、ライブテストを実施した場合はライブスモークテストの証跡です。
次の利用者: CLI を実行または出荷するユーザーと、ここから引き継ぐ関連スキルです。2 回目のパスを担当する printing-press-polish、公開ライブラリを担当する printing-press-publish、Press 自体に関する調査結果を扱う printing-press-retro です。
完了条件: 吸収ゲートで承認されたすべての機能が実装され、出荷確認が出荷可能に達し、実際のターゲットに対してライブのドッグフードテストマトリクスが実行され、CLI が昇格され、最後のフェーズでレシート台帳が締められていることです。
目的: フェーズごとの見せかけに時間をかけず、API 向けの、最も役に立つ CLI を作ることです。ドキュメント作成までの時間ではなく、出荷までの時間を最適化します。既存の調査がすでに十分な品質であれば再利用し、安価でシグナルの強いチェックを早い段階で実行し、磨き込みより先にブロッカーを修正します。
境界
- 秘密情報を決して漏らさないでください。 API キーの値、トークンの値、パスワード、セッション Cookie を、ソース、原稿、証跡、README、HAR、レシート、その他コミット対象のあらゆるものに含めてはいけません。環境変数の名前とプレースホルダーは安全です。フェーズ 5.6 と公開では references/secret-protection.md を適用してください。
- テストしていないものを決して出荷しないでください。
go buildとverifyの合格率は構造的なシグナルであり、正しさを示すシグナルではありません。phases/18-dogfood-testing.md のライブマトリクスを通過していない CLI は出荷できません。また、1~3 個のファイルを編集すれば解決するバグは、v0.2 用に記録するのではなく、今すぐ修正します。 - サブタスクについて、「約 15~30 分」「すぐ直せます」など、人間の作業時間の見積もりを決して記載しないでください。作業するのはエージェントであり、ユーザーではありません。代わりに作業範囲を説明してください。例外は、全体の実行(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)。これらのファイルの内容をここで繰り返さないでください。