72 lines
2.5 KiB
Markdown
72 lines
2.5 KiB
Markdown
# 当前实现状态
|
|
|
|
> 本文是可覆盖的当前快照，记录代码与任务看板的现实状态，帮助 AI coding agent 避免只看计划而忽略仓库现状。
|
|
|
|
## 职责边界
|
|
|
|
- [`06-tasks.md`](06-tasks.md)：任务看板，维护任务状态、依赖和验收要点。
|
|
- [`../progress.md`](../progress.md)：执行流水，只追加记录每轮执行、验证、阻塞和决策。
|
|
- `current-state.md`：当前快照，可覆盖更新当前目录、当前命令、已完成摘要和下一步。
|
|
|
|
## 当前快照
|
|
|
|
- 日期：2026-07-06
|
|
- 阶段：MVP 起步前，harness 文档已初始化
|
|
- 技术栈：目标为 Wagtail + Django + Python 3.12 + SQLite
|
|
- 生产代码：尚未初始化
|
|
- 测试：尚未初始化
|
|
- 数据：尚未建立 seed 数据；未来通过 Wagtail 后台录入首批项目
|
|
- 标准启动路径：`init.ps1` / `init.sh` 尚未配置真实命令
|
|
- 标准验证路径：生产代码初始化后补齐
|
|
- 当前 blocker：未初始化 Wagtail 项目骨架；下一步执行 `T-001`
|
|
|
|
## 当前目录要点
|
|
|
|
| 路径 | 状态 | 说明 |
|
|
| --- | --- | --- |
|
|
| `docs/` | 已有 | harness coding 文档和项目需求 / 方案。 |
|
|
| `AGENTS.md` | 已有 | AI agent 仓库入口。 |
|
|
| `CLAUDE.md` | 已有 | Claude Code 薄入口。 |
|
|
| `progress.md` | 已有 | 只追加执行流水。 |
|
|
| `init.ps1` / `init.sh` | 已有，占位 | T-001 初始化生产代码后替换真实命令。 |
|
|
| `manage.py` | 待建 | Wagtail/Django 入口。 |
|
|
| `requirements.txt` | 待建 | Python 依赖。 |
|
|
| `skelet/` | 待建 | Django 项目配置。 |
|
|
| `core/` | 待建 | Wagtail 页面模型、模板和静态资源。 |
|
|
| `tests/` | 待建 | 测试目录。 |
|
|
|
|
## 任务看板状态
|
|
|
|
- 已完成：`T-000 初始化 harness 文档`。
|
|
- 正在进行：无。
|
|
- 下一个可领取任务：`T-001 初始化 Wagtail 项目骨架`。
|
|
|
|
## 当前可运行内容
|
|
|
|
```powershell
|
|
# 当前只能做文档检查
|
|
Get-ChildItem -Recurse -File
|
|
```
|
|
|
|
生产应用命令待 T-001 初始化后补齐：
|
|
|
|
```powershell
|
|
# 目标形态
|
|
.\.venv\Scripts\python manage.py check
|
|
.\.venv\Scripts\python manage.py test
|
|
.\.venv\Scripts\python manage.py runserver
|
|
```
|
|
|
|
## 开始编码前检查
|
|
|
|
1. 读仓库级 agent 规则文件。
|
|
2. 读 `docs/00-ai-start-here.md`。
|
|
3. 读 `docs/05-coding-rules.md`。
|
|
4. 在 `docs/06-tasks.md` 取第一个 `TODO` 且依赖均 `DONE` 的任务。
|
|
5. 将该任务状态改为 `DOING`。
|
|
|
|
## 维护规则
|
|
|
|
当实际代码状态发生变化时，同步更新本文件、`docs/06-tasks.md` 和 `progress.md`。
|
|
|