skelet/AGENTS.md

AGENTS.md

Codex / AI coding agent 的仓库级入口。进入本仓库后，先读本文，再进入 docs/00-ai-start-here.md。

项目定位

Skelet 是一个介绍、分类、评测开源项目骨架的网站。目标用户是希望用 AI coding 更快启动项目的开发者、独立开发者和小团队。

第一版不是 SaaS 产品，也不是模板市场；它是一个内容和结构化目录优先的网站，帮助用户按“场景”找到合适骨架，再用“语言 / 框架 / AI 友好度”等维度筛选。

当前阶段

当前仓库处于 harness 文档初始化阶段，生产代码尚未初始化。

下一步从 docs/06-tasks.md 领取 T-001：初始化 Wagtail 项目骨架。

必读顺序

每次开始工作前，按顺序读取：

1. README.md：了解项目定位和当前状态。
2. docs/00-ai-start-here.md：进入 AI 开发流程。
3. docs/01-vision.md：理解为什么做、为谁做、什么不做。
4. docs/02-requirements.md：理解 MVP 功能和验收标准。
5. docs/03-tech-stack.md：确认 Wagtail / Django / Python / SQLite 选型。
6. docs/04-architecture.md：确认系统结构、数据模型、开发顺序。
7. docs/05-coding-rules.md：确认编码硬规则。
8. docs/06-tasks.md：领取唯一任务。
9. progress.md 和 docs/current-state.md：恢复历史执行和当前快照。

工作规则

• 每轮只做 docs/06-tasks.md 中第一个状态为 TODO 且依赖均为 DONE 的任务。
• 生产代码未初始化前，不要添加业务功能文件，不要伪造可运行状态。
• 任何技术选型变化必须先更新 docs/03-tech-stack.md 和 docs/04-architecture.md。
• 任何需求范围变化必须先更新 docs/02-requirements.md。
• 完成任务前必须运行对应验证命令，并把结果追加到 progress.md。
• 任务状态变化必须同步 docs/06-tasks.md 和 docs/current-state.md。
• 不写真实密钥、账号、token、私有服务地址。

默认技术边界

• 第一版使用 Wagtail + Django + Python 3.12 + SQLite。
• 第一版只需要 Wagtail 管理后台账号，不做前台用户注册。
• 第一版数据库使用 SQLite with JSON1，并启用 WAL 作为上线前建议。
• 第一版部署目标是 2 核 2G VPS。
• 出现高写入功能、用户系统、频繁提交、评论、收藏、会员或 database is locked 后，再迁移 PostgreSQL。

验证

当前仓库是文档阶段，生产应用尚不可运行。文档修改后至少检查文件清单，并确认根入口不再误称模板库。

Get-ChildItem -Recurse -File

完成 T-001 后，必须配置 init.ps1 / init.sh 的真实命令，并以后以脚本作为标准启动与验证入口。