메뉴
パッケージの追加・削除・インストール・セットアップ時に全プラットフォーム（macOS/Linux/Windows）の 整合性を確保する。「〜を追加して」「〜をインストールして」「〜を入れて」「〜をセットアップ」 「〜を削除して」「Brewfile に〜」「dotfiles に〜を追加」等のパッケージ変更リクエストで必ず実行。 CLI ツール、GUI アプリ、言語ランタイム、NPM パッケージ、VS Code 拡張の追加・削除すべてに適用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
install.sh / install.ps1 を編集した後、関連ドキュメント（README.md 等）の整合性を確認・更新する。インストールスクリプトを変更したら必ず実行。
Reorganize project documentation with bilingual (English/Japanese) structure. Use when asked to "reorganize docs", "update documentation", or "sync documentation".
Ghostty設定ファイルの修正。公式ドキュメントを参照してキーバインディング、フォント、テーマ、ウィンドウ設定などを支援
Markdown ファイル編集後のリント実行。Markdown を作成・編集したら必ず実行。
SOC 직업 분류 기준
| name | sync-packages |
| description | パッケージの追加・削除・インストール・セットアップ時に全プラットフォーム（macOS/Linux/Windows）の 整合性を確保する。「〜を追加して」「〜をインストールして」「〜を入れて」「〜をセットアップ」 「〜を削除して」「Brewfile に〜」「dotfiles に〜を追加」等のパッケージ変更リクエストで必ず実行。 CLI ツール、GUI アプリ、言語ランタイム、NPM パッケージ、VS Code 拡張の追加・削除すべてに適用。 |
パッケージを追加・削除する際に、全プラットフォーム（macOS, Linux, Windows）間の整合性を確保するスキル。
パッケージを追加・削除する場合は、必ずこのスキルに従って全プラットフォームの整合性を確認・更新すること。
config/packages/Brewfile — macOS/Linux CLI ツール + macOS cask (GUI)config/packages/apt-packages.txt — Ubuntu/Debian システム依存パッケージscripts/installers/apt.sh — Linux GUI アプリ個別インストーラー（snap/flatpak/.deb）install.ps1 — Windows: Scoop / WinGet / NPM / PowerShell モジュールinstall.sh — 全 OS のセットアップエントリーポイント（Obsidian 個別インストール含む）src/.config/mise/config.toml — mise 共通設定（node LTS ベース）src/.config/mise/config.personal.toml — Personal: AI CLI ツール（NPM）+ node バージョンsrc/.config/mise/config.work.toml — Work: 最小構成（空）mise.toml(ルート) — リポジトリローカル開発ツール(terraform / trivy / biome)Brewfile(ルート) — CI/最小構成用(config/packages/Brewfile のサブセット)src/.vscode/extensions.json — VS Code 拡張機能（全 OS 共通）config/packages/Brewfile に brew "name" で追加install.ps1 の Install-ScoopPackages 内 $packages 配列に追加サードパーティの brew パッケージは tap が必要:
# Brewfile
tap "owner/repo"
brew "owner/repo/name" # 説明
Scoop でデフォルト bucket にないパッケージは、Install-ScoopPackages 内で bucket 追加済みか確認:
# install.ps1 - 既存の bucket 追加
scoop bucket add extras 2>$null
scoop bucket add nerd-fonts 2>$null
Brewfile の if OS.mac? 内に cask "name" で追加apt.sh に install_xxx() 関数を追加install.ps1 の Install-WingetPackages 内 $packages 配列に追加Linux の GUI アプリは snap/flatpak/.deb のいずれかでインストールする。apt.sh の既存関数パターンを参照:
# apt.sh - 新規 GUI アプリ関数テンプレート
install_xxx() {
log_info "Installing XXX..."
local os
os=$(detect_os)
if [[ "$os" != "ubuntu" && "$os" != "mint" && "$os" != "linux" ]]; then
log_warn "XXX installation is only available on Ubuntu/Debian/Mint. Skipping..."
return 0
fi
if command -v xxx &>/dev/null; then
log_debug "XXX is already installed"
return 0
fi
if [[ "${DRY_RUN:-false}" == "true" ]]; then
log_info "[DRY-RUN] Would install XXX"
return 0
fi
# snap → flatpak → .deb の優先順位でインストール
if command -v snap &>/dev/null; then
log_info "Installing XXX via Snap..."
sudo snap install xxx
elif command -v flatpak &>/dev/null; then
log_info "Installing XXX via Flatpak..."
flatpak install -y flathub org.example.XXX
else
log_warn "Neither snap nor flatpak available. Skipping XXX installation."
return 0
fi
log_success "XXX installed"
}
Linux GUI アプリを追加したら、install.sh の main() 関数内から呼び出しを追加する。Server モードチェック内に配置すること:
# install.sh - main() 内
if [[ "${SERVER_MODE:-false}" != "true" ]]; then
install_xxx # ← 追加
fi
WinGet パッケージは Publisher.AppName 形式:
# install.ps1 - Install-WingetPackages 内
$packages = @(
"Microsoft.VisualStudioCode",
"Publisher.NewApp" # ← 追加
)
Brewfile の if OS.mac? ブロックに cask で追加。他プラットフォームへの追加は不要。
if OS.mac?
cask "raycast"
cask "karabiner-elements"
end
apt-packages.txt に1行追加apt.sh に install_xxx() 関数を追加Brewfile で Linux 専用の brew パッケージは条件付きで追加:
brew "xsel" if OS.linux? # clipboard support for Linux
install.ps1 の該当関数（Scoop or WinGet）に追加。
src/.config/mise/config.tomlsrc/.config/mise/config.personal.tomlsrc/.config/mise/config.work.tomlmise.toml(ルート)mise はプラットフォーム差を吸収するため、OS 固有の対応は不要。
注意: ルートの mise.toml はリポジトリ開発用。グローバルツールの追加先は src/.config/mise/ 配下の設定ファイル。
src/.config/mise/config.personal.toml に追加install.ps1 の Install-NpmPackages 内 $npmPackages 配列に追加# src/.config/mise/config.personal.toml
[tools]
"npm:@scope/package-name" = "latest"
# install.ps1 - Install-NpmPackages 内
$npmPackages = @(
"vercel",
"@google/gemini-cli",
"@new/package" # ← 追加
)
プラットフォームごとに名前・インストール方法が異なる:
Brewfile に cask "font-hackgen-nerd""Hack-NF"（nerd-fonts bucket が必要）apt-packages.txt に fonts-noto-cjkHackGen フォントは Windows では手動インストールが必要（Scoop に未登録）。
install.ps1 の Install-PowerShellModules 関数内に追加:
Install-Module -Name ModuleName -Scope CurrentUser -Force -AllowClobber
src/.vscode/extensions.json の recommendations 配列に追加:
{
"recommendations": [
"publisher.extension-id"
]
}
macOS/Linux は scripts/installers/vscode.sh、Windows は install.ps1 の Install-VSCodeExtensions がこのファイルを読む。
Personal パッケージ（--work フラグで除外される）の配置ルール:
if OS.mac? && ENV['WORK_MODE'] != 'true' ブロックinstall_xxx() 関数内で WORK_MODE チェックif (-not $Work) { $packages += "..." } ブロックif (-not $Work) { $packages += "..." } ブロックconfig.personal.toml（Work 時は config.work.toml が使用される）Personal パッケージ例: orbstack / spotify / discord / podman-desktop / AI CLI ツール。
--server フラグで GUI アプリをスキップ。以下が除外対象:
GUI アプリを追加する場合は、install.sh の SERVER_MODE チェック内に配置すること。
apt.sh で SERVER_MODE をチェックしている箇所: install_apt_packages（日本語環境）, install_podman（Podman Desktop）。
Brewfile: セクションコメントに合わせて適切な位置に挿入し、インラインコメントで用途を記述install.ps1: 該当関数内の $packages 配列に追加apt.sh: 既存の install_xxx() 関数パターンに従って関数を追加mise: 正しい設定ファイルに [tools] セクションで追加extensions.json: recommendations 配列に追加tap や Scoop bucket が必要かBrewfile への追加が必要か確認（CI/最小構成で必要なパッケージのみ）apt.sh の場合は関数本体と install.sh からの呼び出しの両方を削除extensions.json から VS Code 拡張を削除（該当する場合）tap / bucket があれば削除install.sh の main() から新規関数が呼び出されているか（Linux GUI アプリの場合）extensions.json に追加されているかtap / Scoop bucket が必要な場合、追加されているかmise.toml ではなく src/.config/mise/ 配下）SERVER_MODE チェックが入っているかjust lint
すべてのチェックが Passed になるまで修正を繰り返す。
変更後は sync-install-docs スキルも実行してドキュメントの整合性を確認すること。