القائمة
Use when working with MCU/microcontroller similarity calculations - comparing microcontroller MPNs, understanding family/series/feature matching, or MCU-specific similarity logic.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when refactoring, cleaning up, or enhancing the lib-electronic-components codebase. Provides guidance on architecture patterns, known issues, duplication hotspots, and recommended improvements.
Base skill for working with electronic components in this library. Use when adding new component types, manufacturer handlers, or working with MPN (Manufacturer Part Number) operations, BOM entries, or component classification.
Use this skill BEFORE creating a PR to ensure all documentation, skills, and learnings are updated. Critical for preserving institutional knowledge and preventing documentation drift.
Use when working with component similarity calculations - comparing MPNs, finding equivalent parts, implementing new similarity calculators, or understanding how component matching works.
Use when working with capacitor similarity calculations - comparing ceramic/electrolytic/film capacitor MPNs, understanding value/voltage/dielectric matching, or capacitor-specific similarity logic.
Use when working with connector similarity calculations - comparing connector MPNs, understanding pin count/pitch/family matching, or connector-specific similarity logic.
| name | similarity-mcu |
| description | Use when working with MCU/microcontroller similarity calculations - comparing microcontroller MPNs, understanding family/series/feature matching, or MCU-specific similarity logic. |
Guidance for working with MCU similarity calculators in the lib-electronic-components library.
For metadata-driven similarity architecture, see /similarity-metadata:
There are two MCU-related calculators:
SimilarityCalculatorComponentSimilarityCalculatorComponentType.MICROCONTROLLER
ComponentType.MICROCONTROLLER_ATMEL
ComponentType.MICROCONTROLLER_INFINEON
ComponentType.MICROCONTROLLER_ST
ComponentType.MCU_ATMEL
familySimilarity * 0.5 // Family is most important
seriesSimilarity * 0.3 // Series number
featureSimilarity * 0.2 // Feature codes (F, L, U, etc.)
| Group | Members |
|---|---|
| PIC | PIC16, PIC18, PIC24, PIC32 |
| STM | STM8, STM32 |
| ATM | ATMEGA, ATTINY, ATXMEGA |
| MSP | MSP430, MSP432 |
// Same family = 1.0 family similarity
calculator.calculateSimilarity("STM32F103", "STM32F407");
// High similarity (same STM32 family)
// Related family = 0.8 family similarity
calculator.calculateSimilarity("PIC16F877", "PIC18F4550");
// Good similarity (both PIC family)
| Code | Meaning |
|---|---|
| F | Flash memory |
| L | Low power |
| U | USB capable |
| W | Wireless |
| R | ROM version |
| T | Extended temperature |
// Same feature codes contribute to similarity
calculator.calculateSimilarity("STM32F103", "STM32F407");
// Both have F (Flash) feature
Series numbers are compared numerically:
// Same series
calculator.calculateSimilarity("ATMEGA328", "ATMEGA328P");
// Very high similarity
// Close series
calculator.calculateSimilarity("ATMEGA328", "ATMEGA329");
// High similarity
// Far series
calculator.calculateSimilarity("ATMEGA328", "ATMEGA2560");
// Lower similarity
| Condition | Score |
|---|---|
| Same manufacturer, same series, same package | 1.0 |
| Same manufacturer, same series, different package | 0.9 |
| Official replacement parts | 0.8 |
| Same series across manufacturers | 0.7 |
| Both microcontrollers, different series | 0.5 |
// Identical MCU
calculator.calculateSimilarity("ATMEGA328P", "ATMEGA328P");
// Returns 1.0
// Same family, different series
calculator.calculateSimilarity("STM32F103", "STM32F407");
// Returns > 0.5
// Different families
calculator.calculateSimilarity("STM32F103", "ATMEGA328");
// Returns lower similarity
// Same part, different package
calculator.calculateSimilarity("ATMEGA328P-AU", "ATMEGA328P-PU", registry);
// Returns >= 0.5
// Different MCUs
calculator.calculateSimilarity("ATMEGA328P", "STM32F103C8T6", registry);
// Returns 0.5 (base MCU similarity)
ATMEGA 328 P -AU
│ │ │ │
│ │ │ └── Package (AU=TQFP)
│ │ └───── Variant (P=Picopower)
│ └───────── Series number
└──────────────── Family
STM32 F 103 C8 T6
│ │ │ │ │
│ │ │ │ └── Package (T6=LQFP48)
│ │ │ └───── Memory/pins
│ │ └───────── Series
│ └─────────── Type (F=Foundation)
└───────────────── Family
PIC16 F 877 A
│ │ │ │
│ │ │ └── Variant
│ │ └────── Series
│ └──────── Memory type (F=Flash)
└────────────── Family
^([A-Z]+)\d+ extracts family prefix[A-Z]+$ extracts trailing letters