用途：skill-hygiene 是面向智能体技能（agent skills）的治理顾问，帮助用户审计、评估、治理本地已安装或分发的技能，识别风险并给出改进建议，也可安全退役或事务化升级技能。
主要能力：通过只读收集脚本 bin/skill-scan.sh 采集结构化事实，再由 AI 结合用户上下文进行判断。扫描覆盖 frontmatter（name、description 及长度）、runtime_contract 三态加载证据、Claude Code 与 OpenAI 相关信号、内容哈希、新鲜度、来源信号、风险指标、同名冲突等。支持清理流程：review、plan、apply、status、undo，退役采用可恢复的隔离事务，需二次精确确认，并非删除。
使用方式：常规扫描运行 bash ~/.agents/skills/skill-hygiene/bin/skill-scan.sh [OPTIONS]，可选 --stale-days N、--json、--no-write、--skip-provenance-tree。人工终端清理使用 SKILLS_REFINER_NODE_BIN=/absolute/path/to/node24 bash ~/.agents/skills/skill-hygiene/bin/skills-refiner cleanup；非 TTY 或 Agent/IDE 流程改用 cleanup review/plan/apply/status/undo 的 JSON 命令，并配合 --retire-paths 或 --decisions。
适用场景：本地技能健康检查、清单盘点、治理分诊、单条技能安全退役、集合升级与运行时观察。
限制：变更目前仅支持 macOS 适配器且需 Node.js 主版本 24，首次编译原生助手还需 Apple Command Line Tools；Linux/Ubuntu 可审查但 plan/apply/status/undo 以退出码 3 失败关闭；Windows Git Bash 仅保留有界只读能力。扫描不提供运行时使用与效果质量数据，静态预检不等于原生加载通过。可执行清理计划上限为 8 项，更大子集需使用分区目录。退役载荷与事务记录位于 ~/.agents/skills-quarantine/transactions/。其他平台与收费信息暂未提供。