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。从空白页起一篇新文档时使用。