用 Astro 构建站点

这些是本技能的默认选择，不是框架手册。Astro 版本按当前稳定版核对，具体技术栈服从用户要求与现有工程；跨框架的工程基线（TypeScript 严格模式、格式与检查、提交钩子、主题与偏好、测试组织）沿用 build-maintainable-app，这里只补 Astro 特有决策。

先定站点形态

内容站、工具站、混合站决定后面所有选择：内容站由集合驱动、页面负责呈现；工具站由交互驱动，需要客户端状态；混合站要明确哪些路由是静态阅读、哪些是交互入口。

开工前确认四件事：站点形态、渲染模式（默认 output: 'static'，出现鉴权、表单后端、实时数据才引入 adapter 并说明例外路由）、部署平台与域名、语言集合。这四项没定，后面的目录和依赖都会返工。

骨架从官方模板起，站点身份只写一处

pnpm create astro@latest   # 最小模板 + TypeScript

站点域名写进 astro.config.ts 的 site，页面里用 Astro.site 派生绝对地址；站点名称、描述、导航放 src/data/site.ts，配置文件从那里导入。域名在仓库里只出现一次——出现第二次的地方就是将来分享链接失效的地方。

README 不写具体版本号，版本由 package.json 与锁文件维护。目录分工、配置起点、依赖取舍与 CI 写法见 Astro 工程基线。