52 lines
2.4 KiB
Markdown
52 lines
2.4 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/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`。
|