49 lines
2.2 KiB
Markdown
49 lines
2.2 KiB
Markdown
# AI 开发入口
|
|
|
|
> 给 AI coding agent 的每轮开工流程。项目定位、必读顺序、工作规则、技术边界的唯一权威版本在 [`../AGENTS.md`](../AGENTS.md)，本文不重复；硬性编码规则见 [`05-coding-rules.md`](05-coding-rules.md)。
|
|
|
|
## 固定开工流程
|
|
|
|
1. `pwd`：确认在仓库根目录（标准开发环境为 WSL/Linux，路径 `/mnt/d/opc_project/skelet`）。
|
|
2. 读 [`../progress.md`](../progress.md) 和 [`current-state.md`](current-state.md)。
|
|
3. 运行 `git log --oneline -5`，了解最近提交。
|
|
4. 运行 `init.sh` 或手动执行标准验证命令。
|
|
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。
|
|
|
|
不要把聊天记录、临时实验目录、未被任务引用的草稿或第三方模板默认示例数据当事实来源。
|
|
|
|
## 验证命令
|
|
|
|
```bash
|
|
.venv/bin/python3.12.exe manage.py check
|
|
.venv/bin/python3.12.exe manage.py test
|
|
.venv/bin/python3.12.exe manage.py runserver
|
|
```
|
|
|
|
`init.sh` 为标准启动与验证入口。
|