Metadata-Version: 2.5
Name: specpro-cli
Version: 0.1.1
Summary: Install specpro's distributed assets into a host project, for one of the supported AI coding agents.
Project-URL: Homepage, https://github.com/wutone55/specpro
Project-URL: Repository, https://github.com/wutone55/specpro
Project-URL: Issues, https://github.com/wutone55/specpro/issues
Author: Wu Wantong
License-Expression: MIT
License-File: LICENSE
Keywords: ai-coding,claude,development-workflow,sdd,spec-driven,specification
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.11
Requires-Dist: click
Requires-Dist: pathspec
Requires-Dist: pyyaml
Requires-Dist: rich
Requires-Dist: typer
Description-Content-Type: text/markdown

# Spec Pro

Better Spec-Driven Development Toolkit for AI Coding Agents.

specpro 把一套规范驱动开发（SDD）工作流装进你的项目：16 个斜杠命令（`/specpro-specify`、`/specpro-plan`、`/specpro-tasks`、`/specpro-implement`……）驱动 AI 编程助手按「规格 → 设计 → 任务 → 实现 → 测试」的链条交付功能，并自带核验器保证产物不漂移。

**需要**：一个 git 项目 + 至少一个受支持的 AI 编程助手（Claude Code / Copilot / Cursor / Gemini CLI / OpenCode / Qoder）。

---

## 安装（推荐：uv tool，约 30 秒）

### 第 0 步 · 安装 uv（各平台任选其一）

```bash
# macOS / Linux（官方脚本）
curl -LsSf https://astral.sh/uv/install.sh | sh

# macOS（Homebrew）
brew install uv

# Windows（PowerShell）
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Windows（winget）
winget install astral-sh.uv
```

> uv 会自动管理 Python 解释器——**你不需要预装 Python**。

### 第 1 步 · 安装 specpro-cli

**从本地 whl（离线包）：**

```bash
uv tool install ./specpro_cli-*.whl
```

**从 PyPI（在线）：**

```bash
uv tool install specpro-cli
```

### 第 2 步 · 验证

```bash
specpro --help
```

看到 SPEC PRO 头图与命令列表即安装成功。

---

## 使用

```bash
cd 你的项目
specpro init          # 交互式：确认目录 → 选择 AI 助手 → 装入工作流
specpro check         # 自检：git 与各助手 CLI 是否就绪、项目内已装了什么
specpro version       # 版本与系统信息
```

`init` 完成后，在 AI 编程助手里即可使用 `/specpro-specify` 等斜杠命令。

---

## 升级与卸载

```bash
uv tool upgrade specpro-cli          # 升级到最新版
uv tool list                         # 查看已装工具
uv tool uninstall specpro-cli        # 卸载（只移除 CLI；项目内已装入的文件用 specpro remove 清理）
```

---

## 备选：手动 venv 安装（不使用 uv 时）

```bash
python3 -m venv ~/.specpro-venv
~/.specpro-venv/bin/pip install ./specpro_cli-*.whl
~/.specpro-venv/bin/specpro init     # 每次调用需带完整路径
```

---

**License**: MIT · **Repository**: https://github.com/wutone55/specpro
