用途：Shaon 是面向 shaon 仓库与二进制的 Claude Code 技能，用于在用户本人的 Hilan 账户上处理个人考勤、工资单、薪资及相关自助任务。触发场景包括 shaon、考勤、上下班打卡、工资单等。
主要能力：优先使用已覆盖该领域操作的 MCP 服务器，本地或交互式操作回退到 CLI，如 auth、payroll payslip view、reports show、cache refresh attendance-types、serve、completions。MCP 工具覆盖 shaon_status、shaon_errors、shaon_types、shaon_clock_in、shaon_clock_out、shaon_fill、shaon_auto_fill、shaon_resolve、shaon_payslip_download、shaon_salary、shaon_sheet、shaon_corrections、shaon_absences、shaon_overview。
使用方式：首次需创建 ~/.shaon/config.toml，填写 subdomain、username，可选 payslip_folder、payslip_format，然后运行 shaon auth；凭据过期可用 shaon auth --force-prompt。仓库检出时用 scripts/run.sh <command> [args]，全局安装后用 shaon <command> [args]。读取命令如 shaon attendance overview --json、attendance status --month YYYY-MM、attendance errors、attendance types、attendance absences、reports sheet、reports corrections、reports show <name>、payroll payslip download/view、payroll salary --months N。写入命令如 attendance report today --in/--out、report day、report range、auto-fill、resolve。
安全模型：所有写入默认仅预览，须先运行 --dry-run 并向用户展示预览，用户明确确认后才能用 --execute 重跑，禁止自主执行写入。report range 与 auto-fill 默认跳过周五周六，auto-fill 默认上限 --max-days 10。
限制：CAPTCHA 需用户在浏览器先解决；类型解析失败可运行 shaon cache refresh attendance-types 或直接传数字类型码；payroll payslip password --force-sensitive-output 会明文输出当前 Hilan 账户密码，且不恢复历史密码，仅应在可控的私有交互终端运行。