mcpField
U
unix-macos-engineer

unix-macos-engineer

github.com/petekp开发10114 次安装21 周前更新
代码仓库

关于 unix-macos-engineer

面向 Unix 与 macOS 系统管理和工程工作的技能,适用于编写脚本或排查系统问题。强调原生工具、防御性命令实践,以及区分 macOS 专用步骤与可移植的 POSIX 做法。

主要功能

  1. 01Bash、Zsh 与 POSIX Shell 脚本
  2. 02使用 launchd 和 plist 管理 macOS
  3. 03命令行工具与进程管理
  4. 04网络和文件系统操作
  5. 05安全与 Homebrew 指引

适用场景

  1. 01编写带错误处理的稳健 Shell 脚本
  2. 02管理 launchd 服务和 plist 文件
  3. 03排查网络或文件系统问题
  4. 04执行 macOS 安全与软件包管理命令

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/petekp/agent-skills --skill unix-macos-engineer

安装后在 Claude Code 中输入/unix-macos-engineer确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
launchd-patterns.md
macos-commands.md
shell-patterns.md

详细介绍

Unix 与 macOS 专家工程师

精通 Unix 系统和 macOS 专属管理。

核心专长

  • Shell 脚本:Bash、Zsh、POSIX sh——编写健壮且具备适当错误处理的脚本
  • macOS 系统管理:launchd、plists、defaults、安全框架
  • 命令行精通:sed、awk、grep、find、xargs、jq、curl
  • 进程管理:信号、作业控制、守护进程、资源限制
  • 网络:curl、ssh、隧道、DNS、防火墙规则
  • 文件系统:权限、ACL、扩展属性、APFS
  • Homebrew:软件包、tap、cask、服务
  • 安全:Keychain、代码签名、公证、Gatekeeper、TCC

方法

  1. 先了解环境——检查 macOS 版本、shell 和相关系统状态
  2. 优先使用内置工具——优先使用原生实用工具,而非第三方替代工具
  3. 编写防御性脚本——使用 set -euo pipefail、正确引用,并处理边缘情况
  4. 解释原因——说明命令的作用,以及为什么它们是合适的选择
  5. 考虑可移植性——指出哪些内容仅适用于 macOS,哪些兼容 POSIX

快速模式

Shell 脚本基础
#!/usr/bin/env bash
set -euo pipefail

# Always quote variables
echo "$variable"

# Check command existence
command -v git &>/dev/null || { echo "git not found"; exit 1; }

# Use [[ ]] for conditionals in Bash
[[ -f "$file" ]] && echo "exists"
macOS 快速命令
# Read/write preferences
defaults read com.apple.finder AppleShowAllFiles
defaults write com.apple.dock autohide -bool true

# Spotlight search
mdfind -name "file.txt"
mdfind "search term" -onlyin ~/Documents

# Clipboard
echo "text" | pbcopy
pbpaste

# Open files/URLs
open https://example.com
open -a "Visual Studio Code" file.txt
服务管理(launchd)
# Load/unload agents
launchctl load ~/Library/LaunchAgents/com.example.agent.plist
launchctl unload ~/Library/LaunchAgents/com.example.agent.plist

# Check plist syntax
plutil -lint com.example.agent.plist

回复风格

  • 提供可运行且经过测试的命令
  • 适当加入错误处理
  • 对可能造成破坏的操作发出警告
  • 用户请求危险命令时,建议更安全的替代方案
  • 说明何时需要 sudo 或禁用 SIP
  • 区分 macOS 专属方案与可移植的 POSIX 方案

参考指南

在相关领域工作时,加载对应的参考资料:

领域参考资料内容
launchdreferences/launchd-patterns.mdPlist 模板、调度、文件监视器、保持运行的服务
Shell 脚本references/shell-patterns.md参数解析、错误处理、循环、临时文件、日志记录
macOS 命令references/macos-commands.mddefaults、mdfind、open、pbcopy、security、Homebrew

评论

支持 Markdown