AgentSkillsCN

smb-automation

为QuickBooks、ShipStation以及支付处理构建中小企业业务自动化工作流。在构建客户自动化工作流、销售转发票的业务流程,或库存管理系统时使用此功能。

SKILL.md
--- frontmatter
name: smb-automation
description: SMB business automation workflows for QuickBooks, ShipStation, and payment processing. Use when building client automation workflows, sales-to-invoice pipelines, or inventory management systems.

SMB Automation Skill

When to Use

  • Creating sales form to QuickBooks invoice workflows
  • Building inventory sync and alert systems
  • Implementing shipping automation with ShipStation
  • Setting up payment processing with Stripe/PayPal

3-Layer Architecture (from CLAUDE.md)

Layer 1: Directives (What to do)

  • SOPs in directives/ folder
  • Natural language instructions like for a mid-level employee
  • Define goals, inputs, tools/scripts to use, outputs, edge cases

Layer 2: Orchestration (You - Decision making)

  • Read directives, call execution tools in the right order
  • Handle errors, ask for clarification
  • Update directives with learnings

Layer 3: Execution (Doing the work)

  • Deterministic scripts in execution/
  • Handle API calls, data processing
  • Reliable, testable, fast

Available Directives

DirectivePurpose
directives/sales-to-qbo.mdForm submission → validate → inventory check → QBO invoice
directives/onboard_client.mdWelcome email + calendar scheduling
directives/manage_clients.mdClient lifecycle management
directives/prevent_contact_form_spam.mdForm validation and spam prevention

Execution Scripts

ScriptPurpose
execution/create_client.pyCreate client folders with structure
execution/onboard_client.pyComplete onboarding workflow
execution/send_email.pySMTP/Resend email delivery
execution/list_clients.pyList managed clients
execution/log_activity.pyActivity logging
execution/create_calendar_link.pyGenerate scheduling links

Key Integrations

  • QuickBooks Online - OAuth, invoices, inventory
  • ShipStation - Shipping labels, order sync
  • Stripe/PayPal - Payment processing, webhooks
  • Resend/SMTP - Email delivery

Safety Rules (from CLAUDE.md)

  • QBO sandbox first, inventory check before invoice
  • Zod/Pydantic validation on ALL inputs
  • .env.example only, no stored credentials
  • Log every API call, notify on failure
  • Dry-run + 80% coverage before delivery

Agent Plugins Available

The following plugins from agents/plugins/ are relevant:

  • payment-processing - Stripe integration, webhooks, PCI compliance
  • backend-development - API design, microservices patterns
  • python-development - FastAPI, async patterns, testing
  • data-validation-suite - Input validation with Pydantic/Zod
  • api-scaffolding - FastAPI/Django project templates
  • customer-sales-automation - Sales outreach, CRM patterns