maintain について
setup-ai-build-kit を使うプロジェクト向けのメンテナンススキルです。記録、ライブコピーとの差分、ブランチ保護、シークレット、更新、定期作業を確認し、未コミットの作業をコミットに含めないようにします。
主な機能
- 01記録とライブコピーの差分確認
- 02ブランチ保護とシークレットの確認
- 03月次・四半期メンテナンスの追跡
- 04アップグレード確認とキット更新
活用シーン
- 01メンテナンス時のプロジェクト確認
- 02月次・四半期作業の期限確認
- 03シークレットとブランチ保護の不足確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ gwpicard/ ai-build-kit --skill maintainインストール後、Claude Code で/maintainを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
VERSIONreferences/handover-retirement.mdkit-update.mdlatest-release.mdmonthly.mdproject-checks.mdquarterly.mdrecipe-move.mdrisk-move.mdtruing.mdscripts/kit-leftovers.pykit-released-copies.jsonkit-retired-skills.jsonold-skill-pointers.pyrecipe-freshness.pyrisk_move.pysettings-rules.pystanding-lines.shupgrade-check.pytemplates/handover.md詳細
保守
保守では、キューに入れたビルド、並列ビルド、ループビルド、自動マージは行いません。
記録を実態に合わせ、ライブコピーをmainと比較し、キットの更新を完了します。定期更新を超える変更を適用する前に、調査結果を報告します。
Codexで、プッシュ、フェッチ、リモートチェックがunable to get password from userで失敗した場合は、インストール済みのsetup-ai-build-kitスキルにある
templates/foundation/codex-github-check.pyをpython3と--messageで実行します。
その文を伝えて終了します。
訪問のたびに行うこと
references/truing.mdを読み、指示に従います。本人の未コミット作業を、すべてのコミットに含めないようにします。作業内容を報告し、/what-nowを案内します。クリーンなチェックポイントを必要とする手順は保留し、読み取り専用の手順は続行します。scripts/recipe-freshness.pyでプロジェクトのレシピを確認します。古い、または置き換えられたレシピだと報告された場合は、その一行の所見を伝え、現在の推奨事項に移行する項目を開くことを提案します。断られた場合は、プロジェクトファイルを変更しません。live-copyスキルを使って、ライブコピーをmainと比較します。ライブサービスや変更履歴は変更しません。バックアップ、復元、プレビュー、レシピの確認には/setup-hostingを提案し、不足事項があれば明示します。- プロジェクトのルートから
merge/scripts/protect-branch.py --check <origin's owner/repository> mainを実行します。 終了コードが0なら必須、3ならプライベートリポジトリでのFreeプランの制限を記録し、一度だけ通知して提案はしません。4なら利用可能なので、承認を得たうえで--checkなしで実行することを提案します。それ以外の終了コードは報告します。その承認なしに保護設定を変更しません。 - インストール済みの
setup-ai-build-kitスキルにあるtemplates/foundation/scan-secrets.shを、プロジェクトのルートから--allを付けて実行します。 終了コードが0なら秘密情報は見つからず、1なら見つかり、2ならスキャンを実行できなかったことを意味します。秘密情報が見つかった場合は、ローテーションするよう伝えます。値は決して表示しません。 .ai-build-kit-maintenanceを読みます。月次作業は、last-light-passから30日後、または記録がない場合は創設時に期限を迎えます。四半期作業は、last-full-passから90日後、記録がない場合は創設時に期限を迎え、引き継ぎを求められた場合にも実施します。どちらも依頼があれば実施します。見送った作業の期限を伝えます。references/latest-release.mdを使い、scripts/upgrade-check.py --latest --routeを実行します。- 訪問のたびに
references/kit-update.mdを使ってキットの更新を完了します。月次定期作業では、最初の手順でこれを行います。Codexでは、セッション開始時のGitHubチェックを提案します。
期限が来た定期作業
月次作業の期限が来たら、references/monthly.mdを読み、順番に従って実施します。
四半期作業では、references/quarterly.mdも読みます。
引き継ぎと終了
引き継ぎまたは終了の際は、references/handover-retirement.mdを読みます。
完了条件
記録が実際の出来事と一致しており、保護設定の確認とライブコピーの不足事項が報告され、期限の来た作業と承認済みの変更が保存され、次回の訪問時期を本人が把握していること。
コメント
Markdown 対応