Przejdź do treści
Biblioteka skilli
AI i agenci · Automatyzacja

fpf-sync

/fpf-sync

Synchronizuje skill fpf-core z kanonicznego monolitu FPF-Spec.md, gdy specyfikacja FPF się zmieniła lub referencje skilla są nieaktualne, w ramach cyklicznej konserwacji.

Repozytorium
skills ↗
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
5
Skrypty
4
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 sprawdzić przed instalacją
  • 4 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/_common.py, scripts/decompose_fpf.py, scripts/errors.py, scripts/sync_fpf_core.py

Co robi i kiedy

Synchronizuje skill fpf-core z kanonicznego monolitu FPF-Spec.md, gdy specyfikacja FPF się zmieniła lub referencje skilla są nieaktualne, w ramach cyklicznej konserwacji.

Oryginalny opis (EN)

Sync the fpf-core skill from the canonical FPF-Spec.md monolith. Use when: (1) the FPF specification has been updated (git pull shows new commits), (2) the fpf-core skill references/ are stale or show wrong counts, (3) running scheduled maintenance on LFW skills. Self-contained — bundles decompose_fpf.py + _common.py directly. No dependencies on external skills. Works only with the local skill at `../fpf-core/` (relative to this skill) — NOT the global user skill.

Jak działa

  1. Quick Start
  2. Workflow
  3. Scripts
  4. Error Handling
  5. SDC Alignment
  6. Evolution
Sekcje z nagłówków SKILL.md, w oryginale · 66 linii, 412 słów
Podgląd SKILL.md
---
name: fpf-sync
description: |
  Sync the fpf-core skill from the canonical FPF-Spec.md monolith.
  Use when: (1) the FPF specification has been updated (git pull shows new commits),
  (2) the fpf-core skill references/ are stale or show wrong counts,
  (3) running scheduled maintenance on LFW skills.
  Self-contained — bundles decompose_fpf.py + _common.py directly.
  No dependencies on external skills. Works only with the local skill at
  `../fpf-core/` (relative to this skill) — NOT the global user skill.
---

# FPF Core Skill Sync

**Bounded context:** Keeping `../fpf-core/` in sync with the canonical FPF monolith `../../FPF-Spec.md`.

**Self-contained** — all decomposition logic is bundled in `scripts/`. No external skill dependencies. Requires only Python 3.10+ and `git` in PATH.

## Quick Start

```bash
# Check if update is needed (exit code 0=up-to-date, 1=needs update):
python scripts/sync_fpf_core.py --check

# Full sync (git pull + copy + decompose + update SKILL.md):
python scripts/sync_fpf_core.py

# Preview without writing:
python scripts/sync_fpf_core.py --dry-run

# Sync without running git pull (use local state):
python scripts/sync_fpf_core.py --no-git
```

## Workflow

The script performs these steps in order:

1. **`git pull`** in repo root (`../..`) — fetch latest FPF-Spec.md
2. **Compare hashes** — `FPF-Spec.md` vs `skills/fpf-core/assets/FPF-Spec.md`. If identical, exit cleanly
3. **Copy monolith** — updated `FPF-Spec.md` → `skills/fpf-core/assets/FPF-Spec.md`
4. **Decompose** — calls bundled `decompose_fpf.parse_fpf_spec()` to rebuild all `references/*.md` + `INDEX.md` from the monolith. Uses idempotent writes — only changed files are overwritten
5. **Update `SKILL.md`** — refreshes line count (e.g. `100K+`) and reference counts (`291 pattern reference files + INDEX + 34 context sections`)
6. **Report** — prints counts, warnings, and errors

## Scripts

| File | Role | Size |
|---|---|---|
| `sync_fpf_core.py` | Orchestrator: git pull → diff → copy → decompose → update SKILL.md | 7 KB |
| `decompose_fpf.py` | FPF monolith parser: ToC parsing, `:End`-marker boundary detection, pattern extraction | 15 KB |
| `_common.py` | Shared utilities: reference formatting, YAML frontmatter, idempotent writes, INDEX generation | 7 KB |
| `errors.py` | Error types for pattern extraction | 1 KB |

## Error Handling

| Situation | Script behavior |
|---|---|
| `git pull` fails (network, auth) | Warning — continues with local state |
| Source `FPF-Spec.md` missing | Error — exits with code 2 |
| Decomposition produces warnings | Printed — exits with code 0 (non-fatal) |
| Decomposition produces errors | Printed — exits with code 1 |
| No changes detected | Exits cleanly with code 0 |

## SDC Alignment

This skill implements `SDC.SyncDiscipline` (Spec-Decomposer LPF) for the specific case of the `fpf-core` skill:

- **Unidirectional sync** (`AS.10:4.1`): monolith → references. Never the reverse.
- **Carrier split** (`AS.4:4.1`): agent reads `references/`, human edits `assets/FPF-Spec.md`
- **Full rebuild** on every change: copy monolith → decompose → update dispatcher
- **Idempotent writes**: `decompose_fpf.py` skips unchanged files

## Evolution

If the user is dissatisfied with the result or the FPF-Spec structure changes, offer to update this skill's script or its SKILL.md instructions.
Pliki w paczce (5)
  • SKILL.md 3 KB
  • scripts/_common.py 6 KB
  • scripts/decompose_fpf.py 15 KB
  • scripts/errors.py 1 KB
  • scripts/sync_fpf_core.py 9 KB

Wersje

W bazie nie ma innych skilli o nazwie fpf-sync.

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

  • 100fpf-library-sync
    Buduje i odświeża zestaw skilli FPF z monolitów biblioteki Levenchuk FPF, w tym fpf-core i skille dpf-*, także jako zadanie cykliczne.
  • 85dpf-lfw-architecture
    Porządkuje przestrzeń roboczą FPF, DPF i LPF: gdzie umieścić nowy framework, jak ustawić strukturę skill-carrier i jak rozstrzygać granice LPF i projektu.
  • 90source-command-wiki
    Sprawdza, odpytuje i odświeża wiki wtyczki FPF, gdy użytkownik o to poprosi.
  • 100fpf-integration
    Włącza do projektu First Principles Framework (FPF): audyt decyzji i jakości dowodów, mechanizm wygasania, kontrolę uprzedzeń poznawczych, listy kontrolne ról oraz audyt kontekstów i terminologii.
  • 90fpf-core
    Dostarcza wzorce Frameworka Pierwszych Zasad dla inżynierii, badań, zarządzania i pracy ludzi z AI, ładując tylko potrzebne fragmenty.
  • 85episteme-compaction
    Bezstratnie kompaktuje epistemy między prozą a zwięzłą notacją typowanych slotów, oszczędzając około 65 proc. tokenów, z odtworzeniem do źródła i zależnością od fpf-core.

Uwagi i zgłoszenia

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