AI 工具的正确使用姿势:plan mode、Task List 与 note-it 的边界

# 改之前
def process_data(data: List[Dict]) -> Dict:
    ...

# 改之后——签名都变了
def process_data(data: DataFrame) -> DataFrame:
    ...

# 不只是改一个函数
src/service/api.py          # API 层
src/service/business.py     # 业务逻辑层
src/repository/database.py  # 数据访问层
tests/test_api.py            # 测试

# 改之前
if user.age > 18:
    return True

# 改之后
if user.age >= 18:
    return True

改动涉及公共 API？
├─ 是 → plan mode
└─ 否 → 继续

改动跨多个文件？
├─ 是 → plan mode
└─ 否 → 继续

需求是否含糊？
├─ 是 → plan mode
└─ 否 → 直接改

自己是否还没想清楚？
├─ 是 → plan mode
└─ 否 → 直接改

## Task List
- [x] 分析代码结构
- [ ] 重构 API 层
- [ ] 更新测试
- [ ] 提交 PR

# Issue: 重构用户认证系统

## Day 1
- [x] 分析现有认证流程
- [x] 设计新的认证架构

## Day 2
- [ ] 实现新的认证中间件
- [ ] 更新所有 API 端点

## Day 3
- [ ] 编写测试
- [ ] 部署到 staging
- [ ] 性能测试

# Issue: 实现 payment webhook

## TODO
- [ ] @alice 设计 webhook schema
- [ ] @bob 实现接收端点
- [ ] @charlie 编写测试
- [ ] @alice 部署和监控

这个功能能今天完成吗？
├─ 是 → 会话级 Task List
└─ 否 → 继续

需要别人接手吗？
├─ 是 → Issue
└─ 否 → 继续

需要跨多天吗？
├─ 是 → Issue
└─ 否 → 会话级 Task List

# 为什么不用缓存？
# note-it: Redis 在这个环境里不可用，跨云部署成本太高。
# 暂时用内存缓存，等基础设施到位再迁移。

def get_user(user_id: int) -> User:
    # 直接查数据库，不用缓存
    return db.query(User).filter_by(id=user_id).first()

为什么选 A 方案不选 B？
- A 方案性能更好（O(n) vs O(n²)）
- B 方案需要引入新依赖，增加维护成本
- A 方案代码更简单，易于理解

# spec 要求返回 List[Dict]
# note-it: 改成返回 DataFrame 是因为下游需要用 pandas 处理
# 如果其他调用方不需要，可以考虑加个 adapter
def process_data() -> DataFrame:
    ...

# 为什么不用多线程？
# note-it: 这里的数据库连接池不支持并发，多线程会导致连接泄漏
# 等升级到支持 asyncio 的驱动再考虑并行化

# note-it: 这是一个临时的 workaround
# 根本问题是第三方 API 的 bug，已经提了 issue
# 等 API 修复后需要移除这段代码
def workaround_api_bug():
    ...

# note-it: 这里用 C 扩展是因为 Python 版本太慢（100ms vs 5ms）
# 如果有更快的纯 Python 实现，可以考虑替换
import fast_c_extension

## 做这个决定时，我记了吗？

- [ ] 为什么选这个方案？
- [ ] 为什么不用其他方案？
- [ ] 有什么权衡？
- [ ] 有什么风险？
- [ ] 未来需要改进吗？

这个改动需要 plan mode 吗？
├─ 公共 API？→ 需要
├─ 跨多个文件？→ 需要
├─ 需求含糊？→ 需要
├─ 自己没想清楚？→ 需要
└─ 否 → 直接改

这个任务需要落 Issue 吗？
├─ 跨天？→ Issue
├─ 跨人？→ Issue
└─ 否 → Task List

这个决策需要 note-it 吗？
├─ 偏离 spec？→ 需要
├─ 绕开方案？→ 需要
├─ 技术债务？→ 需要
├─ 性能关键？→ 需要
└─ 否 → 可选