Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

loom-requesting-code-review

/loom-requesting-code-review

Przygotowuje prośbę o recenzję kodu z podsumowaniem zmian, wynikami samodzielnych testów i obszarami uwagi dla recenzentów.

Repozytorium
loom ↗
Licencja
MIT
Ostatnia zmiana repozytorium
18.10.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Przygotowuje prośbę o recenzję kodu z podsumowaniem zmian, wynikami samodzielnych testów i obszarami uwagi dla recenzentów.

Argumenty

/loom-requesting-code-review <spec_dir or PR context>
Oryginalny opis (EN)

Prepare a code review request with change summary, self-test results, and focus areas for reviewers. Use when: verified changes are ready for reviewer handoff or a PR needs a review request summary.

Jak działa

  1. 触发条件
  2. 完成条件与下一步
  3. 预审查清单
  4. 执行流程
  5. 约束
Sekcje z nagłówków SKILL.md, w oryginale · 168 linii, 371 słów
Podgląd SKILL.md
---
name: loom-requesting-code-review
description: >
  Prepare a code review request with change summary, self-test results, and focus areas for reviewers.
  Use when: verified changes are ready for reviewer handoff or a PR needs a review request summary.
when_to_use: Prepare a review request after verification, including change summary, tests, and reviewer focus areas.
argument-hint: <spec_dir or PR context>
user-invocable: true
---

# 请求代码审查

## 触发条件

- verification-before-completion 通过后,需要人工代码审查时
- 用户主动要求发起代码审查
- 分支开发完成、准备合并前

## 完成条件与下一步

- Spec 遗漏自审已完成(或已写明跳过原因),遗漏 blocker 已修复
- 审查请求已生成并发送
- 下一步:等待审查反馈 → 使用 `loom-receiving-code-review` 处理反馈

## 预审查清单

在请求审查前,确保:

- [ ] 所有变更已提交
- [ ] 编译通过(BUILD_CMD)
- [ ] 静态分析通过(VET_CMD)
- [ ] 所有测试通过(TEST_CMD)
- [ ] 代码符合项目编码红线
- [ ] 图后端状态已确认(可用时通过 `loom_graph_status` 查询,否则注明图查询已跳过)
- [ ] 已完成 Standards + Spec 双轴预审查,或已说明跳过某一轴的原因
- [ ] 已完成 Spec 遗漏自审,或已说明跳过原因

## 执行流程

### Step1:准备审查材料

1. 确认所有变更已完成
2. 运行验证确保代码质量(读取宪章中的 BUILD_CMD、VET_CMD、TEST_CMD 并执行)

### Step2:双轴预审查

请求人工审查前,先对当前 diff 做本地预审查。必须先确定 fixed point,例如用户指定的 commit/branch/tag、PR base、`main` 或 `HEAD~1`;fixed point 不明确时先问用户。

#### Standards 轴

检查代码是否符合项目标准和通用工程质量:

- `.loom/rules/constitution.md`、ADR、CONTRIBUTING、CODING_STANDARDS 等项目规范。
- 架构分层、模块边界、命名、错误处理、日志、配置、安全和性能。
- 测试质量:是否测行为、是否覆盖边界、是否避免实现耦合。
- 固定坏味道基线:重复、过长函数、霰弹式修改、循环依赖、全局状态、过度 mock、临时兼容层、未解释的复杂度。

#### Spec 轴

检查实现是否忠实满足来源需求:

- 从 commit message、PR 描述、`specs/<date+feature>/spec.md`、`plan.md`、issue/PRD 或用户原始请求定位 spec 来源。
- 对照验收标准、Requirement ID、边界条件和不做范围。
- 缺少 spec 来源时,明确写“Spec 轴跳过:未找到来源”,或向用户请求来源;不得凭想象补需求。

  输出必须分成独立区块,不合并、不重排:

```markdown
## Standards

- <finding 或 无发现>

## Spec

- <finding、跳过原因 或 无发现>

## Spec 遗漏自审

- <见 Step3>

## 预审查摘要

- Standards findings: <数量>,worst: <最严重问题或 none>
- Spec findings: <数量/跳过>,worst: <最严重问题或 none>
- Spec 遗漏: <数量/跳过>,worst: <最严重遗漏或 none>
```

  若任一轴或遗漏自审发现 blocker,先修复并重新验证,再生成审查请求。

### Step3:Spec 遗漏自审

有 spec 来源时必须执行;缺少 spec 来源时写明跳过原因,不得凭想象补需求。本步检查的是“spec 里有的是否都实现了”,与 Spec 轴的符合性检查分开记录。

逐条对照 `spec.md`(及 `requirements.json` / `traceability.json`,若存在):

1. **需求条目**:每个 REQ / 验收标准是否都有对应代码实现。
2. **Behavior**:每个 `REQ-xxx-Bnn` 是否有代码落点;`traceability.json` 是否有 `tests` / `evidence`。
3. **边界与失败**:边界条件、无效输入、失败场景、禁止行为是否有实现或保护。
4. **确定性辅助**:若存在 `requirements.json` 与 `traceability.json`,调用 `loom_omission_hunt`(参数 `spec_dir`)。blocker 视为本步失败。
5. **不做范围**:spec 明确不做的内容若被实现,记为 scope 偏差,不记为遗漏。

输出必须单独成块:

```markdown
## Spec 遗漏自审

- 检查条目: <N>
- 遗漏: <列表或无>
- omission-hunter: <pass/blocked/跳过原因>
```

若发现遗漏(含 omission-hunter blocker),先修复并重新验证,再进入下一步。不得用“整体看起来完整”代替逐条核对。

### Step4:整理变更摘要

```bash
git diff --stat
git log --oneline -10
```

### Step5:生成审查请求

```markdown
# 代码审查请求

**功能:** <feature-name>
**分支:** feature/<date>-<feature-name>

## 变更统计

<git diff --stat 输出>

## 主要变更

1. <变更说明 1>
2. <变更说明 2>

## 重点关注

1. 架构设计:xxx
2. 安全性:xxx
3. 性能:xxx

## 自测情况

- [x] 编译通过(BUILD_CMD)
- [x] 静态分析通过(VET_CMD)
- [x] 测试通过(TEST_CMD)
- [x] 代码符合编码红线
- [x] 图后端已同步,或已注明索引查询跳过
- [x] Spec 遗漏自审通过,或已说明跳过原因

## 变更详情

| 文件          | 变更类型 | 说明            |
| ------------- | -------- | --------------- |
| path/to/file1 | 新增     | XxxService 实现 |
| path/to/file2 | 修改     | 新增方法        |

## 审查重点

- [ ] 架构合规性
- [ ] 代码质量
- [ ] 安全性检查
- [ ] 性能影响
```

## 约束

- 审查请求必须包含完整的变更摘要
- 必须标注重点关注项
- 必须提供自测情况
- Findings 必须优先于总结,且包含文件/行号或明确的证据来源。
- 缺少 spec 来源时不得伪造 Spec findings。
- 有 spec 来源时不得跳过 Spec 遗漏自审。
- 遗漏 blocker 未修复前不得生成审查请求。

Wersje

W bazie nie ma innych skilli o nazwie loom-requesting-code-review.

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

  • 100requesting-code-review
    Pomaga poprosić o review lub utworzyć pull request: najpierw self-review, właściwy kontekst i plan testów, także gdy ktoś pisze tylko „open a PR”.
  • 100dino-requesting-code-review
    Zestawia dane o właścicielach i ryzyku plików do prośby o przegląd, zanim powstanie opis pull requesta dla recenzentów.
  • 100requesting-code-review
    Przygotowuje pakiet przeglądu z właścicielami plików, churnem i zadaniami z sygnałów git, zanim powstanie prośba o review.
  • 100requesting-code-review
    Przeprowadza przegląd gotowości do produkcji zmiany w MR względem zatwierdzonych wymagań.
  • 100requesting-code-review
    Przygotowuje prośbę o przegląd kodu po ukończeniu zadania, weryfikując zgodność z planem i wymaganiami.
  • 96requesting-code-review
    Prosi o przegląd kodu, gdy zadania gałęzi są skończone, albo przed scaleniem.

Uwagi i zgłoszenia

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