القائمة
Activate after every code change to verify all documentation files that describe the changed behaviour are updated and consistent with the implementation.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Activate at the start of any code change to ensure canonical helpers and patterns are used instead of re-implementing them inline.
Activate before every commit and PR to run the full HSEM quality gate pipeline — lint, typing, quality checks, and tests.
Activate when making changes that touch Home Assistant integration surfaces — config flows, entities, translations, services, device info, async patterns, or platform setup.
Activate when writing or reviewing Home Assistant integration code to ensure Bronze and Silver quality tier standards — HA constants, entity patterns, coordinator usage, config flow, and async correctness.
Activate when adding, modifying, or using any Huawei Solar inverter/battery sensor entity in HSEM. Follow the full wiring protocol from const.py through coordinator.py.
Activate when making any change to the HSEM planner layer — engine, cost function, SoC simulation, candidate generation, slot population, MILP optimizer, or safety gates.
| name | hsem-doc-sync |
| description | Activate after every code change to verify all documentation files that describe the changed behaviour are updated and consistent with the implementation. |
Activate this skill after making code changes and before opening a PR. Stale documentation causes confusion and bugs — every doc that describes changed behaviour must be updated in the same PR.
When behaviour changes, check every file below. If it describes something you changed, update it:
| File | When to check |
|---|---|
docs/planner-guide.md | Planner inputs, outputs, cost function, or scenarios changed |
docs/planner-spec.md | Planner semantics, invariants, formulas, or safety gates changed |
docs/config-flow-reference.md | Config/options flow steps changed |
docs/ev-charge-plan-setup.md | EV planned load setup changed |
docs/huawei_entities.md | New Huawei entities wired or existing ones changed |
.github/memories.md | Canonical patterns, module map, open issues, or architectural decisions changed |
README.md | User-facing features, descriptions, or links changed |
translations/en.json | Any user-facing string added, changed, or removed |
docs/planner-spec.md and the planner implementation must never diverge silentlytranslations/en.jsonhuawei_solar fields: update both config.step.huawei_solar and options.step.huawei_solarBefore opening a PR:
docs/planner-spec.md consistent with planner implementation.github/memories.md module map matches current file layouttranslations/en.json has entries for all new/changed user-facing stringsdocs/planner-spec.mddocs/config-flow-reference.mdREADME.mdtranslations/en.jsondocs/huawei_entities.md.github/memories.md