К основному содержанию
скилл CX Codex

subcontractor-payment-tracker — скилл для Claude Code: установка

Скилл subcontractor-payment-tracker отслеживает расчёты с субподрядчиками, график счетов, гарантийные удержания и отказные от залога (lien waivers). Пригодится при контроле строительных договоров.

MIT 132 установок ★ 434 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill subcontractor-payment-tracker -a claude-code
Открыть на GitHub

Что делает subcontractor-payment-tracker

Скилл автоматизирует финансовый учёт субподрядчиков в строительных проектах. Внутри работает модуль на Python с классами SubcontractorPaymentTracker, Subcontractor и SubcontractorPayment. Он фиксирует сумму договора, рассчитывает процент гарантийного удержания (retention) при выставлении счетов и переводит оплату по статусам: от SCHEDULED и INVOICED до APPROVED и PAID.

Отдельный блок следит за документами об отказе от залоговых прав. Логика поддерживает четыре типа форм — предварительные и окончательные, с условиями и без (CONDITIONAL_PROGRESS, UNCONDITIONAL_PROGRESS, CONDITIONAL_FINAL, UNCONDITIONAL_FINAL). Скрипт привязывает отказную форму к платежу и выявляет счета, по которым документы ещё не поступили.

Для работы требуется установленный интерпретатор python3 и библиотека pandas. Без них трекер не сможет рассчитать остаток по контракту и сформировать списки ожидающих платежей.

Какие задачи решает

  • Рассчитывать чистую сумму счёта за вычетом гарантийного удержания (retention)
  • Контролировать этапы платежей от выставления счёта до проведения чека
  • Привязывать формы отказа от залога (lien waivers) к конкретным платежам
  • Формировать списки ожидающих выплат и пропущенных закрывающих форм

Примеры запросов агенту

  • Зарегистрируй субподрядчика ООО «СтройМонтаж» с контрактом на 500000 и удержанием 10%
  • Зафиксируй счёт на сумму 120000 от SUB-001 и прикрепи к нему форму conditional_progress
  • Покажи все платежи в статусе approved, по которым ещё не получены lien waivers

Как установить subcontractor-payment-tracker

1Через Skills CLI (Vercel)

npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill subcontractor-payment-tracker -a claude-code

2Вручную: положить файлы

~/.claude/skills/subcontractor-payment-tracker/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/subcontractor-payment-tracker/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о subcontractor-payment-tracker

Как установить subcontractor-payment-tracker в Claude Code?

Выполните команду npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill subcontractor-payment-tracker -a claude-code.

Что делает subcontractor-payment-tracker?

Он ведёт реестр договоров субподряда, вычитает процент удержания из входящих счетов, отслеживает статусы выплат и контролирует получение отказных форм от залога.

Какие системные зависимости требуются для работы скилла?

В системе должен быть установлен интерпретатор python3, а в окружении — библиотека pandas.

Исходный текст

SKILL.md · MIT
---
name: "subcontractor-payment-tracker"
description: "Track subcontractor payments, lien waivers, and compliance. Manage payment schedules and documentation."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "💰", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"]}}}
---
# Subcontractor Payment Tracker

## Business Case

### Problem Statement
Subcontractor payments require careful management:
- Complex payment schedules
- Lien waiver tracking
- Compliance documentation
- Cash flow coordination

### Solution
Comprehensive subcontractor payment tracking with lien waiver management, compliance monitoring, and payment scheduling.

## Technical Implementation

```python
import pandas as pd
from datetime import datetime, date, timedelta
from typing import Dict, Any, List, Optional
from dataclasses import dataclass, field
from enum import Enum


class PaymentStatus(Enum):
    SCHEDULED = "scheduled"
    INVOICED = "invoiced"
    APPROVED = "approved"
    PAID = "paid"
    HELD = "held"
    DISPUTED = "disputed"


class WaiverType(Enum):
    CONDITIONAL_PROGRESS = "conditional_progress"
    UNCONDITIONAL_PROGRESS = "unconditional_progress"
    CONDITIONAL_FINAL = "conditional_final"
    UNCONDITIONAL_FINAL = "unconditional_final"


@dataclass
class LienWaiver:
    waiver_id: str
    waiver_type: WaiverType
    through_date: date
    amount: float
    received_date: Optional[date]
    file_path: str = ""


@dataclass
class SubcontractorPayment:
    payment_id: str
    subcontractor_id: str
    invoice_number: str
    invoice_date: date
    amount: float
    retention_held: float
    status: PaymentStatus
    scheduled_date: date
    paid_date: Optional[date] = None
    check_number: str = ""
    lien_waiver: Optional[LienWaiver] = None
    notes: str = ""


@dataclass
class Subcontractor:
    sub_id: str
    company_name: str
    contact_name: str
    email: str
    phone: str
    contract_amount: float
    retention_percent: float
    trade: str
    payments: List[SubcontractorPayment] = field(default_factory=list)
    insurance_expiry: Optional[date] = None
    license_number: str = ""

    @property
    def total_paid(self) -> float:
        return sum(p.amount for p in self.payments if p.status == PaymentStatus.PAID)

    @property
    def total_retention(self) -> float:
        return sum(p.retention_held for p in self.payments)

    @property
    def balance_remaining(self) -> float:
        return self.contract_amount - self.total_paid - self.total_retention


class SubcontractorPaymentTracker:
    """Track subcontractor payments and compliance."""

    def __init__(self, project_name: str):
        self.project_name = project_name
        self.subcontractors: Dict[str, Subcontractor] = {}
        self._payment_counter = 0

    def add_subcontractor(self, company_name: str, contact_name: str, email: str,
                         phone: str, contract_amount: float, trade: str,
                         retention_percent: float = 0.10) -> Subcontractor:
        sub_id = f"SUB-{len(self.subcontractors) + 1:03d}"
        sub = Subcontractor(
            sub_id=sub_id,
            company_name=company_name,
            contact_name=contact_name,
            email=email,
            phone=phone,
            contract_amount=contract_amount,
            retention_percent=retention_percent,
            trade=trade
        )
        self.subcontractors[sub_id] = sub
        return sub

    def record_invoice(self, sub_id: str, invoice_number: str, invoice_date: date,
                      gross_amount: float, scheduled_date: date = None) -> SubcontractorPayment:
        if sub_id not in self.subcontractors:
            raise ValueError(f"Subcontractor {sub_id} not found")

        sub = self.subcontractors[sub_id]
        self._payment_counter += 1

        retention = gross_amount * sub.retention_percent
        net_amount = gross_amount - retention

        payment = SubcontractorPayment(
            payment_id=f"PAY-{self._payment_counter:05d}",
            subcontractor_id=sub_id,
            invoice_number=invoice_number,
            invoice_date=invoice_date,
            amount=net_amount,
            retention_held=retention,
            status=PaymentStatus.INVOICED,
            scheduled_date=scheduled_date or invoice_date + timedelta(days=30)
        )
        sub.payments.append(payment)
        return payment

    def approve_payment(self, payment_id: str, sub_id: str):
        sub = self.subcontractors.get(sub_id)
        if not sub:
            return
        for payment in sub.payments:
            if payment.payment_id == payment_id:
                payment.status = PaymentStatus.APPROVED
                break

    def record_payment(self, payment_id: str, sub_id: str, check_number: str,
                      paid_date: date = None):
        sub = self.subcontractors.get(sub_id)
        if not sub:
            return
        for payment in sub.payments:
            if payment.payment_id == payment_id:
                payment.status = PaymentStatus.PAID
                payment.paid_date = paid_date or date.today()
                payment.check_number = check_number
                break

    def attach_lien_waiver(self, payment_id: str, sub_id: str, waiver_type: WaiverType,
                          through_date: date, amount: float, received_date: date = None):
        sub = self.subcontractors.get(sub_id)
        if not sub:
            return
        for payment in sub.payments:
            if payment.payment_id == payment_id:
                waiver = LienWaiver(
                    waiver_id=f"LW-{payment_id}",
                    waiver_type=waiver_type,
                    through_date=through_date,
                    amount=amount,
                    received_date=received_date or date.today()
                )
                payment.lien_waiver = waiver
                break

    def get_pending_payments(self) -> List[Dict[str, Any]]:
        pending = []
        for sub in self.subcontractors.values():
            for payment in sub.payments:
                if payment.status in [PaymentStatus.INVOICED, PaymentStatus.APPROVED]:
                    pending.append({
                        'payment_id': payment.payment_id,
                        'subcontractor': sub.company_name,
                        'invoice': payment.invoice_number,
                        'amount': payment.amount,
                        'scheduled': payment.scheduled_date,
                        'status': payment.status.value,
                        'has_waiver': payment.lien_waiver is not None
                    })
        return sorted(pending, key=lambda x: x['scheduled'])

    def get_missing_waivers(self) -> List[Dict[str, Any]]:
        missing = []
        for sub in self.subcontractors.values():
            for payment in sub.payments:
                if payment.status == PaymentStatus.PAID and not payment.lien_waiver:
                    missing.append({
                        'subcontractor': sub.company_name,
                        'payment_id': payment.payment_id,
                        'amount': payment.amount,
                        'paid_date': payment.paid_date
                    })
        return missing

    def get_summary(self) -> Dict[str, Any]:
        total_contract = sum(s.contract_amount for s in self.subcontractors.values())
        total_paid = sum(s.total_paid for s in self.subcontractors.values())
        total_retention = sum(s.total_retention for s in self.subcontractors.values())

        return {
            'project': self.project_name,
            'total_subcontractors': len(self.subcontractors),
            'total_contract_value': total_contract,
            'total_paid': total_paid,
            'total_retention_held': total_retention,
            'remaining_to_pay': total_contract - total_paid - total_retention,
            'pending_payments': len(self.get_pending_payments()),
            'missing_waivers': len(self.get_missing_waivers())
        }

    def export_report(self, output_path: str):
        with pd.ExcelWriter(output_path, engine='openpyxl') as writer:
            # Summary by subcontractor
            sub_data = [{
                'ID': s.sub_id,
                'Company': s.company_name,
                'Trade': s.trade,
                'Contract': s.contract_amount,
                'Paid': s.total_paid,
                'Retention': s.total_retention,
                'Balance': s.balance_remaining
            } for s in self.subcontractors.values()]
            pd.DataFrame(sub_data).to_excel(writer, sheet_name='Subcontractors', index=False)

            # All payments
            pay_data = []
            for sub in self.subcontractors.values():
                for p in sub.payments:
                    pay_data.append({
                        'Payment ID': p.payment_id,
                        'Subcontractor': sub.company_name,
                        'Invoice': p.invoice_number,
                        'Amount': p.amount,
                        'Retention': p.retention_held,
                        'Status': p.status.value,
                        'Scheduled': p.scheduled_date,
                        'Paid': p.paid_date,
                        'Waiver': p.lien_waiver.waiver_type.value if p.lien_waiver else 'Missing'
                    })
            if pay_data:
                pd.DataFrame(pay_data).to_excel(writer, sheet_name='Payments', index=False)

        return output_path
```

## Quick Start

```python
tracker = SubcontractorPaymentTracker("Office Tower")

# Add subcontractor
sub = tracker.add_subcontractor(
    company_name="ABC Electrical",
    contact_name="John Smith",
    email="[email protected]",
    phone="555-1234",
    contract_amount=500000,
    trade="Electrical"
)

# Record invoice
payment = tracker.record_invoice(sub.sub_id, "INV-001", date.today(), 50000)

# Approve and pay
tracker.approve_payment(payment.payment_id, sub.sub_id)
tracker.record_payment(payment.payment_id, sub.sub_id, "CHK-12345")

# Attach waiver
tracker.attach_lien_waiver(payment.payment_id, sub.sub_id,
                          WaiverType.UNCONDITIONAL_PROGRESS, date.today(), 50000)
```

## Resources
- **DDC Book**: Chapter 3.1 - Cost Management

© datadrivenconstruction · MIT · datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
mcp-alegra codespar Подключает агента к Alegra для работы со счетами, контактами, товарами и платежами. CX Codex +1 ★ 279звёзд репо payment-gateway-integration aj-geddes Скилл payment-gateway-integration для Claude Code, который подключает Stripe, PayPal и Square к бэкенду: платежи, подписки, вебхуки, возвраты. Работает и в Codex, Cursor, Copilot, Gemini CLI, OpenCode. CX Codex +1 531установок mileage-tracker openaccountant Скилл mileage-tracker для Claude Code считает вычет IRS за деловые поездки и сверяет журнал пробега с расходами на топливо, платные дороги и парковку. Он включается при расчёте автомобильных расходов для Schedule C. CX Codex +1 446установок gnucash-mcp ninetails-io Подключает ИИ-ассистента к вашей книге GnuCash: сводка по счетам, сверка, счета клиентам. Данные остаются на вашей машине. CX Codex +1 ★ 90звёзд репо bexio-mcp-server PromptPartner Сервер связывает ассистента со швейцарской бухгалтерией Bexio. Он даёт доступ к счетам, контактам, проектам и проводкам прямо через чат. CX Codex +1 ★ 42звёзд репо BillingEngine billingengine Управляет черновиками счетов и платежами в BillingEngine из диалога с ИИ. Создаёт счета и отмечает оплату для контроля задолженностей. CX Codex +1

Из того же набора156

Весь набор →
rvt-to-excel Скилл rvt-to-excel для Claude Code извлекает данные элементов, свойства и количества из RVT/RFA и готовит книгу Excel. Подготавливает сводки и отчёты, передаёт BIM-данные в аналитические процессы. CX Codex +1 135установок bim-validation-report Скилл bim-validation-report проверяет элементы BIM-модели на корректность данных, геометрию и стандарты проекта, формируя отчёт об ошибках. Пригодится инженерам и разработчикам для автоматического контроля качества данных. CX Codex +1 133установок safety-inspection-checklist Скилл safety-inspection-checklist генерирует и проводит цифровые чек-листы безопасности на строительных площадках. Собирает данные инспекций, фото, отслеживает нарушения и автоматически составляет отчёты. CX Codex +1 133установок schedule-delay-analyzer Скилл schedule-delay-analyzer учитывает задержки проекта, их причины и влияние на критический путь. Помогает оценить перенос сроков и подготовить расчёт для требования о продлении. CX Codex +1 132установок pdf-report-generator Скилл pdf-report-generator автоматизирует создание PDF-отчётов из данных строительных проектов. Собирает графики, таблицы и ключевые показатели в оформленный документ — без ручного монтажа. CX Codex +1 132установок rfi-management Скилл rfi-management управляет запросами на информацию (RFI) на стройке: регистрирует обращения в Excel, отслеживает дедлайны и фиксирует задержки графика. CX Codex +1 131установок safety-compliance-checker Скилл safety-compliance-checker для Claude Code автоматически проверяет соблюдение норм безопасности на стройплощадках. Отслеживает СИЗ, доступ в зоны и работу на высоте, формирует отчёты о нарушениях. CX Codex +1 131установок daily-report-generator Скилл daily-report-generator собирает данные со строительной площадки — погоду, рабочие часы, прогресс — и генерирует профессиональные PDF-отчёты. Экономит 45–60 минут в день на ручное составление документов. CX Codex +1 130установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой