mcpField
C
clickupfy-release

clickupfy-release

github.com/promovawebクラウド・DevOps459 回インストール3 日前に更新
リポジトリ

clickupfy-release について

ClickUpfy リポジトリのリリース手順を扱うスキルです。Release Please でバージョンとリリース情報を管理し、GitHub Actions で成果物をビルド、公開するとともに、ユーザー向け文書と再現性を確認します。

主な機能

  1. 01Conventional Commits によるリリース入力
  2. 02バージョンとリリースメタデータの検証
  3. 03GitHub Actions によるプラットフォーム別実行ファイルのビルド
  4. 04npm と GitHub Release 成果物の公開
  5. 05電子書籍の文書と生成ファイルの確認

活用シーン

  1. 01リリース前の変更準備と検証
  2. 02Release PR のレビューとマージ
  3. 03リリースビルドや公開失敗の診断
  4. 04既存タグを再利用しないリリース復旧

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/promovaweb/clickupfy --skill clickupfy-release

インストール後、Claude Code で/clickupfy-releaseを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

ClickUpfy のリリース

タグを作成したり、バージョンを手動で変更したりせずに、再現可能なリリースを実施します。 Release Please がバージョン、変更履歴、タグ、GitHub Release の基準となります。GitHub Actions は、リリース作成後に成果物をビルドして公開します。

リリースのドキュメント網羅性

そのバージョンのすべてのコマンド、パラメーター、MCP ツール、公開動作が docs/user/ で説明されていることを確認してください。マニュアルでは、入力、 出力、権限、永続的な影響、API の制限、コマンドまたはツールごとの異なる例を 5 つ詳しく説明する必要があります。また、docs/user/reading-order.txt を 確認し、各章が PDF と EPUB にそれぞれ 1 回ずつ掲載されていることを確認してください。

ドキュメントに変更がある場合は、ebook/VERSION を確認し、 npm run ebook と npm run ebook:verify を実行して、生成されたマニフェストに 記載された成果物を公開してください。ヘルプテキストが変更された場合は、 マニュアル内の対応する説明なしにリリースしないでください。

開始前

  1. 独立したリポジトリ clickupfy/ 内で作業します。
  2. RELEASING.md を読み、git status --short を確認します。
  3. リリースに関係のないローカル変更を保持します。
  4. 依存関係がまだインストールされていない場合は、npm ci を実行します。
  5. 明示的に承認された復旧の場合を除き、タグを作成したり、バージョンを直接編集したりしないでください。

変更の準備

Conventional Commits を使用します。Release Please は、最後のリリース以降の 履歴に基づいて次のバージョンを決定します。

  • fix: は patch を提案します。
  • feat: は minor を提案します。
  • feat!: または BREAKING CHANGE: は major を提案します。
  • docs:、build:、ci:、refactor: は変更履歴に含まれますが、機能変更に 存在する変更より大きなバージョンを強制しません。

変更を送信する前に：

npm run validar

このコマンドは、型、テスト、ビルド、バージョン、マニフェスト、変更履歴、ワークフローの 有無を確認します。

リリースの公開

  1. Conventional Commits を main にプッシュします。
  2. Release ワークフローが Release PR を作成または更新するまで待ちます。
  3. PR で提案されたバージョンと CHANGELOG.md を確認します。
  4. Release PR をマージします。
  5. 同じワークフロー実行を、以下の結果が得られるまで確認します。
    • 不変のタグ vMAJOR.MINOR.PATCH；
    • GitHub Release；
    • Linux x64、macOS x64、macOS arm64、Windows x64 用の実行ファイル；
    • npm レジストリに公開されたパッケージ @promovaweb/clickupfy；
    • GitHub Release にある、同じ npm パッケージの .tgz ファイル；
    • SHA256SUMS；
    • リポジトリが公開されている場合の来歴証明。

通常のフローでは git tag や gh release create を実行しないでください。

ローカルでの検証

現在のバージョンの整合性を検証します。

npm run release:check
npm run release:check -- v0.1.0

2 つ目のコマンドでは、現在のバージョンに対応するタグのみを使用してください。ローカル プラットフォーム用の実行ファイルを生成してテストします。

npm run build:executable
./artifacts/clickupfy-v0.1.0-linux-x64/clickupfy --version

スクリプトに表示されたバージョン、プラットフォーム、アーキテクチャに合わせて 成果物名を変更してください。

障害の診断

  • Release PR が見つからない：ワークフローのトリガー、Actions の権限、 bootstrap-sha または最後のタグ以降に Conventional Commits があるかを確認します。
  • Release PR で CI が実行されない：RELEASING.md に従って、任意のシークレット RELEASE_PLEASE_TOKEN を設定します。
  • バイナリなしでリリースが作成された：同じ実行内の失敗したジョブを再実行します。
  • npm の公開に失敗した：シークレット NPM_TOKEN を確認してジョブを再実行します。 スクリプトはレジストリにすでに存在するバージョンをスキップします。
  • 成果物が無効：影響を受けるプラットフォームで npm ci、npm run validar、 npm run build:executable を実行して再現します。
  • バージョンが一致しない：1 つのファイルだけを修正しないでください。 package.json、package-lock.json、.release-please-manifest.json、 CHANGELOG.md、タグを調査します。

リリースを復旧する

公開済みのタグを移動したり、再利用したりしないでください。コードに誤りがある場合は、修正用の Conventional Commit を送信し、新しいパッチリリースを公開してください。ファイルが 不足している場合やジョブが中断された場合は、タグ付けされたコミットでワークフローを再実行してください。アップロードでは、 同じリリースの名前に対して冪等な置換が行われます。

自動化で復旧できず、明示的な承認がある場合に限り、GitHub CLI の手動操作を使用してください。 引き継ぎには、理由、タグ、置換したファイル、実行した検証を記録してください。

コメント

Markdown 対応