用途：homekit 是操作 HomeKit 的统一 CLI 与 MCP 服务器接口，配合 HomeClaw 完成 HomeKit 设置、只读检查、故障排查、显式配件控制与 webhook 等任务。除非用户明确要求离开该 CLI，否则应将其作为唯一 HomeKit 接口。
主要能力：支持家庭、房间、配件、场景、自动化、区域、事件日志、设备映射与异常调查等只读检查；在用户明确要求具体物理或结构变更时，可执行配件控制及房间、区域、场景、自动化的修改。
使用方式：采用渐进式披露，不记忆命令结构，按需查询帮助与模式：homekit --help、homekit <group> --help、homekit <command> --schema --format json、homekit --llms。解析或比较证据时用 --format json；在 MCP/工具调用前若参数名、输出字段或安全标志不确定，先用 --schema --format json。按请求加载对应参考文档：setup-and-troubleshooting.md、inspection-workflows.md、write-workflows.md、command-groups.md；需要确定性本地就绪检查时用 scripts/homekit-readiness.sh。默认流程为先检查 HomeClaw 就绪（homekit bridge setup --format json、homekit status --format json），再用只读命令建立上下文，缩小到精确 ID，写入前检查命令模式，写入后用最窄的相关读取与近期事件验证。
限制与安全规则：锁、车库门、大门、门窗、遮盖物、安防系统、摄像头、门铃、占用、存在、场景与自动化均视为安全关键。不得仅为测试连通性而控制设备；未经用户要求精确物理状态变更，不得使用 --allow-actuation；未经用户要求精确 HomeKit 结构变更，不得使用 --allow-mutation；禁止通配符写入，必须先将名称解析为精确 ID；多个匹配项时展示候选并请用户选择。写入后需报告命令族、目标名称/ID、请求值/变更、验证结果及返回的 auditId。结构变更风险不明时优先禁用而非删除。其他收费、平台与效果信息暂未提供。