repo-maintenance について
repo-maintenance は、設定ファイルの検証と、ドキュメントがリポジトリの構成を反映しているかの確認を行うスキルです。監査で問題が見つかった場合は、対象ファイルを確認し、修正前に承認を求めます。
主な機能
- 01エージェント、コマンド、スキル設定の検証
- 02リポジトリ文書の一覧確認
- 03検証ルールの参照
- 04修正前の承認確認
活用シーン
- 01変更後のリポジトリ設定の確認
- 02文書更新の必要性の評価
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ igorwarzocha/ opencode-workflows --skill repo-maintenanceインストール後、Claude Code で/repo-maintenanceを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/maintenance-standards.mdvalidation-rules.mdscripts/audit_repo.pysync_docs.py詳細
リポジトリ保守スキル
このスキルは、リポジトリ管理者として作業するためのツールを提供します。
リポジトリを検証する
設定ファイル(エージェント、コマンド、スキル)が有効であることを確認します。
- コマンド:
python3 .opencode/skill/repo-maintenance/scripts/audit_repo.py
ドキュメントを同期する
リポジトリの内容を報告し、ドキュメントの更新が必要かどうかを提案します。
- コマンド:
python3 .opencode/skill/repo-maintenance/scripts/sync_docs.py
監査に失敗した場合
監査でエラーまたは警告が報告された場合:
- 該当ファイルを読む - 出力に記載された各ファイルを必ず読みます
- 問題を分析する - 各問題の修正に必要な変更を把握します
- ユーザーに確認する - 修正内容について確認するため、必ず question ツールを使用します
- 選択的に適用する - ユーザーが承認した修正のみを行います
すべての問題を自動修正してはいけません。一括変更により、正常に動作している設定が壊れる可能性があります。
規約
以下については references/validation-rules.md を参照してください。
- YAML Frontmatter スキーマ
- 説明のパターン(エージェント、コマンド、スキル)
- RFC+XML の準拠要件
- 監査後のワークフローの詳細
コメント
Markdown 対応