From workflow-skills
Reviews Home Assistant integration code for PR preparation, checking Quality Scale rules, code style, Config Flow, test coverage, and docs via parallel agents.
npx claudepluginhub niracler/skill --plugin workflow-skillsThis skill uses the workspace's default tool permissions.
以最严格的 Home Assistant Reviewer 视角审查集成代码。
Manages Home Assistant YAML configurations: editing configuration.yaml, integrations setup, secrets management, packages organization, and troubleshooting errors.
Guides Home Assistant best practices for automations, helpers, scripts, dashboards, device controls, entity renaming, and Zigbee integrations over templates and raw YAML.
Reviews and verifies code before merge via triage-first checks (up to 16 parallel agents). Pipeline mode verifies vs plans; general mode for PRs/branches/staged changes. Flags findings only.
Share bugs, ideas, or general feedback.
以最严格的 Home Assistant Reviewer 视角审查集成代码。
| Tool | Type | Required | Install |
|---|---|---|---|
| git | cli | Yes | brew install git or git-scm.com |
| gh | cli | No | brew install gh then gh auth login (for referencing other integrations) |
| Context7 MCP | mcp | No | npx -y @upstash/context7-mcp — add to Claude Code MCP settings (for HA developer docs) |
Do NOT proactively verify these tools on skill load. If a command fails due to a missing tool, directly guide the user through installation and configuration step by step.
# 获取待审查的文件(ha-core 使用 dev 分支)
git diff --name-only HEAD~1 # 最近一次提交
git diff --name-only dev # 与 dev 分支的差异(ha-core 主分支)
或用户指定的目录/文件。
使用 Task 工具并行启动多个专项检查,详见 review-workflow.md。
其他 Agent 环境:以下检查相互独立,可按顺序依次执行。
Agent 1: Quality Scale 规则检查
Agent 2: 代码风格检查
Agent 3: Config Flow 检查
Agent 4: 测试覆盖检查
Agent 5: 文档与 Manifest 检查
所有检查完成后,汇总结果生成统一报告。
不要使用过时的静态文档,每次审查时动态获取:
WebFetch: https://raw.githubusercontent.com/home-assistant/developers.home-assistant/refs/heads/master/docs/core/integration-quality-scale/rules/{rule_name}.md
其他环境:
curl -sL <URL>作为替代。
WebFetch: https://raw.githubusercontent.com/home-assistant/core/dev/.github/copilot-instructions.md
其他环境:
curl -sL <URL>作为替代。
使用 Context7 获取最新的 Home Assistant 开发者文档。
若未安装 Context7 MCP,从 GitHub 仓库直接获取:
curl -sL https://raw.githubusercontent.com/home-assistant/developers.home-assistant/refs/heads/master/docs/...
查看 ha-core 中类似集成的实现:
gh api repos/home-assistant/core/contents/homeassistant/components/{integration_name}
输出结构化报告,包含:
详见 common-issues.md,包含:
ha-core 仓库提供了专门的 Quality Scale 验证 agent:
位置: repos/ha-core/.claude/agents/quality-scale-rule-verifier.md
调用方式:
# 验证单个规则
"Check if the {integration} integration follows the {rule_name} rule"
# 验证整个等级
"Verify that this integration reaches the {tier} quality scale"
该 agent 会动态获取规则文档并验证实现,比静态检查更准确。
验证代码是否真正符合规则要求,而非仅仅标记为 done。
检查是否接近完成,提示用户考虑完成以提升 Quality Scale 等级。
评估豁免理由是否合理,是否真的不适用于该集成。
gather 替代循环中的 awaitServiceValidationError 处理输入错误HomeAssistantError 处理通信故障tests/components/{domain}/