Update documentation from Claude Code
This commit is contained in:
QiuSW
@@ -15,6 +15,8 @@ Skelet 的目标是帮助用户快速回答一个具体问题：我的项目应
|
||||
|
||||
第一版先做内容目录和评测闭环：按场景分类，按语言、框架、数据库和 AI 友好度筛选，提供骨架详情、适用/不适用场景、推荐理由和评分。
|
||||
|
||||
第一版为**英文单语言站点**，主攻"AI Coding 友好度"这一尚无成型竞争者的差异化角度，避开 "saas boilerplate" 等已被高权重老站垄断的头部词（详见 `content-strategy.md`）。
|
||||
|
||||
## 二、问题与机会
|
||||
|
||||
### 2.1 用户痛点
|
||||
@@ -68,16 +70,7 @@ Skelet 提供一个结构化的骨架项目数据库和评测体系。
|
||||
|
||||
### 5.2 AI 友好度评分
|
||||
|
||||
评分维度：
|
||||
|
||||
| 维度 | 说明 |
|
||||
| --- | --- |
|
||||
| 目录结构 | 是否清晰、模块边界是否明确 |
|
||||
| 文档完整度 | 是否有运行、部署、测试和架构说明 |
|
||||
| 测试可用性 | 是否有可运行测试和基础 CI |
|
||||
| 示例模块 | 是否有完整 demo feature 供 AI 模仿 |
|
||||
| 依赖克制度 | 是否依赖过重、配置是否复杂 |
|
||||
| 增量开发难度 | 是否容易让 AI 在既有模式中添加功能 |
|
||||
评分维度的**唯一权威定义**在 [`../docs/04-architecture.md`](../docs/04-architecture.md)：6 个 0-5 分项（目录结构、文档完整度、测试可用性、示例模块、依赖克制度、增量开发难度），总分由分项计算、不单独录入。本文不另行维护维度清单，避免漂移。
|
||||
|
||||
## 六、技术方案
|
||||
|
||||
@@ -113,7 +106,7 @@ SQLite 作为第一版上线数据库的前提：以公开读为主，后台少
|
||||
- 上手体验和避坑指南。
|
||||
- 项目维护状态观察。
|
||||
|
||||
可轻量加入：Newsletter 订阅、项目提交入口、简单赞助说明页。
|
||||
可轻量加入：外部托管的 Newsletter 订阅链接（如 Buttondown，纯外链、不自建后端）、项目提交入口、简单赞助说明页。
|
||||
|
||||
### 7.2 阶段二：轻量变现
|
||||
|
||||
@@ -160,15 +153,19 @@ SQLite 作为第一版上线数据库的前提：以公开读为主，后台少
|
||||
|
||||
Newsletter 不做泛资讯，只围绕：新发现的骨架、值得关注的模板、AI 友好度评测、项目启动建议。
|
||||
|
||||
## 九、里程碑
|
||||
## 九、里程碑与验证闸门
|
||||
|
||||
| 阶段 | 目标 | 交付物 |
|
||||
| --- | --- | --- |
|
||||
| M1 | MVP 可运行 | 首页、分类页、项目详情、后台录入、基础 SEO |
|
||||
| M2 | 内容初始库 | 至少 8 个场景、50 个骨架项目、10 篇评测/对比文章 |
|
||||
| M3 | SEO 验证 | 有稳定自然搜索访问和 Newsletter 订阅入口 |
|
||||
| M4 | 轻量变现 | Affiliate 和 Sponsored 规则上线 |
|
||||
| M5 | 付费产品验证 | 付费数据库、自有模板或顾问服务获得首批付费用户 |
|
||||
每个里程碑必须带**验证闸门**：闸门不通过就不追加投入，先调整方向。这是独立开发者最重要的止损纪律——最大的风险不是做得慢，而是在需求验证前投入几百小时内容劳动。
|
||||
|
||||
| 阶段 | 目标 | 交付物 | 验证闸门 |
|
||||
| --- | --- | --- | --- |
|
||||
| M1 | MVP 可运行 | 首页、分类页、项目详情、后台录入、基础 SEO、访问统计（T-305） | 标准验证通过；核心页面可被搜索引擎索引 |
|
||||
| M2 | 内容初始库 | **2 个场景**（SaaS、内容站/CMS）× 10 个骨架项目 + 6 篇评测/对比文章 | 全部详情页评分和适合/不适合字段完整；每篇文章有明确结论 |
|
||||
| M3 | SEO 验证 | Search Console 接入、外部托管 Newsletter 订阅链接 | 上线 8 周自然搜索展示量出现持续增长趋势；**止损线：12 周自然点击仍接近 0 时，先复盘关键词方向和内容角度，不扩场景、不加内容量** |
|
||||
| M4 | 轻量变现 | Affiliate 和 Sponsored 规则上线 | 外链点击有稳定基数（依赖 T-305 数据）；至少 1 个 Affiliate 渠道产生真实点击转化 |
|
||||
| M5 | 付费产品验证 | 付费数据库、自有模板或顾问服务其一 | 获得首批 ≥3 个付费用户；价格假设经真实报价验证后才扩产品线 |
|
||||
|
||||
**内容投入封顶原则**：在 M3 闸门通过前，内容库投入封顶在 20 个项目 + 12 篇文章以内。每个项目按收录流程认真做需要 2-4 小时，50 个项目就是 100-200 小时——这笔投入必须发生在需求验证之后，而不是之前。
|
||||
|
||||
## 十、成本结构
|
||||
|
||||
@@ -218,7 +215,8 @@ Newsletter 不做泛资讯，只围绕：新发现的骨架、值得关注的模
|
||||
| 商业化伤害信任 | 赞助项目影响排序 | Sponsored 明确标识，编辑推荐独立排序 |
|
||||
| 技术复杂度膨胀 | 过早做会员、支付、复杂搜索 | 第一版只做内容闭环，V2/V3 再扩展 |
|
||||
| SQLite 写入瓶颈 | 出现 database is locked | 限制第一版写入，达到触发条件后迁移 PostgreSQL |
|
||||
| SEO 起量慢 | 内容早期没有流量 | 先做高意图长尾关键词和对比内容 |
|
||||
| SEO 起量慢 | 内容早期没有流量 | 先做高意图长尾关键词和对比内容；按 M3 止损线及时复盘方向 |
|
||||
| 用户直接问 AI 选型 | 目标用户习惯直接问 Claude / ChatGPT / Cursor，不逛目录站 | 提供 LLM 训练数据里没有的东西：维护状态时效性、统一评分、不适合场景的负面信息；通过 llms.txt / 结构化数据 / JSON 导出让 AI 引用 Skelet 作为数据源（见 `competitor-analysis.md`） |
|
||||
|
||||
## 十三、第一版执行重点
|
||||
|
||||
|
||||
Reference in New Issue
Block a user