nixkits-skills

NixKits 技能安装器

将 NixKits 技能安装到各编码助手的技能目录中。

支持的助手

助手	技能目录
OpenCode	~/.opencode/skills/
CodeWhale	~/.codewhale/skills/
Codex	~/.codex/skills/
OpenClaw	~/.openclaw/skills/
通用	~/.agents/skills/

dsh 例外：DeepSeek Harness 不再是安装目标。其 NixOS 场景能力（shell 执行、工具引导、sudo 守护、NixOS 诊断）已整合进 nixos-shell 插件（@kihara777/dsh-nixos-shell），经 nixkits.dsh.plugins.packages 声明式挂载。

可用的技能

自动从 skills/*/SKILL.md 的 frontmatter 中提取：

for skill in skills/*/SKILL.md; do
  name=$(grep '^name:' "$skill" | sed 's/name: *//')
  desc=$(grep '^description:' "$skill" | sed 's/description: *//')
  echo "| $name | $desc |"
done

技能列表不应硬编码；每次执行时从当前 skills/ 目录动态生成。

安装模式

模式 1：本地安装（从 NixKits 源码）

当用户已位于 NixKits 源码目录内时：

# 自动发现源码目录
NIXKITS_DIR=$(pwd)
# 或从 flake.nix 推断：
[ -z "$NIXKITS_DIR" ] && NIXKITS_DIR=$(dirname "$(readlink -f flake.nix)" 2>/dev/null)

# 将技能复制到各已存在的助手目录
for dir in ~/.opencode/skills ~/.codewhale/skills ~/.codex/skills ~/.openclaw/skills ~/.agents/skills; do
  if [ -d "$dir" ]; then
    cp -r "$NIXKITS_DIR/skills/"* "$dir/"
    echo "Installed to $dir"
  fi
done

模式 2：在线安装（从 GitHub）

当本地没有 NixKits 源码时：

# 自动发现远程仓库 URL
REPO_URL=$(git remote get-url origin 2>/dev/null || echo "")
# 克隆到临时目录
TMPDIR=$(mktemp -d)
git clone ${REPO_URL:-https://github.com/Kihara777/NixKits.git} "$TMPDIR"

# 从克隆的源码安装
for dir in ~/.opencode/skills ~/.codewhale/skills ~/.codex/skills ~/.openclaw/skills ~/.agents/skills; do
  if [ -d "$dir" ]; then
    cp -r "$TMPDIR/skills/"* "$dir/"
    echo "Installed to $dir"
  fi
done

rm -rf "$TMPDIR"

检查更新

安装前，将本地技能与源码对比：

# 本地模式：与源码对比
NIXKITS_DIR=$(pwd)
for skill_dir in "$NIXKITS_DIR/skills/"*/; do
  skill_name=$(basename "$skill_dir")
  for agent_dir in ~/.opencode/skills ~/.codewhale/skills ~/.codex/skills ~/.openclaw/skills ~/.agents/skills; do
    if [ -d "$agent_dir/$skill_name" ]; then
      if ! diff -rq "$skill_dir" "$agent_dir/$skill_name" > /dev/null 2>&1; then
        echo "Update available: $skill_name in $(basename $(dirname $agent_dir))"
        echo "  Source: $skill_dir"
        echo "  Target: $agent_dir/$skill_name"
      fi
    fi
  done
done