| name | beauty-salon-member-appointment |
| description | 美容院会员与预约：档案、储值、次卡、预约、技师推荐、完成服务（联动扣耗材与员工业绩）。触发：新客开卡/新客建档、查剩余次数、预约/改期/取消、安排技师（如“明天下午3点做面部护理”）。 |
会员与预约管理
SophAgent 适配说明
- 本 skill 已从 SophClaw 迁移到 SophAgent 内置 skill 目录。
- 支持文件按 SophAgent 规范存放：脚本在
scripts/，资料和 playbook 在 references/。
- 运行脚本前，优先在用户 workspace 中设置
BEAUTY_DB_PATH，例如 export BEAUTY_DB_PATH="$PWD/beauty-salon-suite/beauty.sqlite3"。
- 如果需要执行 Python 包脚本，先设置
PYTHONPATH="$PWD/scripts:$PYTHONPATH"，或将本 skill 的 scripts/ 内容复制到 workspace 后执行。
cd "{baseDir}"
export PYTHONPATH="$PWD/scripts:$PYTHONPATH"
python -m member_appt_cli <子命令> ...
默认库：$BEAUTY_DB_PATH；未设置时建议使用当前用户 workspace 下的 beauty-salon-suite/beauty.sqlite3。
完成服务编排 appt-complete
本仓库已升级为 单库 beauty.sqlite3：appt-complete 在同一个 SQLite 事务里完成扣款、扣库存、记业绩与更新预约状态；任一环节失败会整体回滚，不再出现“扣款成功但库存/业绩失败”的半成功状态。
内部子命令（供其他 skill）
card-count-by-service --service <名> --jsonappt-count-by-staff --staff-id <id> --status scheduled --json
示例
python -m member_appt_cli member-add --name "王芳" --phone "13800138000"
python -m member_appt_cli balance-recharge --member-id M001 --amount 1000 --bonus 150
python -m member_appt_cli appt-create --member-id M001 --project "面部护理" --technician-id S001 --datetime "2024-03-21 15:00"
python -m member_appt_cli appt-complete --appt-id A001 --pay stored_value
环境变量
BEAUTY_DB_PATH：单库路径（推荐）。默认：$BEAUTY_DB_PATH
