ホームAutomationmitchellh/vouch
mitchellh

vouch

DevOps#GitHub Actions#Automation#Community Management#Nushell
GitHub で見る →
4,306

// 概要

Vouch は、プロジェクトが vouching と denouncing モデルを通じて貢献者を明示的に検証できるコミュニティ信頼管理システムです。GitHub Actions と CLI を統合し、ユーザーのステータスに基づいた貢献ポリシーの適用を自動化します。システムはシンプルでフラットなファイル形式で信頼記録を保持し、プロジェクトメンテナーにとっての透明性と使いやすさを確保します。

// 技術解説

Vouch は、AI が生成した低品質なコントリビューションの流入に対抗するために設計された、人間中心の明示的な信頼モデルを実装するコミュニティ信頼管理システムです。プロジェクトのメンテナーがコントリビューターを推薦または非難するための独自のポリシーを定義する分散型の哲学に基づいて運用されており、プロジェクトのやり取りに対するゲートキーピングのメカニズムを効果的に構築します。このシステムは、標準的なツールで容易に解析可能な「Trustdown」(.td) と呼ばれるシンプルなフラットファイル形式を利用し、自動化された GitHub Actions や Nushell ベースの CLI を通じて堅牢な GitHub 統合を提供することで、高い移植性と透明性を実現するように設計されています。

// 主要ハイライト

01
ユーザーの vouch ステータスに基づいて Issue や pull request をチェック、クローズ、または管理することで、信頼ポリシーを強制する自動化された GitHub Actions を提供します。
02
人間が読み取り可能なフラットファイルの「Trustdown」(.td) 形式を利用し、信頼リストの透明性と監査の容易さを維持します。
03
権限を持つコラボレーターが Issue やディスカッションのコメントを通じて直接ユーザーを推薦または非難できるようにすることで、コミュニティ主導のモデレーションを実現します。
04
複雑な外部依存関係を必要とせずに信頼リストをローカルで管理できる、Nushell で構築された柔軟な CLI を提供します。
05
既存のリポジトリメンテナーを信頼システムに自動的に統合し、セットアップを効率化する sync-codeowners アクションが含まれています。
06
プロジェクトのやり取りに対するきめ細かな制御をサポートし、プロジェクトのどの部分に vouch ステータスが必要かをメンテナーが正確に定義できるようにします。

// ユースケース

01
ユーザーの信頼ステータスに基づいた GitHub の issue および pull request の自動検証
02
issue や discussion のコメントを通じた貢献者の信頼管理
03
CODEOWNERS を信頼リストと同期し、プロジェクトメンテナーを自動的に vouch する機能

// クイックスタート

Vouch を使い始めるには、Nushell 環境をインストールし、提供されている GitHub Actions をリポジトリのワークフローに統合してください。プロジェクトのルートディレクトリまたは .github ディレクトリに VOUCHED.td ファイルを作成することで、信頼リストを初期化できます。CLI コマンドまたは GitHub のコメントトリガーを使用して、プロジェクト固有のコミュニティポリシーに従い、ユーザーの追加や非難を開始してください。