homeassistant-ai/skills

Home Assistant Agent Skills – 它是什么

Home Assistant Agent Skills 是一个小型开源包，为 AI 编码助手（Claude Code、GitHub Copilot、Gemini CLI 等）提供技能。在 Agent Skills 生态系统中，技能是一个基于 Markdown 的知识包，助手可以在运行时加载并使用它来指导代码生成。这个特定的技能教助手编写 Home Assistant 自动化、仪表盘、备份、AppDaemon 应用等的最佳实践模式。

工作原理

安装 – 您使用 npx skills add homeassistant-ai/skills 命令（或通过 Claude Code 的插件市场）添加仓库。安装程序将技能文件复制到助手的技能目录中。
自动激活 – 安装后，每当助手被要求创建或编辑 Home Assistant 配置（自动化、脚本、仪表盘、蓝图等）时，它会自动查阅该技能。无需额外命令。
内容 – 技能的核心是 SKILL.md，其中包含决策工作流和“反模式”表，列出了常见错误（例如，在存在原生 numeric_state 条件时使用 Jinja 模板）以及正确的 Home Assistant 原生替代方案。支持参考文件（Markdown 和 YAML 示例文件）提供了关于触发器、助手、仪表盘、备份、AppDaemon 等的更深入指导。

您将获得什么

部分	提供内容
`SKILL.md`	高级工作流和陷阱与正确原生构造的快速参考表。
`references/…`	关于特定主题的详细 Markdown 指南 – 触发器、操作、助手选择、安全重构、仪表盘设计、AppDaemon、蓝图、备份等。
`examples.yaml`	现成的 YAML 片段，结合了多个最佳实践建议。

当 AI 助手遵循该技能时，例如，它会用原生 numeric_state 条件替换基于模板的条件，确保配置在 Home Assistant 加载时得到验证。

谁可能使用它

Home Assistant 开发者，他们依赖 AI 工具来搭建自动化或重构配置，并希望生成的代码遵循社区认可的模式。
AI 编码助手用户（Claude Code、Copilot、Gemini CLI 等），希望用领域特定的指导扩展助手的知识。
贡献者，希望为更广泛的 Agent Skills 生态系统添加或改进 Home Assistant 特定的技能。

开始使用

安装 Node.js 22.20+。
运行 npx skills add homeassistant-ai/skills（或通过 Claude Code 的插件命令安装）。
确保助手的“云代码执行”功能已启用（技能需要）。
让助手创建一个 Home Assistant 自动化 – 它将自动应用技能中的最佳实践规则。

许可证

MIT – 免费使用、修改和分享。