helm-workflow-verify
/helm-workflow-verify
Weryfikuje po wdrożeniu pokrycie specyfikacji, poprawność, spójność projektu i dyscyplinę procesu, gdy zadania są zakończone.
- Autor
- Harry-Hz-Zhang ↗
- Repozytorium
- helm-workflow ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Weryfikuje po wdrożeniu pokrycie specyfikacji, poprawność, spójność projektu i dyscyplinę procesu, gdy zadania są zakończone.
Oryginalny opis (EN)
Post-apply verification — spec coverage, correctness, design consistency, process integrity (TDD, review, Reverse Sync, commits). Use when all tasks are marked complete.
Jak działa
- Overview
- When to Use
- When NOT to Use
- Process
- 外部验收(可选)
- Verification
- Red flags
Podgląd SKILL.md
---
name: helm-workflow-verify
description: Post-apply verification — spec coverage, correctness, design consistency, process integrity (TDD, review, Reverse Sync, commits). Use when all tasks are marked complete.
requires_skills:
- helm-workflow-router
- superpowers:verification-before-completion
---
# HELM Verify
## Overview
验证实现与 OpenSpec artifacts 一致,并拦截未 Reverse Sync 的偏差、缺失 TDD 证据或流程违规。
## When to Use
- `tasks.md` 全部 `[x]` 后、archive 前
- 用户要求完整性/正确性审计
## When NOT to Use
- 仍有未完成 task — 用 `helm-workflow-apply`
- 已知 Critical 且未 fix — 先 `helm-workflow-fix`
## Process
### S0 — 双模根解析(HARD-GATE,workbench 模式专属)
1. 调用 `resolveRoot()` 获取 `{ root, mode }`
- 解析契约见 `references/workbench-resolution.md`;**MUST NOT** 自行假设返回值或在失败时回退到当前目录。
2. `mode=workbench`:
- 记录每个业务仓 / 模拟服务仓的 `base_commit`(多仓 base_commit,用于 diff 验证)
- 仓本机路径经 `resolve(name)` 解析(权威来自 `.state/repos.links.yaml`,**MUST NOT** 从入库 manifest 读 `repo_path`)
- `resolve(name)` 的路径权威是本机 `.state/repos.links.yaml`;**MUST NOT** 从入库 `repos.manifest.yaml` 的 `repo_path` 读取。
- `git -C <resolve(name)> diff <base_commit>..HEAD` 逐仓验证
- `resolve(name)` 的路径权威是本机 `.state/repos.links.yaml`;**MUST NOT** 从入库 `repos.manifest.yaml` 的 `repo_path` 读取。
3. `mode=single-repo`(单库):保持今日行为(记录单仓 base_commit)
### S1 — 强制加载前置 skill
> **前置加载(HARD-GATE)**:MUST 用 Skill 工具实际加载 frontmatter `requires_skills` 的全部项(声明 ≠ 加载);
> MUST 在本阶段日志写入 `### Skills Loaded` 证据段,声明了但未列出的依赖判为未加载;
> 任一项加载失败 → 立即停止,不得降级继续。
> 路径基准:仓库根相对路径(见 `references/skill-loading-contract.md` 第 0 节)。
> 完整规则见 `references/skill-loading-contract.md`。
验证范围 / 准入门槛 / 报告格式以已加载的 `superpowers:verification-before-completion` 为唯一权威,本 SKILL 不重写其规则。
### S2 — 确定 change 与 diff
1. 确定 change;读取 `.helm-state.yaml`、proposal、specs、design、tasks、log
2. `git diff <base_commit>..HEAD`(stat + 全文)
3. **外部验收(MUST)**:读取 `.helm-state.yaml` 的 `external_verification`。`none` → 跳过;`required` → 检查 design 中的验收清单与执行记录,缺证据记 **Warning**,不单独判 Critical。
### S3 — 完整性验证
1. **完整性**:tasks 全完成;逐条 spec ✅/❌
### S4 — 正确性验证
1. **正确性**:意图匹配、边界、错误处理;🟡/🔴 有测试变更与最小闭环;DoD 与验证命令一致
### S5 — 一致性验证
1. **一致性**:与 design 对齐;偏离须有理由
### S6 — 流程完整性检查
1. **流程完整性**:串行 apply;双 review;无只改生产代码的 completed task;🟡/🔴 有 RED/GREEN/ASSERT;Reverse Sync 无遗漏;log 有 task 记录;design review 用 design-reviewer;main/master 有实现 → Critical;跳过 TDD 说法 → Critical
- **tasks 格式**:全部 task 须为行首 `- [x]`;若仍存在 `^- \[ \]` → Critical(未完成)
- **checkbox 协议**:若仅用 `### Task` / 行内 ``完成状态:`[ ]` `` 而无行首 checkbox → Critical(与 OpenSpec/HELM apply 不兼容)
- **commit 粒度**(standard):`base_commit..HEAD` commit 数与 `- [x]` task 数严重不符(如 9 个 task 仅 1 个实现 commit)→ **Warning**(流程债务);log 无 per-task TDD 段 → Critical(🟡/🔴)
- sprint:`sprint-state.json` checkpoints 数应与 completed task 一致(偏差 → Warning)
- **工程规范**:见下节「规范复核」(`db` / `api` 命中时逐条判)
### 规范复核(MUST)
先读 `log.md` 的 `### Convention Loaded` 段,再按命中项逐条判定。
| 命中 | 必查 | 缺证据时的等级 |
| --- | --- | --- |
| `db` | `docs/db/<领域>/<业务>.md` 存在;七列固定表;通用字段未混入文档;DDL 有 `COMMENT` / `utf8mb4` / 无 `FOREIGN KEY`;DO 继承 `BaseModel`;枚举类与文档一致;四层骨架齐全 | **Critical**(表结构与文档不一致属于交付物缺失,不是风格问题) |
| `api` | `### Apifox Sync` 段存在;六行(`preflight` / `schema` / `validate` / `readback` / `authorized` / `blocked`)齐全;变更表覆盖 diff 里的每个 `METHOD + PATH`;破坏性变更有授权 | **Critical**(契约漂移会让下游生成代码出错) |
| 明确 `n/a` | 理由成立(`api_contract: none`、无 `.apifox/settings.json`、CLI 不可用、本次无表结构或无契约面改动) | 理由不成立 → **Warning**;理由缺失 → **Critical** |
`db` / `api` 的判定口径以 `references/db-design-convention.md` 第 8 节与 `references/api-contract-convention.md` 第 7 节为准,本 skill 不复述规则。
### 证据归一化(MUST,先于一切判定)
先读取 `.helm-state.yaml` 的 `apply_mode` 与五个派生旗标(本文件只消费,不推导)。
读取 `log.md`,先把旧字面量归一化为结构块:
| 旧字面量 | 归一化为 |
| --- | --- |
| `### Build Evidence Task N` | `type: build`、`style: per-task`、`result` 由 `exit code` 推断 |
| `### 统一验证` | `type: unit`、`style: unified`、`scope: all` |
| `- 统一验证 UT: <cmd>` | `command: <cmd>` |
| `- 用例数: <n> passed, <m> failed` | `summary: Tests: <n> passed, <m> failed` |
| `- exit code: 0` | `result: pass`(非 0 → `fail`) |
| 代码块内 `$ <cmd>` | `command: <cmd>` |
| `Stage: code-quality` | 维度 `quality` |
归一化后,同一 task 同时存在新旧块 → 以新块为准(log 记 `evidence: legacy block superseded`)。
### 验证证据校验(MUST)
读取画像(`build_command` / `test_command` / `verification_types` / `require_tests_per_task`)与 state(`unifiedVerifyRequired` / `evidence_style` / `utDeferred`):
| 条件 | 要求 |
| --- | --- |
| `evidence_style: per-task` | 逐 task 检查 `### Verification Evidence Task N`(或归一化后的旧块);缺失 → Critical |
| `evidence_style: unified` | 必须存在 `### Verification Evidence Unified`(或 `### 统一验证`),且其 `type` MUST 属于 `verification_types` ∪ `{build}` |
| `build_command: null` | MUST NOT 因缺 `type: build` 判失败 |
| `require_tests_per_task: true` | 每个 `code`/`refactor` task MUST 有 `unit`/`integration`/`e2e`/`contract`/`snapshot` 之一 |
**判定规则**:
| # | 情形 | 结论 |
| --- | --- | --- |
| V1 | 有 `type: build` 的 `pass`,但无任何测试类证据,且 `require_tests_per_task: true` | **Critical**:编译通过不能替代测试 |
| V1b | `build_command: null` 且无 build 证据 | **NOT a finding**(不得报) |
| V2 | `result: pass` 但 `command` 为空或 `summary` 为空 | **Critical**:无命令/无摘要 |
| V3 | 测试类证据的用例数为 0(`0 passed` / `Tests: 0` / `no tests found`) | **Critical**:空跑 |
| V3b | 测试类证据 `summary` 不含任何数字 | **Critical**:无法判定 |
| V4 | 块标题被改写(`### 验证证据` / `## Verification Evidence` 等) | **Warning** → 视为缺失,按 V1 处理 |
| V5 | `utDeferred: true` 但某 task 声称已跑测试 | Warning:延迟模式下不应有 per-task 测试证据 |
| V6 | `result: skip` 但 `summary` 未写原因 | **Critical**:跳过得说明 |
| V7 | `type` 不在 `verification_types ∪ {build}` | Warning:视为缺失该类证据 |
| V8 | `artifacts` 指向的文件不存在 | Warning |
| V9 | `### Verification Evidence Unified` 缺 `- scope:` | Warning:无法判断该块覆盖哪些 task |
| V10 | `result: partial` 但 `summary` 未写"跳过项 + 原因" | **Critical**:partial 必须可解释 |
**`result: partial` 的判定**:视为**通过**,但 `summary` MUST 同时含跳过项与原因;缺任一 → 按 V10 判 Critical。
**v2 形态补充(MUST)**:`### Verification Evidence Task N` 存在但块内无任何测试类 `type`(只有 `build`)→ 按 **V1** 判 Critical(这是 V1 的 v2 形态,不得因为"有证据块"就放过)。
**commit 粒度判定修正**:当 `unifiedVerifyRequired: true` 时,`commit_hash` 为空**不是** Warning(turbo 本就零 commit)。
### 文本证据扫描(WARN 门禁)
对 `log.md` 执行字面量扫描,缺失项以 Warning 输出(不阻断,但必须列出):
- `### Skills Loaded`
- 以 `### Review Evidence` 开头的段(前缀匹配:`### Review Evidence` / `### Review Evidence Task N` / `### Review Evidence Batch` 任一即可)
- `### Verification Evidence` 或 `### Build Evidence Task` 或 `### 统一验证`
- `### Convention Loaded`
- `### Apifox Sync`(仅 `api` 命中时要求)
- `### Resolution`
`- exit code: 0` MUST NOT 单独作为"验证已执行"的证据(旧格式下它只是结果行之一,需与命令行配对)。
### S7 — 编译/测试
1. **编译/测试**:执行项目最小验证(命令来自仓内配置,如 `<build_cmd>` / `<test_cmd>`)
### S8 — 输出验证报告
1. 输出验证报告:完整性/正确性/一致性/流程/Critical/Warning/Suggestion/结论
2. 有 Critical → 用户选择 fix / apply / archive(不推荐);无 Critical → 提示 archive
## 外部验收(可选)
`.helm-state.yaml` 的 `external_verification` 决定是否接入外部验收流程:
| 值 | 行为 |
| --- | --- |
| `none`(默认) | 只用仓内测试与人工审查,不调用任何外部平台 |
| `required` | 按项目自建的外部验收清单执行,结论并入验证报告;缺证据记 Warning |
外部验收的失败不得直接判 Critical,除非 spec 明确写入。
## Verification
- [ ] 报告含 Critical 分级与结论
- [ ] base_commit 来自 state 或已说明
- [ ] 未在无证据时宣称可 archive
- [ ] `external_verification: none` 时报告不含外部验收小节
- [ ] `db` / `api` 命中时已按「规范复核」逐条判定,未用一句话代替
## Red flags
- 跳过流程完整性检查
- 有 Critical 仍建议直接 archive
- 未读 diff 即标 PASS
- `external_verification: none` 时仍调用外部验收平台
- 有建表改动但没打开 `docs/db` 文档就判"一致性通过"
- 有接口改动但没比对 `### Apifox Sync` 就判"契约一致"
Wersje
W bazie nie ma innych skilli o nazwie helm-workflow-verify.
Migawka bazy z 13.11.2026 · wersja paczki f21b35bf9006 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100helm-workflow-implement-task
Wdraża jedno zadanie HELM zgodnie z TDD i stylem kodu projektu, gdy etap apply przekaże je wykonawcy. - 90helm-workflow-fix
Naprawia krytyczne i ważne problemy po przeglądzie lub weryfikacji: najpierw synchronizacja wsteczna, potem poprawka testowana i dwa przeglądy. - 90openspec-verify-change
Sprawdza, czy implementacja zgadza się z artefaktami zmiany OpenSpec: zadania, pokrycie wymagań i spójność z projektem. - 90consistency-check
Sprawdza poprawność schematów artefaktów DAE i spójność specyfikacji z kryteriami akceptacji. - 100rpi-verify
Weryfikuje wdrożenie względem projektu i specyfikacji pod kątem kompletności, poprawności i spójności, z oceną wagi każdej uwagi. - 90tdd-workflow
Prowadzi znormalizowany cykl TDD: czerwony, zielony, refaktor i weryfikacja, z dbaniem o pokrycie testami i brak regresji.