Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

spectra-diff

/spectra-diff

Porównuje kod ze specyfikacją, wykrywa dryf, nowe zachowania bez dokumentacji i pozycje, których już nie ma w kodzie.

Licencja
MIT
Ostatnia zmiana repozytorium
15.09.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 15.09.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

Porównuje kod ze specyfikacją, wykrywa dryf, nowe zachowania bez dokumentacji i pozycje, których już nie ma w kodzie.

Oryginalny opis (EN)

Use this skill when the user asks to: - Compare code against its spec to find drift - Check if spec is still in sync with code - Find new behaviors not documented in spec - Identify spec items that no longer exist in code - Validate spec accuracy after code changes Useful after code changes to keep specs current, or before refactoring to understand what's changed.

Jak działa

  1. User Input
  2. Purpose
  3. Execution Flow
  4. 语言规范
  5. Guidelines
Sekcje z nagłówków SKILL.md, w oryginale · 89 linii, 242 słów
Podgląd SKILL.md
---
name: spectra-diff
description: |
  Use this skill when the user asks to:
  - Compare code against its spec to find drift
  - Check if spec is still in sync with code
  - Find new behaviors not documented in spec
  - Identify spec items that no longer exist in code
  - Validate spec accuracy after code changes
  Useful after code changes to keep specs current, or before refactoring to understand what's changed.
---

## User Input

```text
$ARGUMENTS
```

You **MUST** consider the user input before proceeding (if not empty).

## Purpose

Detect specification drift between a .spec.md and its corresponding source code. Useful after code changes to keep specs current, or before refactoring to understand what's changed.

## Execution Flow

### 1. Parse Arguments

Expected format: `<spec-file> [source-target]`

- `<spec-file>`: Path to existing .spec.md (required)
- `[source-target]`: Path to source code (optional — inferred from spec's `related_files` frontmatter)

If spec file doesn't exist, suggest running `/spectra` first.

### 2. Run Drift Detection Pipeline

Execute the drift detection using the globally installed `spectra` CLI:

```bash
spectra diff <spec-file> <source-target>
```

如果需要自定义输出目录:

```bash
spectra diff <spec-file> <source-target> --output-dir drift-logs/
```

流水线自动执行以下步骤:
1. 从 spec HTML 注释加载基线 `CodeSkeleton`
2. 对当前源代码进行 AST 分析
3. 结构差异比较(`compareSkeletons`)
4. 噪声过滤(空白/注释/import 重排序)
5. 语义差异评估(LLM,可选)
6. 组装 `DriftReport` 并写入 `drift-logs/`

### 3. Fallback: Manual Analysis

如果 CLI 流水线不可用(依赖未安装、编译错误等),手动执行:

1. 读取 spec 文件,提取接口定义章节
2. 对源代码进行 AST 分析
3. 对比 spec 中的导出符号与当前代码
4. 按严重级别分类差异:
   - **HIGH**: 删除的导出(Breaking Change)
   - **MEDIUM**: 签名修改、行为变更
   - **LOW**: 新增导出

### 4. Output Drift Report

报告自动写入 `drift-logs/{module}-drift-{date}.md`,包含:
- YAML frontmatter(spec 路径、源码路径、版本)
- 汇总统计表(按严重级别和变更类型)
- 逐项漂移详情(ID、类别、位置、旧/新值、建议更新)
- 综合建议

### 5. Offer Update

**在任何 spec 更新前必须提示用户确认。**

Ask: "是否需要更新 spec 以匹配当前代码?这将运行 `/spectra` 并使用现有 spec 作为基线。"

Do NOT auto-update. Wait for user confirmation.

## 语言规范

**所有漂移报告的正文内容必须使用中文撰写。** 具体规则:

- **用中文**:所有描述、说明、分析、总结、表格内容、建议
- **保留英文**:代码标识符(函数名、类名、变量名)、文件路径、类型签名、代码块内容
- **表格表头**:使用中文,例如 `| 项目 | 类型 | 位置 | 描述 |`

## Guidelines

- 这是**只读分析**——未经用户同意不修改任何文件
- 关注**语义**差异,而非格式/风格变化
- 忽略空白、纯注释变更和 import 重排序
- **突出标记破坏性变更**(删除/修改的公开 API)

Wersje

W bazie nie ma innych skilli o nazwie spectra-diff.

Identyczna treść występuje jeszcze w 2 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

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

  • 90spec-to-code-compliance
    Sprawdza zgodność implementacji z autorytatywną specyfikacją i wykrywa dryf specyfikacji podczas review pull requestów.
  • 100sync
    Wykrywa rozjazd specyfikacji i kodu, skanując specyfikacje REQ, DESIGN i TASK pod kątem odwołań do kodu, którego już nie ma, i raportuje wynik do triage bez edycji.
  • 100sync
    Wykrywa rozjazd specyfikacji i kodu, skanując specyfikacje REQ, DESIGN i TASK pod kątem odwołań do kodu, którego już nie ma, i raportuje wynik do triage bez edycji.
  • 100check
    Wykrywa dryf w trybie do odczytu: porównuje SPEC.md z bieżącym kodem i raportuje naruszenia pogrupowane według powagi, niczego nie zapisując.
  • 100spectra
    Generuje specyfikację z istniejącego kodu, dokumentuje architekturę modułu i wyjaśnia intencję, interfejsy oraz logikę biznesową plików.
  • 100spectra-batch
    Generuje specyfikacje dla całego projektu: indeks architektury i osobny plik spec.md dla każdego modułu.

Uwagi i zgłoszenia

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