mcpField
P
printing-press

printing-press

github.com/mvanhorn開発4.9k7.6k 回インストール今日更新
リポジトリ

printing-press について

printing-pressは、APIの調査、Go CLIの生成、実際の対象を使ったテスト、実行成果物のアーカイブをエージェントに案内するスキルです。テスト済みのCLIと開発記録を必要とするユーザー向けで、記憶ではなくフェーズごとのレシートに従って進行します。

主な機能

  1. 01API調査とブリーフ作成
  2. 02Go CLIの生成
  3. 03ビルドと出荷チェック
  4. 04実際の対象でのドッグフードテスト
  5. 05フェーズレシートの追跡
  6. 06実行成果物のアーカイブ

活用シーン

  1. 01API用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 を、さらに最大 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 になるまでプレビューします。

手順ファイル
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)。これらのファイルの内容をここで繰り返さないでください。

コメント