Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

request-analysis

/request-analysis

Zamienia nowe wymaganie w sprawdzalną listę zadań i pokazuje, które moduły i tabele zmiana dotyka.

Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

86/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność21 / 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
6
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.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 sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (6). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Zamienia nowe wymaganie w sprawdzalną listę zadań i pokazuje, które moduły i tabele zmiana dotyka.

Oryginalny opis (EN)

需求分析与拆解:把一句话需求转成可验证的任务清单,判断落在哪个模块、影响哪些接口与表。收到新需求或变更、进入开发之前使用。

Jak działa

  1. 何时用
  2. 项目绑定(编译时替换)
  3. 模式(跨技术栈不变)
  4. 证据锚点(编译后填写)
Sekcje z nagłówków SKILL.md, w oryginale · 77 linii, 261 słów
Podgląd SKILL.md
---
name: request-analysis
description: 需求分析与拆解:把一句话需求转成可验证的任务清单,判断落在哪个模块、影响哪些接口与表。收到新需求或变更、进入开发之前使用。
---

# 需求分析

> **本文件是骨架**:`<!-- slot:… -->` 必须在安装时用项目事实替换,替换不到就整条删除;目标:开工前把「做什么、改哪里、怎么算完成」写死,避免边写边想。

## 何时用

- 用户说"加个功能 / 改个逻辑 / 优化一下",且改动可能跨文件或跨模块
- 需求里出现业务词但含义不明确,或缺陷描述只有现象、没有复现路径

> **先定档,再选记录方式**:按 `.harness/rules/开发流程规范.md` 第 1.1 节选 `L0 / L1 / L2 / L3`。

## 项目绑定(编译时替换)

- 模块划分与归属规则:<!-- slot:module.map -->
- 模块卡片目录(定位到模块后先读):<!-- slot:module.cards -->
- 领域词表位置:<!-- slot:domain.terms -->
- 接口形态与返回结构:<!-- slot:api.contract -->

## 模式(跨技术栈不变)

### 步骤

1. 复述需求,写成**一句可验证的验收描述**(模板见下)
2. 定位模块,列出受影响的接口、表、前端页面、定时任务、消息
3. 与项目硬约束比对,冲突先报,不自行取舍
4. 按档位落盘:L0 不建记录;L1 在 `.harness/changes/_small.md` 追加一行(字段按表头填齐);L2/L3 **复制** `.harness/changes/_template/summary.md` 到 `.harness/changes/<特性>/summary.md` 再填
5. L2/L3 填完骨架先跑 `check-summary.ps1 -Feature <特性> -Stage initial`;不通过不得开始编码。通过后**单独提交一次**(只含 `.harness/` 下文件),再进入编码。L1 的 `_small.md` 行由 `metrics.ps1` 解析
6. 无法确认的标 `TODO(待确认)`,**开工前只问一次**

### 验收描述模板

> 当 `<角色>` 在 `<场景>` 执行 `<动作>` 时,系统 `<可观测结果>`;失败时 `<错误提示 / 状态 / 回滚>`。

- ✅「当财务导出跨月订单时,返回的 Excel 含订单号与金额(最小单位),超过 5 万行拆文件」
- ❌「优化导出功能」——没有可观测结果,无法验收

### 定档判据(全部满足才可降档)

| 档位 | 判据 | 记录 |
| --- | --- | --- |
| L0 | 纯文档 / 注释 / 格式 / typo,不改行为 | 无 |
| L1 | 单文件 · diff ≤30 行 · 不碰公共层 / DB / 配置 / 接口 | `_small.md` 一行 |
| L2 | 单模块功能或修复,不跨模块、无数据迁移 | `summary.md` |
| L3 | 跨模块 / 数据迁移 / 接口变更 / 上线评审 | `summary.md` + 评审 |

> 拿不准就升档:多写一份 summary 的成本,远低于漏掉影响面。

### 影响面清单(逐项确认,不适用写「无」)

- [ ] 接口:新增 / 修改 / 删除,是否破坏调用方
- [ ] 数据:表结构、索引、历史数据是否要迁移
- [ ] 前端:页面、字段、错误提示
- [ ] 异步:定时任务、消息生产者 / 消费者
- [ ] 权限:谁可以调用,是否涉及资源归属
- [ ] 兼容:灰度、回滚、旧版本客户端

### 什么时候必须停下来问

- 需求有两种合理解释,且实现成本差异大
- 要改公共层、表结构或对外接口
- 与项目红线 / 现有规则冲突
- 验收标准无法观测

其余情况按最保守解释推进,把假设写进记录,不要反复打断。

### 常见错误

- 把方案当需求:「用 Redis 缓存」是实现建议,需求是「查询要在 200ms 内返回」
- 术语按字面理解,与代码实体对不上
- 只列接口不列表,改到一半才发现要迁移
- 漏掉定时任务 / 消息消费者等非 HTTP 入口

## 证据锚点(编译后填写)

<!-- slot:evidence - 至少一条 - [E2] 真实文件路径 :: 证明了什么 -->

Wersje

W bazie nie ma innych skilli o nazwie request-analysis.

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

  • 100plan
    Zamienia zatwierdzoną specyfikację w plan zadań z dokładnymi ścieżkami i sprawdzalną weryfikacją, zanim zacznie się implementacja, bez pisania kodu.
  • 100spec-driven-development
    Zamienia prośbę w sprawdzalną specyfikację przed kodem, gdy problem, kryteria albo granice są niejasne.
  • 90estack-feature
    Wdraża funkcję Phoenix w domenie, danych, interfejsie i API oraz testach, gdy zmiana dotyka wielu warstw aplikacji.
  • 100ui-review-contract
    Sprawdza czterema sygnałami, czy zmiana dotyka UI, i decyduje, czy dodać warstwę przeglądu wizualnego.

Uwagi i zgłoszenia

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