开发者文档站信息架构

这个技能解决什么问题

文档站的信息架构往往到项目后期才开始补救：导航层级混乱、新用户找不到上手路径、API 文档与教程互相割裂、搜索覆盖不全。这个技能把信息架构设计变成一次结构化梳理——先确认产品形态和读者对象，再产出分区方案与每个分区的内容清单。

核心能力与工作流程

• 项目上下文识别：若存在 .claude/project-context.md 或 .cursor/project-context.md 则先读取，确认产品类型、目标读者和内容来源。
• 五分区结构：Getting Started、Guides / Tutorials、Concepts、API Reference、Troubleshooting，每个分区都给出典型内容定义。
• 渐进式披露：入口从简单任务开始，深度内容按需链接展开；侧边栏采用可折叠的层级导航，长文档集配套全文搜索与面包屑。
• API Reference 内嵌：作为文档站的一个分区而不是独立页面，按资源组织端点，包含认证、请求/响应 schema、错误码、限流和 cURL、SDK 示例，建议基于 OpenAPI/Swagger 保持一致。
• 内容与可发现性：以「How to X」任务导向写作，代码示例可直接复制；文档默认可被索引，指南使用 TechArticle、HowTo 结构化数据。
• 输出物：分区与层级结构、导航设计、上手指南大纲、每个分区的内容清单、子域或路径建议。

适用边界

• 只产出规划和清单，不生成完整文档正文。
• 不自动安装依赖、修改系统权限或创建持久化任务；涉及发布、删除、部署等外部写入操作，需先说明目标与影响并取得确认。
• 这里的 API Reference 是文档站分区；如果需要独立的 API 介绍页，应改用 api-page-generator。