AgentSkillsCN

document-secrets

更新添加密钥时的文档。适用于“添加密钥”“添加环境变量”“设置API密钥”等请求时使用。

SKILL.md
--- frontmatter
name: document-secrets
description: シークレット追加時のドキュメント更新。「シークレットを追加」「環境変数を追加」「API キーを設定」などのリクエスト時に使用。

Document Secrets

GitHub Secrets が追加された際に、関連ドキュメントを更新するスキル。

役割

新しいシークレットが追加されたら、以下のドキュメントを更新する:

  • •/CLAUDE.md (英語)
  • •/docs/CLAUDE.ja.md (日本語)

対象セクション

両ファイルの「GitHub Secrets Required」セクション内のテーブルを更新する。

既存カテゴリ

カテゴリ用途
Infrastructure SecretsVercel, CloudFlare 等のインフラ
Authentication SecretsOAuth, Auth ライブラリ関連
Third-party Service SecretsSlack, OpenAI 等
GitHub App SecretsGitHub App ID, Private Key

テーブル形式

markdown
| Secret | Description |
| ------ | ----------- |
| SECRET_NAME | What the secret is used for |

手順

  1. •

    シークレット情報の確認

    • •シークレット名（例: OPENAI_API_KEY）
    • •用途・説明（英語と日本語）
    • •適切なカテゴリ
  2. •

    CLAUDE.md の更新

    • •該当カテゴリのテーブルにシークレットを追加
    • •説明は英語で記載
    • •アルファベット順でソート
  3. •

    docs/CLAUDE.ja.md の更新

    • •該当カテゴリのテーブルにシークレットを追加
    • •説明は日本語で記載
    • •アルファベット順でソート
  4. •

    新規カテゴリが必要な場合

    • •両ファイルに同じ構造でカテゴリを追加
    • •既存カテゴリの後に配置

例

追加前

markdown
### Third-party Service Secrets

| Secret | Description |
| ------ | ----------- |
| OPENAI_API_KEY | OpenAI API key for PR desc |
| SLACK_WEBHOOK_DEV | Slack webhook (dev) |
| SLACK_WEBHOOK_PROD | Slack webhook (prod) |

追加後（GEMINI_API_KEY を追加）

markdown
### Third-party Service Secrets

| Secret | Description |
| ------ | ----------- |
| GEMINI_API_KEY | Google Gemini API key for image generation |
| OPENAI_API_KEY | OpenAI API key for PR desc |
| SLACK_WEBHOOK_DEV | Slack webhook (dev) |
| SLACK_WEBHOOK_PROD | Slack webhook (prod) |

注意事項

  • •シークレットの実際の値は記載しない
  • •説明は簡潔に（1行以内）
  • •環境別サフィックス（_DEV, _PROD）がある場合はそのまま記載
  • •wrangler.toml や GitHub Actions で使用されるシークレットも対象