Add harness coding documentation

This commit is contained in:
QiuSW
2026-07-06 10:25:29 +08:00
commit f68d443c0d
23 changed files with 1336 additions and 0 deletions
+71
View File
@@ -0,0 +1,71 @@
# 当前实现状态
> 本文是可覆盖的当前快照,记录代码与任务看板的现实状态,帮助 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`。