# AI 开发入口

> 给 AI coding agent 的每轮开工流程。项目定位、必读顺序、工作规则、技术边界的唯一权威版本在 [`../AGENTS.md`](../AGENTS.md)，本文不重复；硬性编码规则见 [`05-coding-rules.md`](05-coding-rules.md)。

## 固定开工流程

1. `pwd`：确认在仓库根目录（标准开发环境为 WSL/Linux，路径 `/mnt/d/OPC/skelet`）。
2. 读 [`../progress.md`](../progress.md) 和 [`current-state.md`](current-state.md)。
3. 运行 `git log --oneline -5`，了解最近提交。
4. 如果 `init.sh` 已配置真实命令，运行标准验证；如果脚本仍是占位，先完成 `T-001`。
5. 如果基线已坏，先修基线，不在坏的起点上叠新功能。
6. 基线绿了，再从 [`06-tasks.md`](06-tasks.md) 领取唯一任务。

## 领取任务规则

- 只领取第一个状态为 `TODO` 且依赖均为 `DONE` 的任务。
- 开始前把该任务状态改为 `DOING`。
- 本轮只完成这一个任务。
- 验收通过后把状态改为 `DONE`。
- 完成后把执行记录追加到 [`../progress.md`](../progress.md)，并覆盖更新 [`current-state.md`](current-state.md)。
- 结束会话前过一遍 [`clean-state-checklist.md`](clean-state-checklist.md)。
- 做完即停，汇报验证结果。

## MVP 边界

MVP 功能范围以 [`02-requirements.md`](02-requirements.md) 为唯一权威，本文不重复清单。一句话版本：只做场景分类、筛选、详情页、文章、后台维护和基础 SEO；不做用户系统、支付、自动抓取、复杂搜索、多语言。

## 事实来源

项目事实只信：

- `docs/02-requirements.md` 的 MVP 需求与验收标准。
- `docs/03-tech-stack.md` 的技术选型。
- `docs/04-architecture.md` 的数据模型、评分维度和模块边界。
- `docs/api.md` 的公开接口和后台边界。
- 未来代码中的 Wagtail models、migrations、templates 和 tests。

不要把聊天记录、临时实验目录、未被任务引用的草稿或第三方模板默认示例数据当事实来源。

## 验证命令

生产代码尚未初始化。完成 `T-001` 后，将以下目标命令替换为真实可运行命令：

```bash
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python manage.py migrate
.venv/bin/python manage.py runserver
```

`T-001` 完成后，必须同步更新 `init.sh`（`init.ps1` 可选）、`03-tech-stack.md`、`05-coding-rules.md` 和 `current-state.md`。