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

AI 开发入口

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

固定开工流程

1. pwd：确认在仓库根目录（标准开发环境为 WSL/Linux，路径 /mnt/d/OPC/skelet）。
2. 读 ../progress.md 和 current-state.md。
3. 运行 git log --oneline -5，了解最近提交。
4. 如果 init.sh 已配置真实命令，运行标准验证；如果脚本仍是占位，先完成 T-001。
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。

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

验证命令

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

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。