docs: 补全 AI 入口/API/路由/现状文档并对齐一致性

新增(Codex 起草,本次纳入并校对):
- AGENTS.md:仓库级 AI 强约束入口
- docs/00-ai-start-here.md:AI 开发入口与导航
- docs/api.md:账号/生词本/进度 API 合约草案
- docs/routes.md:go-app 页面路由与组件归属
- docs/current-state.md:当前实现状态

补充与对齐:
- 验证命令补 bash(WSL/Linux 为主,PowerShell 为备):00-ai-start-here、AGENTS
- 04-architecture:新增第六节"项目结构(包布局)"+ 3.2 建表 SQL 草案
- docs/README 导航补 06-tasks;CLAUDE 目录树补 AGENTS/scripts/design_mockups
- 00-ai-start-here 去除已过时的"需要补齐"段
- 06-tasks:Phase 2/3/4/5 交叉引用 api.md / routes.md / 包布局

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ila
2026-06-21 19:30:14 +08:00
co-authored by Claude Opus 4.8
parent 39713eb8ac
commit b9bcbf7e6b
11 changed files with 710 additions and 13 deletions
+9
View File
@@ -10,11 +10,16 @@
## 🗂 文档导航
- [AI 开发入口](00-ai-start-here.md) — AI coding agent 的阅读顺序、任务领取规则、验证命令
- [项目愿景](01-vision.md) — 为什么 / 为谁 / 产品原则 / 不做什么
- [需求](02-requirements.md) — 要什么 + 验收标准(产品语言,无技术词)
- [技术栈](03-tech-stack.md) — 用什么:框架 / 数据库 / UI / 状态管理 / 部署(速查)
- [架构设计](04-architecture.md) — 怎么搭:系统结构、职责划分、数据模型、技术难点
- [API 合约草案](api.md) — 账号、生词本、进度 API 的目标形状
- [路由与页面结构](routes.md) — go-app 页面路由、页面职责、组件归属
- [当前实现状态](current-state.md) — 仓库现实状态、当前可做任务、维护规则
- [编码规则](05-coding-rules.md) — 怎么写:AI 写代码前必读的硬约束
- [任务看板](06-tasks.md) — 做哪一步:MVP 任务拆解、依赖、状态(AI 的 Jira)
## ⚡ 当前阶段
@@ -25,3 +30,7 @@
- 前端:go-app (Go → WebAssembly),PWA 可安装 / 离线
- 后端:Go `net/http` + SQLite
- 素材:26 集英文文稿 + 逐句时间戳(音频覆盖 ep1–17,ep18–26 待补)
## 🤖 AI coding 入口
仓库级 AI 规则见根目录 [`../AGENTS.md`](../AGENTS.md);更详细的项目开发导航见 [AI 开发入口](00-ai-start-here.md)。