ha直接访问--家庭助理Claude Skill
适用于使用Desktop Commander的claude.ai用户。 不是克劳德代码技能。不是MCP服务器。没有额外的基础设施。
让Claude直接、自主地访问您的Home Assistant实例-读取和编辑配置文件、调用REST API、重新加载自动化、运行CLI命令和执行QA检查-所有这些都可以在Claude.ai聊天中进行，而无需接触终端。
______________________________________________________________________
这是给谁的
这项技能是专门为 claude.ai项目用户 拥有 桌面指挥官 作为MCP服务器连接。
如果是你，这项技能使Claude能够完全访问HA，而无需额外的基础设施。
______________________________________________________________________
它与其他事物有何不同
| 此技能 | Claude代码技能 | HA MCP服务器（官方） | HA MCP | |
|---|---|---|---|---|
| 接口 | claude.ai web/app | 克劳德代码CLI | 克劳德桌面 | 克劳德台式机/API |
| 需要克劳德代码 | ❌ 否 | ✅ 是 | ❌ 否 | ❌ 没有 |
| 需要HA上的服务器 | ❌ 否 | ❌ 否 | ✅ 是 | ✅ 是的 |
| 需要额外的基础设施 | ❌ 否 | ❌ 否 | ✅ mcp代理 | ✅ Docker/插件 |
| 直接编辑配置文件 | ✅ 是 | ✅ 是 | ❌ 否 | ❌ 没有 |
| claude.ai项目中的作品 | ✅ 是 | ❌ 否 | ❌ 否 | ❌ 没有 |
| 自我更新技能档案 | ✅ 是 | ❌ 否 | ❌ 否 | ❌ 没有 |
这填补了空白： 每个现有的解决方案都需要Claude Code（一个单独的付费CLI工具）或在您的网络上运行的自定义MCP服务器。此技能适用于您已经使用的Claude.ai界面，使用Desktop Commander（许多Claude.ay用户已经拥有）和Python paramiko 库直接SSH到HA。没有其他需要。
______________________________________________________________________
克劳德能用这个技能做什么
- ✅ 编辑
automations.yaml,scripts.yaml,configuration.yaml直接 - ✅ 重新加载自动化、脚本、模板、HomeKit Bridge——无需完全重启
- ✅ 在关闭任何任务之前，运行配置有效性检查并扫描修复
- ✅ 使用跟踪和HA日志调试自动化
- ✅ 调用任何HA REST API服务
- ✅ 查询实体状态
- ✅ 随着设置的发展，更新和重新打包技能本身
______________________________________________________________________
先决条件
- claude.ai Pro （需要项目）
- 桌面指挥官 作为MCP服务器连接→ 桌面命令应用程序
- Python 3+paragraphy 在本地计算机上(
pip3 install paramiko) - HA SSH和终端插件 在Home Assistant中安装并运行
- HA长期访问令牌 （在您的HA配置文件中创建）
- 上下文7 MCP （可选但推荐——防止弃用YAML语法）
完整的设置说明： 设置.md
______________________________________________________________________
快速开始
# 1. Clone the repo
git clone https://github.com/Bank1824/ha-direct-access-skill.git
cd ha-direct-access-skill
# 2. Configure with your HA details
chmod +x ha-direct-access/configure.sh
./ha-direct-access/configure.sh
# 3. Package the skill
python3 -c "
import zipfile, os
zf = zipfile.ZipFile('ha-direct-access.skill', 'w', zipfile.ZIP_DEFLATED)
[zf.write(os.path.join(r,f), os.path.relpath(os.path.join(r,f), '.')) for r,d,files in os.walk('ha-direct-access') for f in files]
zf.close()
print('Done: ha-direct-access.skill')
"
# 4. Install
# Upload ha-direct-access.skill to claude.ai → Settings → Skills______________________________________________________________________
保持技能与时俱进
该技能旨在随着您的设置而发展。当您与Claude一起处理HA任务时，您将发现新的实体ID、模式和陷阱。在每节课结束时，问克劳德：
*“用我们今天发现的任何新技能进行更新，并重新打包。”*
克劳德将编辑 SKILL.md 在您的机器上重新生成 .skill 文件自动。通过设置重新安装→ 技能。
这 SKILL.md 在你的机器上是真理的源泉。克劳德在每次会议开始时都会阅读它。
______________________________________________________________________
回购结构
ha-direct-access-skill/
├── README.md
└── ha-direct-access/
├── SKILL.md ← The skill (configure before installing)
├── SETUP.md ← Full prerequisites and setup guide
└── configure.sh ← Interactive config script______________________________________________________________________
贡献
欢迎捐款。如果你发现了值得分享的模式、陷阱或实体结构，请打开一个PR SKILL.md目标是掌握一种技能，涵盖最常见的开箱即用的HA设置，并为设置特定的细节提供清晰的扩展模式。
______________________________________________________________________
许可证
麻省理工学院