release-check について
プロジェクトのリリース準備状況を手動で確認するスキルです。必須成果物、ドキュメント、バージョンの整合性、API ドキュメントをチェックリストにまとめ、問題と準備状況を示します。
主な機能
- 01仕様関連成果物の完全性確認
- 02README と変更履歴の確認
- 03パッケージと変更履歴のバージョン確認
- 04API ドキュメントの確認
- 05準備状況と問題の提示
活用シーン
- 01リリース前の準備状況確認
- 02必須成果物の不足箇所の特定
- 03バージョンと API ドキュメントの整合性確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ drillan/ speckit-gates --skill release-checkインストール後、Claude Code で/release-checkを入力して読み込まれたか確認します。
同梱ファイルscripts/check.sh
詳細
release-check
リリースを作成する前に、リリースの準備状況を検証します。
目的
このスキルは、すべての成果物がリリースに向けて完成し、整合性が取れていることを検証します。
- Spec kit の成果物:spec.md、plan.md、tasks.md が存在し、完成している
- ドキュメント:README.md、CHANGELOG.md に必要なセクションがある
- バージョン管理:package.json と CHANGELOG のバージョン番号が一致している
- API ドキュメント:API ドキュメントが契約仕様と一致している
出力
このスキルは、次の内容を含む ReleaseChecklist を出力します。
- 全体の準備状況(Ready/Not Ready)
- 各チェック項目の合格/不合格/スキップのステータス
- バージョンの整合性に関する情報
- リリース前に対処すべき具体的な問題
使用方法
これは手動で実行するスキルです。リリースを作成する前に実行してください。
npx skills run release-check
または、AI エージェント経由で実行します。
User: Check if we're ready for release
終了コード
| コード | ステータス | 意味 |
|---|---|---|
| 0 | Ready | すべてのチェックに合格 |
| 1 | Not Ready | 一部のチェックに不合格 |
| 3 | Error | 必須ファイルが見つからない |
実行するチェック
成果物のチェック(FR-022)
| チェック | 要件 |
|---|---|
| spec.md が存在する | 必須 |
| plan.md が存在する | 必須 |
| tasks.md が存在する | 必須 |
| すべてのタスクが完了している | 必須 |
ドキュメントのチェック(FR-023)
| チェック | 要件 |
|---|---|
| README.md が存在する | 必須 |
| README.md に使用方法のセクションがある | 必須 |
| CHANGELOG.md が存在する | 必須 |
| CHANGELOG.md に未リリースのセクションがある | 必須 |
バージョンのチェック(FR-026)
| チェック | 要件 |
|---|---|
| package.json にバージョンが記載されている | 任意 |
| CHANGELOG.md にバージョンが記載されている | 任意 |
| バージョンが一致している | 両方に記載がある場合 |
API のチェック(FR-025)
| チェック | 要件 |
|---|---|
| contracts/ が存在する | 任意 |
| contracts がある場合、API ドキュメントが存在する | contracts がある場合は必須 |
| エンドポイントが文書化されている | contracts がある場合は必須 |
チェックリストの出力形式
## Release Checklist
**Status**: Ready to Release / Not Ready
### Artifacts
| Status | Check | Details |
|--------|-------|---------|
| [PASS] | spec.md exists | |
| [PASS] | plan.md exists | |
| [FAIL] | All tasks complete | 5 tasks remaining |
### Documentation
| Status | Check | Details |
|--------|-------|---------|
| [PASS] | README.md exists | |
| [SKIP] | API docs | No contracts/ directory |
推奨事項
リリースチェックに失敗した場合:
- tasks.md に残っているすべてのタスクを完了します
- README.md に使用方法のセクションがあることを確認します
- CHANGELOG.md をリリースノートで更新します
- バージョン番号に一貫性があることを確認します
- 修正内容を確認するため、release-check を再実行します
コメント
Markdown 対応