Agent skill
electron-code-signing
Electron code signing and notarization workflow for macOS, Windows, and Linux distribution. Anchors: • electron-builder documentation / 適用: Code signing configuration / 目的: Proper certificate management and platform-specific signing • Apple Developer Program / 適用: macOS signing and notarization / 目的: App Store and Gatekeeper compliance • Windows Authenticode / 適用: Windows EV/OV certificate signing / 目的: SmartScreen bypass and user trust Trigger: Use when configuring code signing for Electron apps, setting up certificates for macOS/Windows/Linux, implementing notarization workflows, resolving signing errors, or distributing signed executables. Keywords: code signing, electron-builder, notarization, certificate, macOS signing, Windows Authenticode, entitlements, hardened runtime, EV certificate
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/electron-code-signing
SKILL.md
Electron Code Signing
概要
Electronアプリケーションの配布には、各プラットフォームでの適切なコード署名が必須です。このスキルは、macOS(公証含む)、Windows(Authenticode)、Linuxのコード署名ワークフローを提供します。
ワークフロー
Phase 1: Certificate Setup
目的: 証明書の取得、インストール、検証
アクション:
- プラットフォームに応じた証明書を取得
- キーチェーン/証明書ストアにインストール
- 環境変数を設定
Task: agents/certificate-setup.md を参照
Phase 2: Configuration
目的: electron-builderの署名設定を構成
アクション:
- electron-builder.ymlに署名設定を追加
- エンタイトルメント(macOS)を構成
- CI/CD環境変数を設定
Task: agents/signing-configuration.md を参照
リソース: references/macos-signing-guide.md, references/windows-signing-guide.md
Phase 3: Signing & Notarization
目的: 実際の署名と公証プロセスを実行
アクション:
- アプリケーションをビルド
- 署名を実行
- 公証を申請(macOS)
Task: agents/signing-execution.md を参照
Phase 4: Verification
目的: 署名とセキュリティ設定を検証
アクション:
- 署名の有効性を確認
- Gatekeeper/SmartScreenテストを実行
- 問題を報告・修正
Task: agents/signing-verification.md を参照
Task仕様ナビ
| Task | エージェント | 入力 | 出力 |
|---|---|---|---|
| Certificate Setup | certificate-setup.md | プラットフォーム、証明書種 | 証明書インストール確認 |
| Configuration | signing-configuration.md | プロジェクト構成、証明書 | electron-builder設定 |
| Signing Execution | signing-execution.md | ビルド済みアプリ | 署名済みバイナリ |
| Verification | signing-verification.md | 署名済みバイナリ | 検証レポート |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| 本番証明書は環境変数で管理 | セキュリティ確保 |
| CI/CDで暗号化シークレット使用 | 証明書の安全な管理 |
| 署名前にローカルでテスト | 問題の早期発見 |
| macOSではHardened Runtime有効化 | 公証に必須 |
| 公証完了後にstaple実行 | オフライン検証サポート |
| 各プラットフォームで署名検証 | 配布前の品質確認 |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| 証明書をリポジトリにコミット | セキュリティリスク |
| 開発証明書で本番配布 | 信頼性の問題 |
| 公証なしでmacOSアプリ配布 | Gatekeeperにブロックされる |
| Windowsで署名なし配布 | SmartScreen警告 |
| エンタイトルメントの過剰権限 | セキュリティリスク |
リソース参照
scripts/(決定論的処理)
| スクリプト | 機能 |
|---|---|
log_usage.mjs |
フィードバック記録 |
validate-skill.mjs |
スキル構造の検証 |
references/(詳細知識)
| リソース | パス | 読込条件 |
|---|---|---|
| macOS署名 | references/macos-signing-guide.md |
macOS署名時 |
| Windows署名 | references/windows-signing-guide.md |
Windows署名時 |
| Linux署名 | references/linux-signing-guide.md |
Linux署名時 |
assets/(テンプレート)
| アセット | 用途 |
|---|---|
entitlements.plist |
macOSエンタイトルメント |
electron-builder-signing.yml |
署名設定テンプレート |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2026-01-01 | 18-skills.md仕様準拠版に再構築 |
| 1.0.0 | 2025-12-31 | 初版作成 |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?