Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,25 @@
"./skills/web-artifacts-builder",
"./skills/webapp-testing"
]
},
{
"name": "ai-pmo-skills",
"description": "AI-PMO Skills for construction and infrastructure project management including Gantt planning, progress tracking, risk analysis, executive dashboards, stakeholder communications, forecasting, and contract management",
"source": "./",
"strict": false,
"skills": [
"./skills/gantt-planner",
"./skills/progress-tracker",
"./skills/risk-analyzer",
"./skills/executive-dashboard",
"./skills/letter-generator",
"./skills/forecast-engine",
"./skills/contract-analyzer",
"./skills/act-processor",
"./skills/deviation-alert",
"./skills/resource-allocator",
"./skills/telegram-worklog"
]
}
]
}
216 changes: 216 additions & 0 deletions skills/act-processor/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,216 @@
---
name: act-processor
description: Обработка и генерация актов КС-2, КС-3 и других закрывающих документов. Используй когда пользователь говорит "обработай акт", "сформируй КС-2", "закрывающие документы", "акт выполненных работ", "справка о стоимости".
---

# Act Processor — Обработка актов выполненных работ

## Назначение

Работа с актами и закрывающими документами:
- Обработка входящих актов КС-2, КС-3
- Генерация актов на основе данных о выполнении
- Проверка соответствия сметам и договору
- Формирование пакета закрывающих документов

## Формы документов

### КС-2 (Акт о приёмке выполненных работ)
Унифицированная форма для фиксации объёмов и стоимости выполненных работ.

### КС-3 (Справка о стоимости выполненных работ)
Сводный документ для оплаты, суммирует данные из КС-2.

### КС-6а (Журнал учёта выполненных работ)
Накопительная ведомость по проекту.

## Структура КС-2

```
┌─────────────────────────────────────────────────────────────┐
│ АКТ │
│ О ПРИЁМКЕ ВЫПОЛНЕННЫХ РАБОТ │
│ № ___ │
├─────────────────────────────────────────────────────────────┤
│ Стройка: ________________________________________________ │
│ Объект: _________________________________________________ │
│ Договор: № ___ от _______ │
│ Отчётный период: с ___ по ___ │
├─────────────────────────────────────────────────────────────┤
│ № │ Наименование │ Ед. │ Кол-во │ Цена │ Стоимость │
│ │ работ │ изм │ │ │ │
├───┼──────────────┼─────┼────────┼──────┼────────────────────┤
│ 1 │ Разработка │ м³ │ 1000 │ 500 │ 500 000 │
│ │ грунта │ │ │ │ │
├───┼──────────────┼─────┼────────┼──────┼────────────────────┤
│ │ ИТОГО: │ │ │ │ 500 000 │
└───┴──────────────┴─────┴────────┴──────┴────────────────────┘
│ Сдал: Подрядчик │ Принял: Заказчик │
│ _____________ │ _____________ │
└──────────────────────────┴──────────────────────────────────┘
```

## Workflow

### Режим 1: Обработка входящего акта

**Шаг 1:** Загрузка документа
- Поддерживаемые форматы: PDF, Excel, Word
- Извлечение данных: номер, дата, объёмы, стоимость

**Шаг 2:** Верификация
- Проверка соответствия смете
- Проверка расценок (ФГИС ЦС, договорные)
- Проверка объёмов (не более остатка по договору)
- Арифметическая проверка

**Шаг 3:** Формирование заключения
```
✅ Проверка акта КС-2 № 5 от 25.01.2026

Объёмы: ✓ Соответствуют смете
Расценки: ✓ Соответствуют договору
Арифметика: ✓ Корректна
Остаток по договору: 2 500 000 ₽

Рекомендация: К ПОДПИСАНИЮ
```

### Режим 2: Генерация акта

**Шаг 1:** Сбор данных
- Данные о выполнении из progress-tracker
- Расценки из сметы/договора
- Период отчётности

**Шаг 2:** Формирование акта
- Заполнение шапки (реквизиты, договор, период)
- Заполнение табличной части (работы, объёмы, стоимость)
- Расчёт итогов

**Шаг 3:** Генерация пакета документов
1. КС-2 (Excel)
2. КС-3 (Excel)
3. Сопроводительное письмо (Word)
4. Счёт на оплату (опционально)

## Проверки

### Соответствие смете
```python
# Проверка: объём в акте ≤ объём в смете - ранее закрыто
остаток_по_смете = смета.объём - сумма(ранее_закрыто)
if акт.объём > остаток_по_смете:
❌ "Превышение объёма по позиции {название}"
```

### Соответствие расценкам
```python
if акт.расценка != договор.расценка:
❌ "Расценка не соответствует договору"
expected: договор.расценка
actual: акт.расценка
```

### Арифметика
```python
if акт.объём * акт.расценка != акт.стоимость:
❌ "Арифметическая ошибка"
expected: акт.объём * акт.расценка
actual: акт.стоимость
```

## Примеры использования

### Пример 1: Проверка входящего акта
```
Пользователь: Проверь акт КС-2 от субподрядчика [прикладывает файл]

Claude:
📋 Проверка акта КС-2 № 12 от 25.01.2026
Субподрядчик: ООО "СтройМонтаж"
Договор: № 45-2025 от 01.06.2025

**Результаты проверки:**

✅ Реквизиты: корректны
✅ Период: 01.01.2026 - 25.01.2026
✅ Объёмы: соответствуют журналу работ

⚠️ Замечания:
1. Позиция 3 "Укладка асфальтобетона":
- В акте: 1200 м²
- Остаток по договору: 1000 м²
- Превышение: 200 м² (требует допсоглашение)

2. Позиция 7 "Монтаж ограждений":
- Расценка в акте: 1500 ₽/п.м.
- Расценка по договору: 1400 ₽/п.м.
- Разница: +100 ₽/п.м.

**Рекомендация:** Вернуть на доработку с замечаниями
```

### Пример 2: Генерация акта
```
Пользователь: Сформируй акт КС-2 по проекту "Мост №5" за январь

Claude:
📝 Формирую акт КС-2...

**Данные из progress-tracker:**
- Проект: Мост №5
- Период: 01.01.2026 - 31.01.2026
- Выполнено работ: 12 позиций
- Общая стоимость: 4 500 000 ₽

**Генерирую документы:**
1. КС-2_Мост5_январь_2026.xlsx
2. КС-3_Мост5_январь_2026.xlsx
3. Сопроводительное_КС_Мост5.docx

**Сводка:**
| Раздел | Стоимость |
|--------|-----------|
| Земляные работы | 1 200 000 |
| Бетонные работы | 2 800 000 |
| Арматурные работы | 500 000 |
| **ИТОГО:** | **4 500 000** |
```

### Пример 3: Накопительный итог
```
Пользователь: Покажи сколько закрыто по договору с начала работ

Claude:
📊 Накопительный итог по договору № 125-2025

**Договор:** 15 000 000 ₽
**Период:** март 2025 - январь 2026

| Месяц | КС-2 № | Сумма | Накопительно | % |
|-------|--------|-------|--------------|---|
| Март | 1 | 1 200 000 | 1 200 000 | 8% |
| Апрель | 2 | 1 800 000 | 3 000 000 | 20% |
| Май | 3 | 2 500 000 | 5 500 000 | 37% |
| ... | ... | ... | ... | ... |
| Январь | 10 | 4 500 000 | 12 000 000 | 80% |

**Остаток:** 3 000 000 ₽ (20%)
**Прогноз закрытия:** февраль 2026
```

## Интеграция

- **progress-tracker** — данные о выполнении работ
- **contract-analyzer** — условия договора, расценки
- **letter-generator** — сопроводительные письма
- **xlsx** — генерация Excel-файлов
- **1С:ERP** — синхронизация с бухгалтерией

## Выходные документы

1. **КС-2_[проект]_[период].xlsx** — акт о приёмке
2. **КС-3_[проект]_[период].xlsx** — справка о стоимости
3. **Сопроводительное_КС_[проект].docx** — письмо
4. **Реестр_актов_[проект].xlsx** — накопительная ведомость
Loading