mcpField
M
maintain

maintain

github.com/gwpicardその他239 回インストール今日更新
リポジトリ

maintain について

setup-ai-build-kit を使うプロジェクト向けのメンテナンススキルです。記録、ライブコピーとの差分、ブランチ保護、シークレット、更新、定期作業を確認し、未コミットの作業をコミットに含めないようにします。

主な機能

  1. 01記録とライブコピーの差分確認
  2. 02ブランチ保護とシークレットの確認
  3. 03月次・四半期メンテナンスの追跡
  4. 04アップグレード確認とキット更新

活用シーン

  1. 01メンテナンス時のプロジェクト確認
  2. 02月次・四半期作業の期限確認
  3. 03シークレットとブランチ保護の不足確認

インストール

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

$npx skills add https://github.com/gwpicard/ai-build-kit --skill maintain

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

VERSION
references/
handover-retirement.md
kit-update.md
latest-release.md
monthly.md
project-checks.md
quarterly.md
recipe-move.md
risk-move.md
truing.md
scripts/
kit-leftovers.py
kit-released-copies.json
kit-retired-skills.json
old-skill-pointers.py
recipe-freshness.py
risk_move.py
settings-rules.py
standing-lines.sh
upgrade-check.py
templates/
handover.md

詳細

保守

保守では、キューに入れたビルド、並列ビルド、ループビルド、自動マージは行いません。

記録を実態に合わせ、ライブコピーをmainと比較し、キットの更新を完了します。定期更新を超える変更を適用する前に、調査結果を報告します。

Codexで、プッシュ、フェッチ、リモートチェックがunable to get password from userで失敗した場合は、インストール済みのsetup-ai-build-kitスキルにある templates/foundation/codex-github-check.pyをpython3と--messageで実行します。 その文を伝えて終了します。

訪問のたびに行うこと

  1. references/truing.mdを読み、指示に従います。本人の未コミット作業を、すべてのコミットに含めないようにします。作業内容を報告し、/what-nowを案内します。クリーンなチェックポイントを必要とする手順は保留し、読み取り専用の手順は続行します。 scripts/recipe-freshness.pyでプロジェクトのレシピを確認します。古い、または置き換えられたレシピだと報告された場合は、その一行の所見を伝え、現在の推奨事項に移行する項目を開くことを提案します。断られた場合は、プロジェクトファイルを変更しません。
  2. live-copyスキルを使って、ライブコピーをmainと比較します。ライブサービスや変更履歴は変更しません。バックアップ、復元、プレビュー、レシピの確認には/setup-hostingを提案し、不足事項があれば明示します。
  3. プロジェクトのルートから merge/scripts/protect-branch.py --check <origin's owner/repository> mainを実行します。 終了コードが0なら必須、3ならプライベートリポジトリでのFreeプランの制限を記録し、一度だけ通知して提案はしません。4なら利用可能なので、承認を得たうえで--checkなしで実行することを提案します。それ以外の終了コードは報告します。その承認なしに保護設定を変更しません。
  4. インストール済みのsetup-ai-build-kitスキルにある templates/foundation/scan-secrets.shを、プロジェクトのルートから--allを付けて実行します。 終了コードが0なら秘密情報は見つからず、1なら見つかり、2ならスキャンを実行できなかったことを意味します。秘密情報が見つかった場合は、ローテーションするよう伝えます。値は決して表示しません。
  5. .ai-build-kit-maintenanceを読みます。月次作業は、last-light-passから30日後、または記録がない場合は創設時に期限を迎えます。四半期作業は、last-full-passから90日後、記録がない場合は創設時に期限を迎え、引き継ぎを求められた場合にも実施します。どちらも依頼があれば実施します。見送った作業の期限を伝えます。
  6. references/latest-release.mdを使い、scripts/upgrade-check.py --latest --routeを実行します。
  7. 訪問のたびにreferences/kit-update.mdを使ってキットの更新を完了します。月次定期作業では、最初の手順でこれを行います。Codexでは、セッション開始時のGitHubチェックを提案します。

期限が来た定期作業

月次作業の期限が来たら、references/monthly.mdを読み、順番に従って実施します。 四半期作業では、references/quarterly.mdも読みます。

引き継ぎと終了

引き継ぎまたは終了の際は、references/handover-retirement.mdを読みます。

完了条件

記録が実際の出来事と一致しており、保護設定の確認とライブコピーの不足事項が報告され、期限の来た作業と承認済みの変更が保存され、次回の訪問時期を本人が把握していること。

コメント