Skill: ProtoHub AI Agent Integration

Purpose

This skill allows AI Agents to manage prototypes on ProtoHub. It provides automated tools for packaging, publishing, and discovering prototypes (folders or ZIP files) in the ProtoHub Private Sandbox.

Capabilities

• Automated Publishing: Package a directory or use a ZIP file to create/update prototypes.
• Entry Point Validation: Automatically checks for index.html before uploading.
• Prototype Discovery: List existing prototypes or search by name to find IDs.
• Preview Management: Retrieve public URLs for demonstration.

Recommended Tool: publish.py

The project provides a dedicated Python script skills/tc-protohub/scripts/publish.py for all ProtoHub operations.

Configuration

The system supports multiple API Key types:

1. Database Key: Generated in the "AI Agent Key" management menu (ProtoAgentKeyDO).

Set your API Key and Base URL as environment variables:

export PROTOHUB_API_KEY="your-api-key"
export PROTOHUB_URL="http://localhost:48080" # 或者实际的后端地址

Usage Examples

1. Upload a Directory as a New Prototype

python skills/tc-protohub/scripts/publish.py publish ./my-dist-folder --name "My Prototype Name"

2. Update an Existing Prototype

Overwrites content while maintaining the same ID and URL.

python skills/tc-protohub/scripts/publish.py publish ./my-dist-folder --id 1024

3. List Prototypes (Search by Name)

Useful for finding the ID when the user says "Update the 'Login Page' prototype".

python skills/tc-protohub/scripts/publish.py list --name "Login Page"

4. Get Preview Link

python skills/tc-protohub/scripts/publish.py get-link 1024

Best Practices

• Folder Structure: Ensure index.html is at the root of your directory or ZIP file.
• Intelligent Updating:
  • If the user asks to "update" a prototype but doesn't provide an ID, use publish.py list --name "..." to find a matching prototype first.
  • If exactly one match is found, use its ID to perform the update.
  • If multiple or no matches are found, ask the user for clarification or create a new one.
• API Base URL: Default is http://localhost:48080. Override using the PROTOHUB_URL env var or --url flag.
• Error Handling:
  • 401 Unauthorized: API Key is missing or invalid.
  • 404 Not Found: The specified prototypeId does not exist.
  • Missing index.html: The script will abort the upload to prevent broken previews.