Skip to content

README-RU.md

Latest commit

 

History

History
90 lines (66 loc) · 5.13 KB

README-RU.md

File metadata and controls

90 lines (66 loc) · 5.13 KB

fpf-simple-skill

Скилл AI-агента для First Principles Framework (FPF) авторства Анатолия Левенчука.

FPF — трансдисциплинарная архитектура мышления для системной инженерии, координации знаний и смешанных команд человек/ИИ.

FPF — это система усиления мышления: она позволяет планировать и принимать решения более глубоко и качественно, систематически рассматривая несколько релевантных опций вместо фиксации на первой идее.

Как это работает

Скилл работает как агентный RAG — retrieval-augmented generation, управляемый самим агентом, без внешней векторной базы данных или пайплайна эмбеддингов. Спецификация FPF на 56 000 строк разбита на двухуровневую иерархию (20 директорий, 224 файла). SKILL.md содержит роутер на основе «глаголов мышления», который сопоставляет намерение пользователя с нужным разделом. Агент навигирует по файлам _index.md, выбирает минимальный подраздел (~300 строк) и загружает в контекст только его. Агент одновременно является ретривером, роутером и генератором — всё в одном цикле.

Установка

npx skills add CodeAlive-AI/fpf-simple-skill -g

Структура

sections/
  04-part-a-kernel-architecture-cluster/
    _index.md                          # Оглавление с описаниями всех подразделов
    01-a-0---onboarding-glossary.md    # 137 строк
    02-a-1---holonic-foundation.md     # 185 строк
    ...                                # 19 подразделов
  08-part-c-kernel-extensions-specifications/
    _index.md
    ...                                # 30 подразделов
  ...                                  # 20 директорий всего

Агент сначала читает _index.md, выбирает нужный подраздел и загружает только его.

Разделы

# Раздел Подразд.
01 Титульная страница 0
02 Оглавление 0
03 Предисловие 17
04 Часть A — Архитектура ядра 19
05 A.IV.A — Стек сигнатур и границы 18
06 A.V — Конституционные принципы 29
07 Часть B — Трансдисциплинарное рассуждение 24
08 Часть C — Расширения ядра 30
09 Часть D — Этика и конфликты 1
10 Часть E — Конституция и авторство 0
11 E-I — Конституция FPF 29
12 Часть F — Унификация 0
13 F.I — Контекст значения 19
14 UTS Layout A 0
15 UTS Layout B 1
16 Часть G — SoTA-паттерны 15
17 Часть H — Глоссарий 0
18 Часть I — Приложения 0
19 Часть J — Указатели 0
20 Часть K — Лексический долг 2

Обновление при изменениях спецификации FPF

При изменении upstream-спецификации FPF нужно обновить две вещи:

1. Перегенерировать файлы разделов

Обновить подмодуль и перезапустить сплиттер для пересборки иерархии sections/:

git submodule update --remote
python3 scripts/split_spec.py

2. Обновить навигацию в SKILL.md

Файлы разделов — это сырой контент, а SKILL.md — навигационный слой поверх него. После перегенерации проверьте, нужно ли обновить роутер глаголов мышления, юзкейсы или индекс разделов в SKILL.md.

Полная методология описана в FPF-SKILL-UPDATE-GUIDE.md — что проверять, как валидировать записи роутера и как провести FPF-самоаудит скилл-файла.

Авторы

Лицензия

MIT