Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

acp-setup

/acp-setup

Tworzy od podstaw projekt serwera handlowego ACP: instaluje zależności, importuje specyfikacje OpenAPI i tworzy wstępne punkty końcowe.

Licencja
MIT
Ostatnia zmiana repozytorium
14.09.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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 14.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Tworzy od podstaw projekt serwera handlowego ACP: instaluje zależności, importuje specyfikacje OpenAPI i tworzy wstępne punkty końcowe.

Oryginalny opis (EN)

Scaffold an ACP merchant server project — install dependencies, import OpenAPI specs and JSON schemas, configure environment, and create initial endpoint stubs. Use when starting a new ACP implementation from scratch.

Jak działa

  1. Before writing code
  2. What This Skill Does
  3. Configuration Essentials
  4. Project Structure Pattern
Sekcje z nagłówków SKILL.md, w oryginale · 54 linii, 345 słów
Podgląd SKILL.md
---
name: acp-setup
description: Scaffold an ACP merchant server project — install dependencies, import OpenAPI specs and JSON schemas, configure environment, and create initial endpoint stubs. Use when starting a new ACP implementation from scratch.
allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch
---

# ACP Project Setup

## Before writing code

1. **Fetch the latest spec version**: Web-search `site:github.com agentic-commerce-protocol CHANGELOG` for the current spec version
2. **Fetch the OpenAPI specs**: Fetch from `https://github.com/agentic-commerce-protocol/agentic-commerce-protocol/tree/main/spec` — download the latest versioned checkout and delegate-payment OpenAPI YAML files
3. **Fetch the get-started guide**: Fetch `https://developers.openai.com/commerce/guides/get-started/` for onboarding steps
4. **Check for SDK packages**: Search PyPI for `agentic-commerce-protocol` and npm for ACP-related packages. Note: there is no official standalone SDK — most implementations use the OpenAPI spec directly or reference implementations like Medusa.js

## What This Skill Does

Scaffolds a new ACP merchant server project:

1. **Detect language/framework** — Python (FastAPI/Flask/Django), TypeScript (Express/Fastify/Medusa), Go, etc.
2. **Install dependencies** — HTTP framework, JSON schema validation, HMAC library, UUID generation
3. **Import OpenAPI spec** — Download the latest versioned spec from the GitHub repo
4. **Create configuration** — Environment variables for API keys, webhook secrets, API version, PSP credentials
5. **Stub endpoints** — Create route stubs for the 5 checkout operations + webhook receiver
6. **Set up middleware** — Bearer token auth, idempotency key extraction, API version header validation, request logging

## Configuration Essentials

These must be externalized (env vars or config file):
- `ACP_API_KEY` — Bearer token for authentication
- `ACP_API_VERSION` — Spec version (YYYY-MM-DD format)
- `ACP_WEBHOOK_SECRET` — HMAC signing key for webhooks
- `STRIPE_API_KEY` — If using Stripe as PSP for delegated payment
- `ACP_MERCHANT_ID` — Merchant identifier for SPT scoping

## Project Structure Pattern

```
merchant-server/
├── config/                  # Environment and settings
├── routes/
│   ├── checkout.py/ts       # 5 checkout endpoints
│   ├── webhooks.py/ts       # Webhook receiver
│   └── health.py/ts         # Health check
├── middleware/
│   ├── auth.py/ts           # Bearer token validation
│   ├── idempotency.py/ts    # Idempotency key handling
│   └── versioning.py/ts     # API-Version header validation
├── models/                  # Data models from JSON schema
├── services/
│   ├── checkout.py/ts       # Business logic
│   ├── payment.py/ts        # PSP integration
│   └── inventory.py/ts      # Stock management
├── schemas/                 # OpenAPI + JSON schemas
└── tests/
```

Fetch the OpenAPI spec for exact endpoint paths, request/response shapes, and status codes before generating stubs.

Wersje

W bazie nie ma innych skilli o nazwie acp-setup.

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

  • 100acp-checkout-rest
    Wdraża REST API procesu zakupowego ACP: tworzenie, aktualizację, pobieranie, zakończenie i anulowanie sesji zakupowej.
  • 100acpremote
    Udostępnia agentów ACP lub komendy stdio ACP przez WebSocket, odzwierciedlając zdalne endpointy ACP lokalnie, z obsługą uwierzytelniania i tras metadanych.
  • 100acp-repo-template
    Zakłada nowe repozytorium super-repo ACP i stosuje domyślne ustawienia GitHub oraz regułę gałęzi.
  • 100acp-service
    Zarządza sesjami ACP i wtyczkami DSH przez @1agents/acp-service: wywołuje role, zleca zadania i zbiera wyniki.
  • 90acp-conformance
    Waliduje implementację ACP względem specyfikacji: schematy, testy przepływów, obsługę błędów, idempotencję, kontrole bezpieczeństwa i gotowość produkcyjną.
  • 100reset-cursor-acp
    Resetuje zawieszony wątek Cursor ACP w aplikacji czatu i przeładowuje konfigurację, wyłącznie na wyraźne wywołanie.

Uwagi i zgłoszenia

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