CLI Reference

CLI-Reference — полный справочник команд pfs

🇬🇧 English: CLI-Reference-EN

Источники: AGENTS.md (шпаргалка), docs/HELP.md (раздел 5). Запуск: python3 -m tools.pfs <команда> (в примерах короче: pfs …). Полный список: python3 -m tools.pfs --help. Почти всё агент делает сам — команды нужны, чтобы проверить состояние или сделать что-то вручную.

Проекты (Projects)

pfs new "Название" "Запрос дословно"   # создать проект projects/<slug>/
pfs list                               # список проектов
pfs use <slug>                         # сделать проект активным
pfs status [--brief]                   # где остановились, что дальше, стоимость

Маршрутизация и шаги (Routing & steps)

pfs route ["запрос"] [--override X] [--economy] [--json]   # сценарий, карты, план моделей
pfs step <шаг> in_progress|done --next "…" [--note "…"]    # отметка шага + обязательные карты
pfs next                # «что решать сейчас»: шаг, обязательства, пересмотры, вопросы
pfs questions <шаг|блок>  # вопросный блок шага (config/question_blocks.json);
                          # пропуск — pfs log --kind questions-skip
pfs models [pick|use|sync|escalate] <задача>   # см. [[Routing-and-Models]]

Паузы с человеком (Human pauses)

pfs ask "Вопрос?" --options "A,B,C"    # агент ждёт ответа
pfs answer "Вариант B"                 # ответить на паузу
pfs question "Открытый вопрос" [--close]

Источники S### (Sources)

pfs source add <url|файл>                                  # сайт/PDF/DOCX/XLSX/CSV/изображение
pfs source add --text-file doc.md --url <url> --title "…"  # если сайт блокирует загрузку (JS-рендер)
pfs source add interview.md --origin interview             # ваше интервью (без ПДн)
pfs source add transcript.md --origin synthetic            # ИИ-респондент: только гипотезы
pfs source list | pfs source show S001
pfs source refresh S003    # перезагрузка web-источника: дельта sha256 → бэкап raw/<S###>_old_<sha8>.txt
                           # → impact по утверждениям на нём

Правила: домены проверяются до запроса; файлы-секреты отклоняются; фразы-инструкции помечаются и не исполняются.

Утверждения C### (Claims) — сердце агента

pfs claim add "Рынок 6,2 млрд ₽, +25% г/г" fact --source S002 --grade B --quote "…"
pfs claim add "Готовы платить за клубную подачу" hypothesis --source S005
pfs claim add "Поэтому фокус на глубине Москвы" inference --from C003,C010
pfs claim list [--kind fact] [--all]
pfs claim supersede --id C005 "Новое значение" --reason "новый отчёт" [--source S009]
pfs claim retract --id C005 --reason "ошибка в методике"
pfs claim rebase [--id C010]      # перенаправить выводы на замены оснований
pfs impact C005 | S002            # что затронет изменение: выводы → строки → решения

Типы: fact (только с S###; синтетика фактами не считается), hypothesis, forecast, assumption, inference (только из других C###). Сила доказательства --grade A…D (шкала из M-source-criticism).

Проверки (Checks)

pfs check [--strict] [--json]     # quality gate: числа без тегов, мёртвые ссылки, структура документов
pfs check --strict                # ворота шагов 4/5/9 (в демо: 100/100)

Решения D### и мониторинг (Decisions & monitoring)

pfs decision add --title "…" --decision "…" --owner "CPO" --grounds C001,C007 \
  --metric "Удержание M1: 38% -> 45% @2027-01-01" --review 2027-01-01 \
  --trigger "M1 < 40% два месяца подряд" --commit "Запустить пилот|PM|2026-12-01"
pfs decision due                  # что решать сейчас: просрочки, устаревшие основания
pfs decision done --id D001 --commitment K1
pfs decision list | status | rebase

Подробности — Decisions-and-Monitoring.

Данные (Data)

pfs data profile events.csv [--sheet Лист1] --save profile   # типы, пропуски, дубли, периоды
pfs data cohort events.csv --user user_id --date dt --save cohorts   # когортное удержание
pfs data funnel events.csv --steps visit,signup,pay --user user_id   # воронка по событиям/колонкам
pfs data stats events.csv --col revenue [--group segment]    # n, среднее, медиана, перцентили, ДИ 95%

Интервью, медиа, UX (Interviews, media, UX)

pfs interview guide --persona "Родитель 7–12" [--topic "…"]  # каркас вопросов → interviews/
pfs interview save transcript.md --persona "…" --title "…"   # → источник origin=synthetic
pfs media add скрин.png --desc "что видно" --title "…"       # описание «только видимое» = источник
pfs ux scaffold S003 --focus "онбординг"                     # UX-каркас из 10 эвристик → analysis/

Excel-расчёты (Calculations)

pfs calc all                       # 4 книги → outputs/attachments/
pfs calc unit-econ | growth | cohort | market

Каждая книга: лист «Ввод» (редактируемые параметры из calcs.json) + расчётные листы на формулах — Excel пересчитывает при открытии. Параметры агент берёт из projects/<slug>/calcs.json; каждое значение прослеживается до C###/S### (ссылка в note). Чего нет в calcs.json — подставится пример из tools/pfs/calc.py: DEFAULTS с пометкой «ПРИМЕР».

Отчёты (Exports)

pfs export                         # REPORT.md: документы + приложения A–E
pfs export --six-pager             # SIX_PAGER.md (FAQ-1…6) + пересборка Excel
pfs export --six-pager --no-calcs  # текст без перегенерации книг
pfs export --deck                  # HTML-дека 16:9 из six-pager
pfs docx <файл.md> [--out]         # Markdown → Word без зависимостей

База знаний (Knowledge base)

pfs kb search "когортный анализ удержания"   # BM25 с русским стеммингом (RU и EN совместно)
pfs kb show M-unit-economics                 # показать карту
pfs kb index                                 # пересобрать INDEX.md, проверить связи related

Модели, стоимость, диагностика (Models, cost, doctor)

pfs models                  # таблица: задача → модель (config/models.json)
pfs models pick red_team    # план на задачу
pfs models use cursor-mixed # профиль для другой среды
pfs models sync             # прописать модели в субагентов Claude Code
pfs models escalate <задача> --reason "…"
pfs cost [--transcript session.jsonl] [--window]   # стоимость по транскриптам Claude Code
pfs log "Ручная правка" --usd 0.8 --human-minutes 15  # ручная запись стоимости в других средах
pfs doctor                  # диагностика окружения

См. также: MCP-Server (те же функции по MCP) · Methods-Catalog (карты под задачи).