mcpField
G
github-project

github-project

github.com/netresearch開発10126 回インストール今日更新
リポジトリ

github-project について

github-projectは、開発者やメンテナー向けのGitHubリポジトリ管理スキルです。ブランチ保護、プルリクエスト、CI、セキュリティ、リポジトリ運用のスクリプトと資料をまとめています。

主な機能

  1. 01ブランチ保護の設定と検証
  2. 02プルリクエストのマージ診断
  3. 03GitHub Actionsの失敗確認
  4. 04セキュリティとルールセットのガイド
  5. 05リポジトリ運用の参考資料

活用シーン

  1. 01リポジトリ作成後のブランチ保護設定
  2. 02マージできないプルリクエストの調査
  3. 03失敗したGitHub Actions実行の調査
  4. 04セキュリティと自動マージ設定の確認

インストール

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

$npx skills add https://github.com/netresearch/github-project-skill --skill github-project

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

同梱ファイル

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

checkpoints.yaml
assets/
auto-merge-direct.yml.template
auto-merge-queue.yml.template
auto-merge.yml.template
branch-protection.json.template
bug_report.md.template
CODEOWNERS.template
CONTRIBUTING.md.template
dependabot.yml.template
feature_request.md.template
pr-quality.yml.template
PULL_REQUEST_TEMPLATE.md.template
release-labeler.yml.template
renovate.json.template
SECURITY.md.template
evals/
evals.json
references/
actionlint-guide.md
actions-upgrade-guide.md
agentic-workflows.md
ai-reviewer-pushback.md
auto-merge-guide.md
branch-migration.md
ci-runner-capacity.md
cross-repo-references.md
dependency-management.md
gh-cli-reference.md
merge-strategy.md
multi-repo-operations.md
no-editorializing.md
org-security-settings.md

詳細

GitHub プロジェクトスキル

使用する場面

  • gh repo create とプッシュの後、最初の PR を作成する前 — 必須：scripts/init-branch-protection.sh OWNER/REPO
  • 外部リポジトリへの最初の issue／PR — 起票する前に references/upstream-contributions.md を確認
  • ワークフロージョブの追加 — 落とし穴 #6
  • PR をマージできない／スレッド
  • 自動マージの失敗（Dependabot／Renovate）
  • 単独メンテナーによる自動承認
  • ブランチ保護、ルールセット
  • GHA の失敗
  • 署名付きコミットのマージ
  • CodeQL
  • Scorecard
  • CODEOWNERS、テンプレート、ラベル
  • フォーク PR のマージベース

クイック診断

PR をマージできない場合
gh pr view PR --repo OWNER/REPO \
  --json mergeStateStatus,reviewDecision,mergeable,reviewThreads
単独メンテナー：REVIEW_REQUIRED で進めない場合

assets/pr-quality.yml.template（自動承認、required_approving_review_count >= 1）または scripts/init-branch-protection.sh OWNER/REPO --solo（承認数 0、会話の解決要件は維持）を使用します。両者の比較については references/auto-merge-guide.md を参照してください。

自動マージのセットアップ

allow_auto_merge、pull_request_target、ボットの検出、gh pr merge --auto が必要です（references/auto-merge-guide.md）。

自動マージが機能しない場合
gh pr view PR --repo OWNER/REPO --json autoMergeRequest --jq .autoMergeRequest

バイパスアクター：references/security-config.md。

GitHub Actions が失敗する場合
gh run list --repo OWNER/REPO --limit 5
gh run view RUN_ID --repo OWNER/REPO --log-failed
gh run rerun RUN_ID --repo OWNER/REPO
セキュリティのクイックチェック
gh api repos/OWNER/REPO/rules/branches/main
gh api repos/OWNER/REPO/branches/main/protection \
  --jq '{rcr: .required_conversation_resolution.enabled, admins: .enforce_admins.enabled}'
gh api repos/OWNER/REPO/code-scanning/default-setup --jq '.state'
gh pr view PR --repo OWNER/REPO --json reviewThreads --jq '.reviewThreads'
マージ戦略の問題

references/auto-merge-guide.md：署名付きコミットのリベース、ワークフローファイルの PR、Copilot の競合。

組織の再利用可能ワークフローを呼び出す

ルール： uses: netresearch/<repo>/.github/workflows/<name>.yml@main を使用します。コミットハッシュは使用しません。また、@<sha> # main も使用しません。サードパーティのアクションは引き続き SHA で固定します。このような行に対する CodeQL の actions/unpinned-tag、zizmor、SonarCloud の検出結果は、修正不要として却下し、固定することで修正してはいけません。理由は references/reusable-workflow-security.md を参照してください。

スクリプトの実行

scripts/init-branch-protection.sh OWNER/REPO              # baseline
scripts/init-branch-protection.sh OWNER/REPO --from-current-checks   # after first CI
scripts/init-branch-protection.sh OWNER/REPO --merge-queue    # then: org-standard queue
scripts/verify-github-project.sh /path/to/repository      # local-checkout audit

主観的な評価を避ける

変更がどのようなものかを述べ、どれほど優れているかは述べないでください。

参考資料

トピック参考資料
リポジトリの初期設定references/repo-bootstrap.md
リポジトリのファイル構成references/repository-structure.md
ブランチの移行references/branch-migration.md
リポジトリの終了、Packagist での放棄references/repo-retirement.md
Dependabot／Renovatereferences/dependency-management.md
自動承認＋自動マージreferences/auto-merge-guide.md
マージ戦略references/merge-strategy.md
サブイシューreferences/sub-issues.md
リリースのラベリングreferences/release-labeling.md
gh CLI コマンドreferences/gh-cli-reference.md
複数言語の CI チェックリストreferences/repo-setup-guide.md
Scorecard、CodeQL、セキュリティreferences/security-config.md
actionlintreferences/actionlint-guide.md
Actions のアップグレード、Node ランタイムの移行references/actions-upgrade-guide.md
ワークフローの bash に関する落とし穴references/workflow-bash-patterns.md
ランナーの容量、並行実行グループ（schedule と push）references/ci-runner-capacity.md
主観的な評価を避けるreferences/no-editorializing.md
フォークのマージベースreferences/pr-commit-cleanup.md
複数リポジトリの一括操作references/multi-repo-operations.md
公開リポジトリの非公開コピー（ミラープッシュ）references/multi-repo-operations.md
リポジトリ間の参照、コードのパーマリンクreferences/cross-repo-references.md
外部リポジトリへのコントリビューションreferences/upstream-contributions.md
再利用可能ワークフローのセキュリティreferences/reusable-workflow-security.md
再利用可能ワークフローの落とし穴references/reusable-workflow-pitfalls.md
組織のセキュリティ設定references/org-security-settings.md
タグの検証references/tag-validation.md
AI レビュアーへの異議申し立てreferences/ai-reviewer-pushback.md
エージェント型ワークフローreferences/agentic-workflows.md
Pages とデータ収集ワークフローreferences/pages-and-collector-workflows.md

コントリビューション：https://github.com/netresearch/github-project-skill

コメント

Markdown 対応