Update documentation from Claude Code

This commit is contained in:
QiuSW
2026-07-06 11:32:35 +08:00
parent fae7fda88c
commit 53d6430ea0
22 changed files with 345 additions and 423 deletions
+8 -50
View File
@@ -2,59 +2,17 @@
Skelet 是一个面向 AI coding 开发者、独立开发者和小团队的开源项目骨架导航与评测网站。
第一版目标是把“我应该基于哪个稳定骨架开始新项目”这个决策做清楚:按场景分类,按语言和框架筛选,提供骨架项目详情、AI Coding 友好度评分、适用/不适用场景和基础对比。
第一版目标是把"我应该基于哪个稳定骨架开始新项目"这个决策做清楚:按场景分类,按语言和框架筛选,提供骨架项目详情、AI Coding 友好度评分、适用/不适用场景和基础对比。第一版为英文单语言站点,主打"AI Coding 友好度"这一差异化角度(决策依据见 [`business/content-strategy.md`](business/content-strategy.md))。
## 当前状态
当前仓库只完成 harness coding 文档初始化,尚未初始化生产代码。
当前仓库只完成 harness coding 文档初始化,尚未初始化生产代码。下一步任务见 [`docs/06-tasks.md`](docs/06-tasks.md):先初始化 Wagtail 项目骨架(`T-001`),再实现内容模型和 MVP 页面。
下一步任务见 [`docs/06-tasks.md`](docs/06-tasks.md):先初始化 Wagtail 项目骨架,再实现内容模型和 MVP 页面。
## 入口
## 技术方案摘要
| 维度 | 第一版选择 |
| --- | --- |
| 后端 / CMS | Wagtail |
| Web 框架 | Django |
| Python | 3.12 |
| 数据库 | SQLite with JSON1 |
| 部署目标 | 2 核 2G VPS 可运行 |
| 账号体系 | 第一版只使用 Wagtail 管理后台账号 |
| 前台用户注册 | MVP 不做 |
详细选型见 [`docs/03-tech-stack.md`](docs/03-tech-stack.md),架构见 [`docs/04-architecture.md`](docs/04-architecture.md)。
## 文档入口
- [`AGENTS.md`](AGENTS.md):Codex / 通用 AI coding agent 仓库级入口。
- [`CLAUDE.md`](CLAUDE.md):Claude Code 薄入口。
- [`docs/00-ai-start-here.md`](docs/00-ai-start-here.md):每轮 AI 开发入口。
- [`docs/01-vision.md`](docs/01-vision.md):项目愿景和非目标。
- [`docs/02-requirements.md`](docs/02-requirements.md):MVP 需求与验收标准。
- [`docs/03-tech-stack.md`](docs/03-tech-stack.md):技术栈、运行命令、依赖纪律。
- [`docs/04-architecture.md`](docs/04-architecture.md):系统结构、数据模型、开发顺序。
- [`docs/05-coding-rules.md`](docs/05-coding-rules.md):AI 编码硬规则。
- [`docs/06-tasks.md`](docs/06-tasks.md):任务看板。
- [`progress.md`](progress.md):执行历史流水。
- [`docs/current-state.md`](docs/current-state.md):当前实现状态快照。
- [`business/`](business/):商业计划书、商业模式、市场分析和增长方案。
## 开发原则
- 先内容闭环,再商业化。
- 先场景分类,再语言筛选。
- 先 Wagtail + SQLite 上线验证,再按需要迁移 PostgreSQL。
- 第一版不做用户注册、评论、收藏、付费会员和复杂搜索。
- 每轮 AI coding 只领取一个任务,完成后更新任务状态、进度和当前状态。
## 标准开工方式
生产代码尚未初始化,因此根目录 `init.ps1` / `init.sh` 仍保留模板占位命令。完成 `T-001` 后必须替换脚本顶部安装、验证和启动命令,并同步更新:
- [`docs/00-ai-start-here.md`](docs/00-ai-start-here.md)
- [`docs/03-tech-stack.md`](docs/03-tech-stack.md)
- [`docs/05-coding-rules.md`](docs/05-coding-rules.md)
- [`docs/current-state.md`](docs/current-state.md)
在此之前,任何 agent 不得宣称项目“可运行”。
- [`AGENTS.md`](AGENTS.md):所有 AI coding agent 的**唯一权威入口**——项目定位、必读顺序、工作规则、技术边界、开发环境和验证方式统一维护在这里。
- [`CLAUDE.md`](CLAUDE.md):Claude Code 薄入口,指向 `AGENTS.md`。
- [`docs/README.md`](docs/README.md):全部产品与工程文档导航。
- [`business/`](business/):商业计划、内容策略、变现方案、竞品分析。
技术选型摘要、开发原则和开工方式不在本文重复维护,以 `AGENTS.md` 和 `docs/` 为准。