AgentSkillsCN

launchd-manage スキル

auto-sync launchd管理。检查、启动、停止和查看dotfiles自动同步状态。触发器：launchd、auto-sync、自动同步、同步、sync agent

SKILL.md
--- frontmatter
description: "auto-sync launchd管理。dotfiles自動同期の状態確認・起動・停止・ログ確認。トリガー: launchd, auto-sync, 自動同期, 同期, sync agent"
allowed-tools:
  - Bash
  - Read
  - Grep

launchd-manage スキル

dotfiles自動同期のlaunchdエージェント管理を行う。

概要

auto-syncは毎時dotfilesの変更をGitHubに自動同期するlaunchdエージェント。

  • •plistファイル: ~/Library/LaunchAgents/com.user.dotfiles-sync.plist
  • •実行スクリプト: /Users/snkrheadz/ghq/github.com/snkrheadz/laptop/scripts/auto-sync.sh
  • •ログファイル: ~/Library/Logs/dotfiles-sync.log
  • •実行間隔: 3600秒（1時間）

コマンド

エージェント状態確認

bash
launchctl list | grep dotfiles

plistファイル確認

bash
cat ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

自動同期スクリプト確認

bash
cat /Users/snkrheadz/ghq/github.com/snkrheadz/laptop/scripts/auto-sync.sh

ログ確認

bash
cat ~/Library/Logs/dotfiles-sync.log | tail -50

最新のログエントリ

bash
tail -20 ~/Library/Logs/dotfiles-sync.log

エージェント停止

bash
launchctl unload ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

エージェント起動

bash
launchctl load ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

エージェント再起動

bash
launchctl unload ~/Library/LaunchAgents/com.user.dotfiles-sync.plist && \
launchctl load ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

手動で同期実行

bash
/Users/snkrheadz/ghq/github.com/snkrheadz/laptop/scripts/auto-sync.sh

plistのシンタックスチェック

bash
plutil -lint ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

plistファイル構造

xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "...">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.user.dotfiles-sync</string>
  <key>ProgramArguments</key>
  <array>
    <string>/path/to/auto-sync.sh</string>
  </array>
  <key>StartInterval</key>
  <integer>3600</integer>
  <key>StandardOutPath</key>
  <string>~/Library/Logs/dotfiles-sync.log</string>
  <key>StandardErrorPath</key>
  <string>~/Library/Logs/dotfiles-sync.log</string>
</dict>
</plist>

実行フロー

状態確認

  1. •launchdエージェントの稼働状態確認
  2. •plistファイルの存在確認
  3. •最新のログエントリを表示

トラブルシューティング

  1. •エージェント状態確認
  2. •ログを確認して最後の実行結果を調査
  3. •手動実行でスクリプトの動作確認
  4. •必要に応じてエージェント再起動

使用例

  • •"auto-syncの状態を確認"
  • •"自動同期のログを見せて"
  • •"auto-syncを再起動"
  • •"自動同期を一時停止"
  • •"手動で同期を実行"

auto-sync.shの動作

  1. •dotfilesディレクトリに移動
  2. •brew bundle dump --force でBrewfile更新
  3. •git add -A で変更をステージ
  4. •変更がある場合のみコミット
  5. •リモートにプッシュ

注意事項

  • •エージェント停止中は自動同期されない
  • •手動同期は scripts/auto-sync.sh で実行可能
  • •ログが肥大化したら手動で削除可能
  • •ネットワーク接続がない場合、プッシュは失敗する（次回実行時に再試行）