stargazer-atlas-skill は何をしますか?
プライバシーを保護するGitHubスターゲイザーアトラスページとGitHub Pagesデプロイワークフローを構築するためのCodexスキルです。
概要
このスキルは、指定されたGitHubリポジトリのスターゲイザーの一覧を取得し、それらを視覚化したアトラスページ(地図や統計情報を含む)を生成します。生成されたページは、GitHub Pagesを使用して自動的にデプロイされます。プライバシーに配慮し、個人を特定できる情報(PII)を過度に公開することなく、スターゲイザーの地域分布などの概要を表示します。
前提条件
- Codex プラットフォームへのアクセス権限
- GitHub アカウントと対象リポジトリへのアクセス権限
- GitHub パーソナルアクセストークン(
repoスコープが必要)
使用方法
- Codex 環境でスキルを有効化します。
- 以下の環境変数を設定します:
GITHUB_TOKEN: GitHub パーソナルアクセストークンGITHUB_REPOSITORY: 対象のリポジトリ(例:owner/repo)
- スキルを実行すると、自動的にスターゲイザーデータの収集、アトラスページの生成、GitHub Pages へのデプロイが行われます。
スキルの動作
- データ収集: GitHub API を介してリポジトリのスターゲイザー情報を取得します。
- ページ生成: 取得したデータを基に、HTML/CSS/JavaScript で構成されたインタラクティブなアトラスページを生成します。
- デプロイ: 生成されたページを
gh-pagesブランチにコミットし、GitHub Pages として公開します。
設定オプション
| オプション | 説明 | デフォルト値 |
|---|---|---|
--privacy-mode | 個人情報の表示を制限する | true |
--include-locations | 地理的位置情報を含める | false |
注意事項
- 大量のスターゲイザーがいるリポジトリの場合、APIレート制限に注意してください。
- プライバシーモードが有効な場合、ユーザー名やプロフィールリンクは表示されません。
- 生成されたページは、デフォルトで
https://<owner>.github.io/<repo>/にデプロイされます。
ライセンス
MIT License