Files
skelet/README.md
T
2026-07-06 10:50:57 +08:00

61 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Skelet
Skelet 是一个面向 AI coding 开发者、独立开发者和小团队的开源项目骨架导航与评测网站。
第一版目标是把“我应该基于哪个稳定骨架开始新项目”这个决策做清楚:按场景分类,按语言和框架筛选,提供骨架项目详情、AI Coding 友好度评分、适用/不适用场景和基础对比。
## 当前状态
当前仓库只完成 harness coding 文档初始化,尚未初始化生产代码。
下一步任务见 [`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 不得宣称项目“可运行”。