OpenSpec 完全使用指南：AI 时代的规范驱动开发

/opsx:propose "创建一个简单的天气查询命令行工具"

## Why
在终端快速查看天气，不需要打开浏览器或手机。
​
## What Changes
- 新增 weather-cli 命令行工具
- 支持 weather <城市名> 和 weather --help
​
## Impact
- 新增文件：weather.py
- 无外部依赖（仅用 Python 标准库）

## Requirement: 城市天气查询
系统应接受城市名并返回当前天气。
​
Scenario: 有效城市名
- WHEN 运行 weather London
- THEN 显示伦敦的天气
​
Scenario: 含空格的城市名
- WHEN 运行 weather "New York"
- THEN 正确显示纽约天气
​
Scenario: 无效城市名
- WHEN 运行 weather xyzxyzxyz
- THEN 显示友好错误信息

## Context
零依赖的命令行天气查询工具。
​
## Goals / Non-Goals
- Goals: 城市名查询、--help、错误处理、零依赖
- Non-Goals: 自动定位、GUI、持久化
​
## Decisions
- 使用 wttr.in API（免费、无需 API Key）
- 只用 Python 标准库
- 纯文本输出
​
## Risks / Trade-offs
- [API 可能被限流] → 添加超时处理
- [城市名含空格] → 支持引号包裹

## 1. Core Implementation
- [ ] 1.1 实现天气查询函数
- [ ] 1.2 添加 CLI 参数解析
- [ ] 1.3 添加错误处理
​
## 2. Testing
- [ ] 2.1 测试有效城市名
- [ ] 2.2 测试多词城市名
- [ ] 2.3 测试错误处理

/opsx:apply weather-cli

Working on task 1/6: 实现天气查询函数   ✓
Working on task 2/6: 添加 CLI 参数解析   ✓
Working on task 3/6: 添加错误处理       ✓
Working on task 4/6: 测试有效城市名     ✓
...

# weather.py
def fetch_weather(city: str) -> str:
    url = f"https://wttr.in/{quote(city)}?format=%C+%t&lang=zh"
    ...
​
def main():
    parser = argparse.ArgumentParser(description="命令行天气查询工具")
    parser.add_argument("city", nargs="?", help="城市名称")
    ...

# test_weather.py
class TestFetchWeather(unittest.TestCase):
    def test_fetch_valid_city(self): ...
    def test_fetch_multi_word_city(self): ...
    def test_network_error(self): ...

/opsx:archive weather-cli

/opsx:propose "用户认证模块"
/opsx:propose "数据模型层"
/opsx:propose "API 路由层"

/opsx:explore
→ "我在做一个笔记应用，但不确定选本地存储还是云端同步..."
→ （AI 引导你梳理关键决策点）
→ 思路清晰后退出
/opsx:propose "本地 Markdown 笔记应用"

执行到一半发现 API 设计不合理
→ 修改 spec 文件
→ 继续 apply，AI 按新 spec 调整代码

openspec list
→ weather-cli (in-progress) 6/6
→ add-todo-api (in-progress) 3/8
→ md-notes (draft)

openspec status --change "add-todo-api"  # 查看具体进度