Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

helm-workflow-fix

/helm-workflow-fix

Naprawia krytyczne i ważne problemy po przeglądzie lub weryfikacji: najpierw synchronizacja wsteczna, potem poprawka testowana i dwa przeglądy.

Repozytorium
helm-workflow ↗
Licencja
MIT
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Naprawia krytyczne i ważne problemy po przeglądzie lub weryfikacji: najpierw synchronizacja wsteczna, potem poprawka testowana i dwa przeglądy.

Oryginalny opis (EN)

Targeted fix after review or verify — Reverse Sync first, then TDD fix and dual review. Use when Critical/Important issues remain post-apply.

Jak działa

  1. Overview
  2. When to Use
  3. When NOT to Use
  4. Process
  5. Verification
  6. Red flags
Sekcje z nagłówków SKILL.md, w oryginale · 113 linii, 502 słów
Podgląd SKILL.md
---
name: helm-workflow-fix
description: Targeted fix after review or verify — Reverse Sync first, then TDD fix and dual review. Use when Critical/Important issues remain post-apply.
requires_skills:
  - helm-workflow-router
  - helm-workflow-reverse-sync
  - helm-workflow-git-discipline
  - superpowers:test-driven-development
  - systematic-debugging
  - superpowers:subagent-driven-development
---

# HELM Fix

## Overview

承接 review/verify 结论做**定向修复**:先 Reverse Sync,再 TDD 改代码,双阶段 review,单 fix commit。不得扩展为新的大规模 apply。

## When to Use

- `/helm-workflow-verify` 报告 Critical/Important
- apply 阶段 review 未通过且需定向修补
- 用户给出明确 issue summary

## When NOT to Use

- 全新功能实现 — 回到 `helm-workflow-apply` 或更新 tasks 后 apply
- 未确定修复目标时直接改代码

## Process

### S0 — 双模根解析(HARD-GATE,workbench 模式专属)

1. 调用 `resolveRoot()` 获取 `{ root, mode }`
   - 解析契约见 `references/workbench-resolution.md`;**MUST NOT** 自行假设返回值或在失败时回退到当前目录。
2. `mode=workbench`:
   - Reverse Sync 改 `<root>/.openspec/changes/<name>/`(及必要时 feature 级 `outline-design.md`)
   - 禁止改错根(MUST NOT 改业务仓 openspec)
3. `mode=single-repo`(单库):
   - Reverse Sync 改 `<cwd>/.openspec/changes/<name>/`(今日行为)
   - 保持今日行为

### S1 — 强制加载前置 skill

> **前置加载(HARD-GATE)**:MUST 用 Skill 工具实际加载 frontmatter `requires_skills` 的全部项(声明 ≠ 加载);
> MUST 在本阶段日志写入 `### Skills Loaded` 证据段,声明了但未列出的依赖判为未加载;
> 任一项加载失败 → 立即停止,不得降级继续。
> 路径基准:仓库根相对路径(见 `references/skill-loading-contract.md` 第 0 节)。
> 完整规则见 `references/skill-loading-contract.md`。
   TDD / Reverse Sync / systematic-debugging 等约束以已加载的对应 skill 为唯一权威,本 SKILL 不重写其规则。

### S1.5 策略继承与差异

fix **继承** `helm-workflow-apply` 的全部策略与门禁,仅以下三处不同:

| 维度 | apply | fix |
| --- | --- | --- |
| 审查强度 | 按色标(🟢 可跳过) | **至少 1 次独立审查,无论色标**(含 turbo) |
| 审查范围 | 当前 task / 累计 | 本次修复的 diff |
| 审查时机 | 编译前 | 编译前(turbo 也必须在编译前审一次) |

其余一致:`apply_mode` 派生(S1.3)、延迟策略(S3.5)、统一验证(S6.8)、`### Skills Loaded` 证据、`target_repos` 闸门、收口顺序(构建 → 统一验证 → 勾选 → commit)。

**工程规范**:apply 的 S1.4(规范加载)与 S6 第 2.5 步(规范闸门)在 fix 中原样继承。修复内容涉及表结构或接口契约时,MUST 先读 `references/db-design-convention.md` 或 `references/api-contract-convention.md`,并在 `log.md` 的 `### Convention Loaded` 段记录;规范闸门未通过时同样不得 commit。

**Reverse Sync**:若修复过程中发现 specs/design 与代码事实不符 → 必须先走 `helm-workflow-reverse-sync`(本文件 S5),并在 `tasks.md` 的对应 task 补 `files:` 字段。


### S2 — 分支门控与问题定位

1. 分支门控:参考 `helm-workflow-git-discipline` Branch Confirm 子流程;master/main 上必须由用户确认(接受 `feature/<change-name>` / 自定义 / 取消),禁止静默硬停
2. 确定 change 与问题来源(用户摘要 > 会话 review > `log.md`)

### S3 — 读取 artifacts

1. 读取 proposal、specs、design、tasks、log、`.helm-state.yaml` 与宿主 templates

### S4 — Commit 策略加载

1. **Commit 策略加载(MUST)**:按 `helm-workflow-apply` S1 步骤 3 读取 `auto_commit`(缺省 `false`)并按 `apply` S1.3 派生五个旗标,同时持久化 `commit_message_guidance`(缺省 `""`)到 `.helm-state.yaml.runtime`

### S5 — Reverse Sync

1. **Reverse Sync(改代码前,MUST)**:
   a. 定位问题涉及的文件列表
   b. 逐一对照 `tasks.md` 的 `files:` 清单 — 任一修复文件不在列表中 → **先更新 `tasks.md` 补充该文件**,再改代码
   c. 检查 `specs/` 是否覆盖本次修复范围 — 宏观描述足够则不改 spec,细节遗漏则补充
   d. 回写 `log.md` 记录 RS 决策(补充了哪些 artifact、为什么 spec 不需要改)
   e. 纯实现缺陷(artifact 已覆盖但代码实现有误)也须在 log 记录依据,无 RS 时明确标注 `reverse_sync: not required`

### S6 — 更新 state

1. 更新 state:`current_phase: fix`,`active_review_stage: reverse_sync`

### S7 — 定向实现

1. **定向实现**:仅 issue 范围;TDD RED/GREEN/REFACTOR 证据;超范围则先更新 tasks + log

### S8 — 双 review

1. **双 review**:spec reviewer → code quality reviewer;🔴 task MUST 派 design-reviewer 预审 artifacts;reviewer 默认复用 implementer 的 RED/GREEN/build 证据(缺失、未覆盖、代码已变或高风险路径除外)

### S9 — 收口与 commit

1. 通过后:tasks(若适用)→ log → state → 最小验证 → **commit gate 强制重读**:主会话再次读 `.helm-state.yaml.runtime` 取 `effectiveAutoCommit` / `autoCommitForcedOff` 与 `commit_message_guidance`,按 `effectiveAutoCommit` / `autoCommitForcedOff` 收口:`false` 时不触发 git 操作、不提示用户 commit、不校验工作区,由用户自行决定 commit 时机;`true` 时**主会话自行**根据 `git diff --cached` + issue 摘要 + `commit_message_guidance`(非空遵原文约束,空时自由生成)生成 message 并 `git commit`,子代理不参与 message 生成。既有验证证据仍有效时可复用;禁止自动 push

### S10 — 下一步建议

1. 建议下一步:继续 fix / verify / archive

## Verification

- [ ] Reverse Sync 先于编码(MUST 执行 S5 a-e 全流程)
- [ ] 修复文件与 tasks.md `files:` 列表一致(S5 证据段通过)
- [ ] 双 review 无 Critical/Important/DESIGN_ISSUE 遗留
- [ ] 有 TDD 证据与最小验证记录

## Red flags

- 只修不审
- 跳过 S5 Reverse Sync 直接改代码
- 修复文件不在 tasks.md `files:` 中但未回写
- fix 演化为多 task 并行大改

Wersje

W bazie nie ma innych skilli o nazwie helm-workflow-fix.

Migawka bazy z 13.11.2026 · wersja paczki cf0831580290 (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

  • 90helm-workflow-verify
    Weryfikuje po wdrożeniu pokrycie specyfikacji, poprawność, spójność projektu i dyscyplinę procesu, gdy zadania są zakończone.
  • 100helm-workflow-archive
    Archiwizuje zmianę OpenSpec po pomyślnej weryfikacji, a potem proponuje opcje zakończenia gałęzi.
  • 100review-loop
    Prowadzi wielorundowy przegląd zmian przez niezależnych recenzentów, aż nie zostaną krytyczne ani istotne problemy.
  • 100pr-fix
    Automatycznie naprawia wszystkie problemy wskazane w raporcie ze skilla pr-review, po poleceniu /pr-fix lub po otrzymaniu uwag z przeglądu.
  • 100review-hamster
    Przegląda kod w dwóch przejściach: najpierw krytyczne problemy blokujące wdrożenie, potem sugestie informacyjne, a poprawki wprowadza po akceptacji użytkownika.
  • 95fix
    Naprawia jeden błąd z tablicy bez iteracji: najpierw test, który nie przechodzi, potem najmniejsza poprawka i jeden pull request.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.