skelet/docs/00-ai-start-here.md

AI 开发入口

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

固定开工流程

1. pwd：确认在仓库根目录（标准开发环境为 WSL/Linux，路径 /mnt/d/opc_project/skelet）。
2. 读 ../progress.md 和 current-state.md。
3. 运行 git log --oneline -5，了解最近提交。
4. 运行 init.sh 或手动执行标准验证命令。
5. 如果基线已坏，先修基线，不在坏的起点上叠新功能。
6. 基线绿了，再从 06-tasks.md 领取唯一任务。

领取任务规则

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

MVP 边界

MVP 功能范围以 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。

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

验证命令

.venv/bin/python3.12 manage.py check
.venv/bin/python3.12 manage.py test
.venv/bin/python3.12 manage.py runserver

init.sh 为标准启动与验证入口。