Warp 是从终端起家的 AI 开发环境。2026 年 5 月，它把产品文档站 docs.warp.dev 的源代码开源了，仓库地址 github.com/warpdotdev/docs。这个仓库除了文档内容本身，还配了一整套用 AI agent 维护文档的工作流。
文档站基于 Astro 6 + Starlight，内容用 MDX 写在 src/content/docs/ 下。Node.js 22 起步，npm install 后 npm run dev 启动本地预览，端口 4321。“Ask AI” 按钮和 “Was this helpful?” 反馈是可选功能，需要在 .env 里填公开值。
下面分四块说明仓库里 agent 相关的结构。
.agents/ 目录
.agents/ 分四个子目录：
skills/— 25 个 skill。每个 skill 是一个子目录，里面至少有一个SKILL.md描述用途和执行步骤，部分含有references/、scripts/。rules/— 通用规则，当前只有一个oz-style-guidelines.md。templates/— 不同类型文档页面的模板（quickstart、guide、procedural 等）。references/— 词汇表等参考资料。
25 个 skill 按用途分四类：
草稿生成（10 个）：draft_quickstart、draft_guide、draft_procedural、draft_conceptual、draft_reference、draft_faq、draft_troubleshooting、draft_feature_doc、draft_docs、missing_docs。从空白页起一篇新文档时使用。