spectra-diff
/spectra-diff
Porównuje kod ze specyfikacją, wykrywa dryf, nowe zachowania bez dokumentacji i pozycje, których już nie ma w kodzie.
- Autor
- connor-git-yaml ↗
- Repozytorium
- cc-plugin-market ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 15.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 15.09.2026, bez odwołań do wycofanych modeli i API.
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
- User Input
- Purpose
- Execution Flow
- 语言规范
- Guidelines
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.