Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

czl-dev-gate

/czl-dev-gate

Prowadzi trzywarstwową weryfikację i bramkę wydania oprogramowania: plan wycofania, bezpieczeństwo migracji i notatki dostawy.

Repozytorium
czl-experts ↗
Licencja
MIT
Ostatnia zmiana repozytorium
01.11.2026

Ocena i bezpieczeństwo

100/ 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ść35 / 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
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 01.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

Prowadzi trzywarstwową weryfikację i bramkę wydania oprogramowania: plan wycofania, bezpieczeństwo migracji i notatki dostawy.

Oryginalny opis (EN)

Three-layer verification and release gate for shipping software. TRIGGER when: a feature is built and must be verified before release; release readiness must be judged; a rollback plan, migration safety check, or post-release watch list is needed; delivery notes must be written. DO NOT TRIGGER when: still writing the first slice, still freezing requirements, or doing exploratory work where nothing is meant to ship yet.

Jak działa

  1. 何时用
  2. 三层验证
  3. 上线闸门
  4. 判断条件
  5. 输出格式
  6. 与其他技能的关系
  7. 异常处理
Sekcje z nagłówków SKILL.md, w oryginale · 128 linii, 338 słów
Podgląd SKILL.md
---
name: czl-dev-gate
description: |
  Three-layer verification and release gate for shipping software.
  TRIGGER when: a feature is built and must be verified before release; release readiness must be judged;
  a rollback plan, migration safety check, or post-release watch list is needed; delivery notes must be written.
  DO NOT TRIGGER when: still writing the first slice, still freezing requirements,
  or doing exploratory work where nothing is meant to ship yet.
description_zh: "三层验证、上线闸门与回滚交付"
description_en: "Three-layer verification and release gate"
version: 1.0.0
license: "SEE LICENSE IN LICENSE"
metadata:
  category: development
  owner: 虫志龙
---

# 闸门:验证与上线

这一段只有一个目的:**在用户发现问题之前,先自己发现问题。**

它不负责让功能变好,只负责回答两个问题:能不能上?上了出事怎么退?

---

## 何时用

- 切片写完,要判断"算不算完成"
- 要上线,尤其是涉及数据迁移、支付、权限变更
- 已上线出问题,要回滚或热修
- 要交给别人维护,需要一份能照着跑的说明

---

## 三层验证

缺一层就不算验证过。三层的关系是**逐层加真实度**,不是三种可选方案。

### L1 · 单元与接口层

**验什么:** 单个函数/接口在边界值下的行为。

必测四类:

| 类别 | 用例 |
|---|---|
| 空 | 空字符串、空数组、null、未传字段 |
| 极端 | 超长文本、超大数值、负数、零 |
| 类型/格式 | 错误类型、非法字符、错位 JSON、错误时间格式 |
| 重复 | 同一请求连发两次、超时后重试 |

**证据:** 测试运行的输出,或一组 `curl` 的返回。

**不算通过的:** 只跑了 linter;只跑了 happy path;测试里全是 mock 的自言自语。

### L2 · 集成层

**验什么:** 和真实依赖一起跑一次。

- 真数据库(不是内存替身),跑一次迁移 + 一次完整读写
- 真第三方(用沙箱环境),走一次成功和一次失败分支
- 真文件系统 / 真队列,确认写入位置和消费行为

**证据:** 真实调用的日志片段(含时间与请求标识),或数据库查询结果。

**不算通过的:** 用 mock 返回固定值就宣布"集成没问题"。mock 通过只证明你的假设自洽。

### L3 · 端到端层

**验什么:** 按验收条目当用户走一遍。

- 从入口开始(页面登录 / 接口首次调用),不跳过中间步骤
- 每条验收条目走一次,附截图或命令输出
- 反例也走:越权访问、重复提交、中途退出

**证据:** 截图 / 录屏 / 命令输出,与条目编号一一对应。

**不算通过的:** "我自己点过一遍" —— 没有证据等于没有记录。

---

## 上线闸门

六项,缺一项就不该上。做不到的必须**在上线前明说**并给临时兜底。

| # | 项 | 合格线 | 做不到时 |
|---|---|---|---|
| 1 | 迁移可回退 | 有 down 脚本,或在接近生产数据量上试过 | 上线前手动全量备份,写明恢复步骤 |
| 2 | 备份可恢复 | 至少演练过一次恢复 | 上线前导出一份并核对条数 |
| 3 | 健康检查 | `/health` 与 `/ready` 能返回,失败能被监控抓到 | 至少保证有一个可探测的端点 |
| 4 | 错误可查 | 有 requestId,能从一条报错捞到完整链路 | 上线后前 24 小时人工盯日志 |
| 5 | 回滚可执行 | 命令写下来并真的执行过一次 | 不能上;没有回滚手段的上线不是上线 |
| 6 | 指标有阈值 | 知道错误率/延迟超过多少要停 | 定一个临时阈值,上线后补齐 |

第 5 条是硬线。**没有回滚方案的上线请求,应该被拒绝**,包括对自己的项目。

---

## 判断条件

| 情形 | 判断 | 动作 |
|---|---|---|
| L1 过、L2 没过 | 未验证 | 补集成验证,不许用"逻辑很简单"跳过 |
| 三层都过,但闸门缺 3 项 | 不可上线 | 补齐或降级为内部试用 |
| 只改前端文案 | 可简化 | L1 跳过,L3 走主链路一次 |
| 只改配置 | 需重启验证 | 验证启动成功 + 关键接口一次 |
| 数据迁移涉及删列 | 高风险 | 改成分步迁移,不在一批里删 |
| 上线后错误率超过阈值 | 立即回滚 | 先恢复,再排查,不在生产上调 |

---

## 输出格式

```
验证结论
L1 <项数> 条:通过 X / 不通过 Y / 未验证 Z(原因)
L2 <依赖列表>:通过 / 不通过 / 未验证
L3 验收条目:A1 通过、A2 通过、A3 未验证(缺账号)

闸门
1 迁移 2 备份 3 健康检查 4 错误可查 5 回滚 6 指标 —— 逐项 ✅ / ❌ + 一句说明

结论:可上线 / 有条件上线(条件:…) / 不可上线(原因:…)
```

"有条件上线"必须写清条件由谁满足、什么时候复核。含糊的"差不多可以上"不算结论。

---

## 与其他技能的关系

- `czl-dev-spec` 给出验收条目 → 这里逐条销号
- `czl-dev-build` 给出实现约定 → 这里检查是否守住
- 上线后发现问题 → 回到实现,修完重跑对应层,不跳层

---

## 异常处理

- **验证发现的是设计问题**(不是代码 bug):停下来回 `czl-dev-spec`,改条目再改代码,不要在实现层硬凑
- **上线后才发现没验的条目**:立即记录到交付说明的"未验"一节,不追补成"已通过"
- **回滚失败**:停止一切修复动作,先保住数据(读库、导表),再定位。修复顺序是"止血 → 恢复 → 查因"
- **无法验证的部分**(缺环境、缺账号、缺第三方沙箱):写清缺什么,交付时列为已知限制,不要用"应该没问题"填坑
Pliki w paczce (4)
  • SKILL.md 6 KB
  • references/三层验证清单.md 3 KB
  • references/上线与回滚.md 4 KB
  • templates/交付说明.md 1 KB

Wersje

W bazie nie ma innych skilli o nazwie czl-dev-gate.

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

  • 100czl-site-ship
    Sprawdza przed startem stronę, wdraża ją na hosting i obserwuje pierwsze 72 godziny z planem wycofania.
  • 90Release cut
    Uruchamia workflow wydania, śledzi go i sprawdza tag, notatki wydania oraz załączone artefakty.
  • 100release-readiness-protocol
    Sprawdza przed tagowaniem wersji metadane wydania, walidację, komendy publikacji i plan wycofania.
  • 90dev-release-check
    Sprawdza gotowość wydania: wersję, changelog, artefakty, testy dymne, plan wycofania i ryzyko.
  • 96god-ship
    Prowadzi bramkę wydania: wymaga świeżych testów i przeglądu, a potem prowadzi przez wdrożenie, wycofanie i notatki wydania.
  • 100release-checklist
    Generuje listę kontrolną walidacji przed wydaniem wersji oprogramowania, obejmującą weryfikację buildu, gotowość wdrożenia i ryzyko wydania.

Uwagi i zgłoszenia

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