Metadata-Version: 2.4
Name: ai-ecom-skills
Version: 0.1.0
Summary: AI e-commerce skills for Qianchuan advertising operations, compatible with Codex/OpenClaw/Cursor
Author-email: north <your-email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/your-org/ai-ecom-skills
Project-URL: Repository, https://github.com/your-org/ai-ecom-skills
Project-URL: Documentation, https://github.com/your-org/ai-ecom-skills#readme
Keywords: ai,ecommerce,qianchuan,advertising,codex,openclaw,skills
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pydantic>=2.9.0
Requires-Dist: pydantic-settings>=2.6.0
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"

# ai-ecom-skills

AI e-commerce skills for Qianchuan (巨量千川) advertising operations.

Compatible with **Codex**, **OpenClaw**, and **Cursor**.

## Installation

```bash
pip install ai-ecom-skills
```

## Quick Start

```bash
# Install skill to all platforms (Codex/OpenClaw/Cursor)
ai-ecom-skills install --target all

# Set backend API URL
export BACKEND_API_BASE_URL=http://localhost:8080

# Restart your agent (Codex/OpenClaw/Cursor)
```

## CLI Commands

| Command | Description |
|---------|-------------|
| `ai-ecom-skills install --target all` | Install to all platforms |
| `ai-ecom-skills install --target codex` | Install to Codex only |
| `ai-ecom-skills install --target openclaw` | Install to OpenClaw only |
| `ai-ecom-skills uninstall --target all` | Uninstall from all platforms |
| `ai-ecom-skills list` | Show installation status |
| `ai-ecom-skills info` | Show skill information |

## Features

### Analysis Skills
- **ReviewSummarySkill** - Summarize execution results (before/after comparison)
- **RiskGuardrailSkill** - Check risk policies (kill_switch, budget limits)
- **ActionProposalDraftSkill** - Generate optimization proposals

### Fetch Skills
- **FetchPlanCoreContextSkill** - Fetch plan basic info
- **FetchPlanMetricsSkill** - Fetch daily metrics (ROI/cost/GMV)
- **FetchPlanHourlyMetricsSkill** - Fetch hourly metrics

### Execute Skills
- **ExecuteAdjustBudgetSkill** - Adjust plan budget
- **ExecuteAdjustBidSkill** - Adjust plan bid
- **ExecutePausePlanSkill** - Pause an ad plan

## Python Usage

```python
from ai_ecom_skills.skills.review_summary import ReviewSummarySkill
from ai_ecom_skills.schemas.agent import AgentTaskRequest

skill = ReviewSummarySkill()
request = AgentTaskRequest(
    targetId="plan-001",
    context={
        "metrics_before": {"roi": 2.5, "cost": 100.0},
        "metrics_after": {"roi": 3.8, "cost": 120.0},
        "execution_label": "提高预算 20%",
    },
)
suggestion = skill.run(request)
print(suggestion.summary)
```

## Requirements

- Python >= 3.11
- Backend API service running (for Fetch/Execute skills)

## License

MIT
